Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=parse

(main | parse)
  • Этот модуль требует прав на чтение.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0-or-later

Парсит содержимое и возвращает результат парсинга.

См. различные prop-модули action=query для получения информации о текущей версии страницы.

Есть несколько способов указать текст для парсинга:

  1. Указать страницу или версию, используя page, pageid или oldid.
  2. Явно указать содержимое, используя text, title и contentmodel.
  3. Указать описание правки. Параметру prop должно быть присвоено пустое значение.
Параметры:
title

Название страницы, которой принадлежит текст. Если опущено, должен быть указан параметр contentmodel, и в качестве заголовка будет использовано API.

text

Распарсиваемый текст. Используйте title или contentmodel для управления моделью содержимого.

revid

Номер версии, для {{REVISIONID}} и аналогичных переменных.

Type: integer
summary

Анализируемое описание правки.

page

Распарсить содержимое этой страницы. Не может быть использовано совместно с text и title.

pageid

Анализировать содержимое этой страницы. Переопределяет page.

Type: integer
redirects

Если значением page или pageid указано перенаправление, разрешить его.

Type: boolean (details)
oldid

Распарсить содержимое этой версии. Переопределяет page и pageid.

Type: integer
prop

Какую информацию включить:

text
Возвращает текст распарсенного вики-текста.
langlinks
Возвращает языковые ссылки из распарсенного вики-текста.
categories
Возвращает категории из проанализированного вики-текста.
categorieshtml
Возвращает HTML-версию категорий.
links
Возвращает внутренние ссылки из распарсенного вики-текста.
templates
Возвращает шаблоны из проанализированного вики-текста.
images
Возвращает изображения из распарсенного вики-текста.
externallinks
Возвращает внешние ссылки из распарсенного вики-текста.
sections
Возвращает разделы из проанализированного вики-текста.
revid
Добавляет идентификатор версии распарсенной страницы.
displaytitle
Добавляет название проанализированного вики-текста.
subtitle
Adds the page subtitle for the parsed page.
headhtml
Возвращает распарсенный тип документа, начальный <html>, элемент <head> и открывающий <body>.
modules
Возвращает использованные на странице модули ResourceLoader. Для загрузки, используйте mw.loader.using(). Одновременно с modules должно быть запрошено либо jsconfigvars, либо encodedjsconfigvars.
jsconfigvars
Возвращает переменные JavaScript с данными настроек для этой страницы. Для их применения используйте mw.config.set().
encodedjsconfigvars
Возвращает переменные JavaScript с данными настроек для этой страницы в виде JSON-строки.
indicators
Возвращает HTML-код индикаторов, использованных на данной странице.
iwlinks
Возвращает интервики-ссылки из распарсенного вики-текста.
wikitext
Возвращает исходный распарсиваемый вики-текст.
properties
Возвращает различные свойства, объявленные в проанализированном вики-тексте.
limitreportdata
Возвращает структурированный отчёт о лимите. Не возвращает данных, если задан disablelimitreport.
limitreporthtml
Возвращает HTML-версию отчёта о лимите. Не возвращает данных, если задан disablelimitreport.
parsetree
Дерево парсинга XML содержимого версии (требуется модель содержимого wikitext).
parsewarnings
Возвращает предупреждения, возникшие во время анализа (как викитекст).
parsewarningshtml
Gives the warnings that occurred while parsing content (as HTML).
headitems
Устарело. Возвращает элементы, которые следует поместить в <head> страницы.
Значения (разделённые с помощью | или альтернативного разделителя): categories, categorieshtml, displaytitle, encodedjsconfigvars, externallinks, headhtml, images, indicators, iwlinks, jsconfigvars, langlinks, limitreportdata, limitreporthtml, links, modules, parsetree, parsewarnings, parsewarningshtml, properties, revid, sections, subtitle, templates, text, wikitext, headitems
По умолчанию: text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties|parsewarnings
wrapoutputclass

CSS-класс, используемый для оборачивания вывода парсера.

По умолчанию: mw-parser-output
pst

Выполнить преобразование перед записью правки (PST) до того, как начать анализировать текст. Доступно только когда используется с текстом.

Type: boolean (details)
onlypst

Выполнить преобразование перед записью правки (PST) входных данных, но не парсить их. Возвращает тот же вики-текст после применения PST. Доступно только при применении с text.

Type: boolean (details)
effectivelanglinks
Устарело.

Включает языковые ссылки, обеспечиваемые расширениями (для использования с prop=langlinks).

Type: boolean (details)
section

Распарсить содержимое только секции с заданным номером.

Если задан new, распарсить text и sectiontitle так, как будто добавлена новая секция на страницу.

new доступен только при заданном text.

sectiontitle

Название новой секции, когда section имеет значение new.

В отличие от редактирования страницы, оно не примет значение параметра summary, если опустить его или оставить пустым.

disablepp
Устарело.

Вместо этого используйте disablelimitreport.

Type: boolean (details)
disablelimitreport

Опустить отчёт о лимите («NewPP limit report») из результата парсинга.

Type: boolean (details)
disableeditsection

Опустить ссылки на редактирование разделов из результата парсинга.

Type: boolean (details)
disablestylededuplication

Не дедуплицируйте встроенные таблицы стилей в выходе парсера.

Type: boolean (details)
generatexml
Устарело.

Сгенерировать дерево парсинга XML (требуется модель содержимого wikitext, замещено prop=parsetree).

Type: boolean (details)
preview

Проанализировать в режиме препросмотра.

Type: boolean (details)
sectionpreview

Распарсить в режиме предпросмотра раздела (также активирует режим предпросмотра).

Type: boolean (details)
disabletoc

Не включать в вывод содержание.

Type: boolean (details)
useskin

Применить выбранную тему оформления к результату работы парсера. Может затронуть следующие свойства: langlinks, headitems, modules, jsconfigvars, indicators.

Одно из следующих значений: vector
contentformat

Формат сериализации содержимого, использующийся во входном тексте. Доступен только при использовании с text.

Одно из следующих значений: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
contentmodel

Модель содержимого входного текста. Если пропущена, должен быть задан title, и значение по умолчанию будет взято в зависимости от указанного названия. Доступно только при использовании с text.

Одно из следующих значений: GadgetDefinition, css, javascript, json, text, unknown, 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= [открыть в песочнице]
Источник — https://montibus.org/wiki/Служебная:ApiHelp