Справка MediaWiki API

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

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

action=parse

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

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

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

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

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

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

text

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

revid
Revision ID, for 
<nowiki>{{REVISIONID}}</nowiki>
and similar variables.
Тип: целое число
summary

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

page

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

pageid

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

Тип: целое число
redirects

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

Тип: логический (подробнее)
oldid

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

Тип: целое число
prop

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

text
Возвращает текст распарсенного вики-текста.
langlinks
Возвращает языковые ссылки из распарсенного вики-текста.
categories
Возвращает категории из проанализированного вики-текста.
categorieshtml
Возвращает HTML-версию категорий.
links
Возвращает внутренние ссылки из распарсенного вики-текста.
templates
Возвращает шаблоны из проанализированного вики-текста.
images
Возвращает изображения из распарсенного вики-текста.
externallinks
Возвращает внешние ссылки из распарсенного вики-текста.
sections
Возвращает разделы из проанализированного вики-текста.
revid
Добавляет идентификатор версии распарсенной страницы.
displaytitle
Добавляет название проанализированного вики-текста.
headhtml
Возвращает распарсенный 
&lt;head&gt;
страницы.
modules
Возвращает использованные на странице модули ResourceLoader. Для загрузки, используйте 
mw.loader.using()
. Одновременно с modules должно быть запрошено либо jsconfigvars, либо encodedjsconfigvars.
jsconfigvars
Возвращает переменные JavaScript с данными настроек для этой страницы. Для их применения используйте 
mw.condig.set()
.
encodedjsconfigvars
Возвращает переменные JavaScript с данными настроек для этой страницы в виде JSON-строки.
indicators
Возвращает HTML-код индикаторов, использованных на данной странице.
iwlinks
Возвращает интервики-ссылки из распарсенного вики-текста.
wikitext
Возвращает исходный распарсиваемый вики-текст.
properties
Возвращает различные свойства, объявленные в проанализированном вики-тексте.
limitreportdata
Возвращает структурированный отчёт о лимите. Не возвращает данных, если задан disablelimitreport.
limitreporthtml
Возвращает HTML-версию отчёта о лимите. Не возвращает данных, если задан disablelimitreport.
parsetree
Дерево парсинга XML содержимого версии (требуется модель содержимого 
wikitext
).
parsewarnings
Возвращает предупреждения, возникшие во время анализа.
headitems
Не поддерживается. Возвращает элементы, которые следует поместить в 
&lt;head&gt;
страницы.
Значения (разделённые с помощью | или альтернативного разделителя): text, langlinks, categories, categorieshtml, links, templates, images, externallinks, sections, revid, displaytitle, headhtml, modules, jsconfigvars, encodedjsconfigvars, indicators, iwlinks, wikitext, properties, limitreportdata, limitreporthtml, parsetree, parsewarnings, headitems
По умолчанию: text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties|parsewarnings
wrapoutputclass

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

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

Выполнить преобразование перед записью правки (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

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

Тип: логический (подробнее)
disabletidy

Не проводить очистку HTML (например, с помощью tidy) результатов парсинга.

Тип: логический (подробнее)
generatexml
Не поддерживается.
Сгенерировать дерево парсинга XML (требуется модель содержимого 
wikitext
, замещено prop=parsetree).
Тип: логический (подробнее)
preview

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

Тип: логический (подробнее)
sectionpreview

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

Тип: логический (подробнее)
disabletoc

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

Тип: логический (подробнее)
useskin

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

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

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

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

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

Одно из следующих значений: wikitext, javascript, json, css, text
Примеры:
Парсинг страницы.
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://k.psu.ru/wiki/Служебная:ApiHelp»