Справка 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
Добавляет название проанализированного вики-текста.
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
Возвращает предупреждения, возникшие во время анализа.
headitems
Устарело. Возвращает элементы, которые следует поместить в <head> страницы.
Значения (разделённые с помощью | или альтернативного разделителя): categories, categorieshtml, displaytitle, encodedjsconfigvars, externallinks, headhtml, images, indicators, iwlinks, jsconfigvars, langlinks, limitreportdata, limitreporthtml, links, modules, parsetree, parsewarnings, properties, revid, sections, 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, text/css, text/javascript, text/plain, text/x-wiki
contentmodel

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

Одно из следующих значений: GeoJSON, GeoJson, css, javascript, json, smw/schema, text, wikitext