미디어위키 API 도움말

이 페이지는 자동으로 생성된 미디어위키 Action API 설명문서입니다.

action=parse

(main | parse)

이 모듈은 read 권한을 요구합니다.
출처: MediaWiki
라이선스: GPL-2.0-or-later

내용을 변환하고 출력을 반환합니다.

문서의 현재 버전에 대한 정보를 얻으려면 action=query의 다양한 prop-모듈을 참조하세요.

구문 분석할 텍스트를 지정하는 방법에는 여러 가지가 있습니다:

page, pageid 또는 oldid를 사용하여 문서나 판을 지정합니다.
text, title, revid, contentmodel을 사용하여 콘텐츠를 명시적으로 지정합니다.
구문 분석할 요약만 지정합니다. prop에는 빈 값을 지정해야 합니다.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Parsing_wikitext

특정 매개변수:

다른 일반 매개변수를 사용할 수 있습니다.

title

텍스트가 속한 문서의 제목입니다. 생략하면 contentmodel을 지정해야 하며 API가 제목으로 사용됩니다.

text

구문 분석할 텍스트입니다. 콘텐츠 모델을 제어하려면 title 또는 contentmodel을 사용하세요.

revid

{{REVISIONID}}와 비슷한 매개변수들을 위한 판 ID입니다.

유형: 정수

summary

변환할 요약입니다.

page

이 문서의 내용을 분석합니다. text 및 title과 함께 사용할 수 없습니다.

pageid

이 문서의 내용을 분석합니다. page를 덮어씁니다.

유형: 정수

redirects

page나 pageid가 넘겨주기로 설정된 경우, 그것을 해결합니다.

유형: 불리언 (자세한 정보)

oldid

이 판의 내용을 분석합니다. page 및 pageid를 덮어씁니다.

유형: 정수

prop

가져올 정보:

text: 위키텍스트로 변환된 텍스트를 제공합니다.
langlinks: 언어 링크를 위키텍스트로 변환하여 제공합니다.
categories: 분류를 변환된 위키텍스트로 제공합니다.
categorieshtml: 분류의 HTML 버전을 제공합니다.
links: 내부 링크를 위키텍스트로 변환하여 제공합니다.
templates: 틀을 변환된 위키텍스트로 제공합니다.
images: 그림을 위키텍스트로 변환하여 제공합니다.
externallinks: 외부 링크를 위키텍스트로 변환하여 제공합니다.
sections: 구식입니다. prop=sections은(는) 구식입니다. 대신 prop=tocdata을(를) 사용해 주세요.
문단을 변환된 위키텍스트로 제공합니다.
tocdata: 분석된 위키텍스트의 내용 정보를 표로 제공합니다. 스키마는 mw:API:Parsing_wikitext/TOCData를 참조하세요.
revid: 변환할 페이지의 판 ID를 추가합니다.
displaytitle: 제목을 변환된 위키텍스트로 추가합니다.
subtitle: 구문 분석된 문서의 부제를 추가합니다.
headhtml: 문서의 파싱된 doctype, 여는 <html>, <head>, <body>를 제공합니다.
modules: 문서에 사용되는 ResourceLoader 모듈을 제공합니다. 불러오려면, mw.loader.using()을 사용하세요. jsconfigvars 또는 encodedjsconfigvars는 modules와 함께 요청해야 합니다.
jsconfigvars: 문서에 특화된 자바스크립트 구성 매개변수를 제공합니다. 적용하려면 mw.config.set()을 사용하세요.
encodedjsconfigvars: 해당 페이지에 특화된 자바스크립트 구성 매개변수를 JSON 문자열로 제공합니다.
indicators: 문서에 사용되는 문서 상태 표시기의 HTML을 제공합니다.
iwlinks: 인터위키 링크를 위키텍스트로 변환하여 제공합니다.
wikitext: 변환한 원문 위키텍스트를 제공합니다.
properties: 정의된 다양한 속성을 변환된 위키텍스트로 제공합니다.
limitreportdata: 제한 보고서를 구조화된 방식으로 제공합니다. disablelimitreport가 설정된 경우 데이터가 제공되지 않습니다.
limitreporthtml: HTML 버전의 제한 보고서를 제공합니다. disablelimitreport가 설정된 경우 데이터가 제공되지 않습니다.
parsetree: 판 콘텐츠의 XML 구문 분석 트리 (콘텐츠 모델 wikitext 필요)
parsewarnings: 내용을 (위키텍스트로) 분석하는 동안 발생한 경고를 제공합니다.
parsewarningshtml: 내용을 (HTML로) 분석하는 동안 발생한 경고를 제공합니다.
headitems: 구식입니다. prop=headitems는 미디어위키 1.28 이후로 구식입니다. 새 HTML 문서를 만들 때는 prop=headhtml을 사용하고, 클라이언트 측에서 문서를 업데이트할 때는 prop=modules|jsconfigvars를 사용하세요.
문서의 <head> 안에 넣을 항목을 제공합니다.

값 (|로 구분): categories, categorieshtml, displaytitle, encodedjsconfigvars, externallinks, headhtml, images, indicators, iwlinks, jsconfigvars, langlinks, limitreportdata, limitreporthtml, links, modules, parsetree, parsewarnings, parsewarningshtml, properties, revid, subtitle, templates, text, tocdata, wikitext, headitems, sections 또는 다른 문자열: categories, categorieshtml, displaytitle, encodedjsconfigvars, externallinks, headhtml, images, indicators, iwlinks, jsconfigvars, langlinks, limitreportdata, limitreporthtml, links, modules, parsetree, parsewarnings, parsewarningshtml, properties, revid, subtitle, templates, text, tocdata, wikitext, headitems, sections

wrapoutputclass

파서 출력을 감싸기 위해 사용되는 CSS 클래스입니다.

기본값: mw-parser-output

usearticle

ArticleParserOptions 훅을 사용하여 사용되는 옵션이 기사 페이지 보기에서 사용되는 옵션과 일치하는지 확인합니다

유형: 불리언 (자세한 정보)

parsoid

구식입니다.

미디어위키 DOM 사양을 준수하는 HTML을 파소이드를 사용하여 생성합니다. parser=parsoid로 대체되었습니다.

유형: 불리언 (자세한 정보)

parser

사용할 위키텍스트 파서:

parsoid: 파소이드를 사용하여 미디어위킼 DOM 사양에 부합하는 HTML을 생성합니다.
default: 이 위키의 기본 파서를 사용하여 HTML을 생성합니다.
legacy: 기존 파서를 사용하여 HTML을 생성합니다.

다음 값 중 하나: default, legacy, parsoid 또는 다른 문자열: default, legacy, parsoid

기본값: default

pst

구문 분석에 앞서 입력에 대한 저장 직전의 변환을 수행합니다. 텍스트로 사용할 때에만 유효합니다.

유형: 불리언 (자세한 정보)

onlypst

입력에 대한 저장 직전의 변환(PST)을 수행하되, 구문 분석은 하지 않습니다. PST가 적용된 후의 동일한 위키텍스트를 반환합니다. text와 함께 사용할 때만 유효합니다.

유형: 불리언 (자세한 정보)

effectivelanglinks

구식입니다.

확장 기능에서 제공하는 언어 링크가 포함됩니다( prop=langlinks와 함께 사용).

유형: 불리언 (자세한 정보)

section

이 식별자를 가진 문단의 내용만 구문 분석합니다.

new의 경우, 문서에 새 문단을 추가하는 것처럼 text와 sectiontitle을 구문 분석합니다.

new는 text를 지정할 때만 허용됩니다.

sectiontitle

section이 new일 때의 새 문단 제목입니다.

문서 편집과 달리, 이 항목은 생략되거나 비어 있어도 summary로 대체되지 않습니다.

disablepp

구식입니다.

disablelimitreport를 대신 사용합니다.

유형: 불리언 (자세한 정보)

disablelimitreport

파서 출력에서 제한 보고서("NewPP limit report")를 제외합니다.

유형: 불리언 (자세한 정보)

disableeditsection

파서 출력에서 문단 편집 링크를 제외합니다.

유형: 불리언 (자세한 정보)

disablestylededuplication

파서 출력에서 인라인 스타일시트 중복을 제거하지 않습니다.

유형: 불리언 (자세한 정보)

showstrategykeys

jsconfigvars에 내부 병합 전략 정보를 포함할지 여부입니다.

유형: 불리언 (자세한 정보)

generatexml

구식입니다.

XML 구문 분석 트리를 생성합니다 (콘텐츠 모델 wikitext 필요, prop=parsetree로 대체됨).

유형: 불리언 (자세한 정보)

preview

미리 보기 모드에서 파싱합니다.

유형: 불리언 (자세한 정보)

sectionpreview

문단 미리 보기 모드에서 파싱합니다. (미리 보기 모드도 활성화함)

유형: 불리언 (자세한 정보)

disabletoc

출력에서 목차를 제외합니다.

유형: 불리언 (자세한 정보)

useskin

선택한 스킨을 파서 출력에 적용합니다. 다음의 속성에 영향을 줄 수 있습니다: text, langlinks, headitems, modules, jsconfigvars, indicators.

다음 값 중 하나: apioutput, authentication-popup, fallback, json, zprime 또는 다른 문자열: apioutput, authentication-popup, fallback, json, zprime

contentformat

입력 텍스트에 사용할 내용 직렬화 포맷입니다. text와 함께 사용할 때에만 유효합니다.

다음 값 중 하나: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown 또는 다른 문자열: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown

contentmodel

입력 텍스트의 콘텐츠 모델입니다. 생략할 경우 title을 지정해야 하며, 기본값은 지정된 제목의 모델입니다. text와 함께 사용할 때만 유효합니다.

다음 값 중 하나: Scribunto, css, javascript, json, sanitized-css, text, unknown, vue, wikitext 또는 다른 문자열: Scribunto, css, javascript, json, sanitized-css, text, unknown, vue, wikitext

예시:

문서의 구문을 분석합니다.: api.php?action=parse&page=Project:Sandbox [연습장에서 열기]
위키텍스트의 구문을 분석합니다.: api.php?action=parse&text={{Project:Sandbox}}&contentmodel=wikitext [연습장에서 열기]
문서 제목을 지정하여 위키텍스트의 구문을 분석합니다.: api.php?action=parse&text={{PAGENAME}}&title=Test [연습장에서 열기]
요약을 변환합니다.: api.php?action=parse&summary=Some+[[link]]&prop= [연습장에서 열기]