Wikimore

MediaWiki предоставляет стандартную текстовую разметку, которую можно легко настроить. Возможны как индивидуальные, так и множественные настройки: Расширения могут настраивать вики-разметку следующими способами:

Добавление стандартных типов токенов: стандартный подход к пользовательской разметке MediaWiki — добавить новую разметку, которая выглядит как встроенные в MediaWiki теги XML (<tag>), шаблоны ({{...}}) или разметка ссылок ([[...]]);
добавление настраевыемых типов токенов: некоторые расширения определяют новые типы токенов;

фундаментальные изменения в парсере: несколько расширений пытаются кардинально изменить стратегию синтаксического анализа, чтобы можно было использовать (нужно использовать?) разметку из других видов вики и управления контентом вместо стандартной разметки вики.

Добавление к стандартным типам токенов

Самый простой способ расширить вики-разметку — это добавить стандартный тип токена, используя одну из этих функций.

Переменные

Переменная вызывает функцию PHP, которая выводит строку Викитекст , заменяющую переменную на странице. Переменные обычно используются для вставки системной информации в вики-разметку, например, текущего времени или текущей страницы.

1Пример синтаксиса:

{{VARIABLENAME}}

Чтобы определить переменную, см. Manual:Variables . Список расширений, определяющих пользовательские переменные, см. в разделе Category:Variable extensions .

Функции парсера

Как и переменные, функция парсера вызывает функцию PHP и выводит строку викитекста, которая заменяет функцию парсера на странице. В отличие от переменных, функция парсера может передавать параметры функции PHP. Функции парсера используются для обработки генерации вики-текста, которая включает в себя логику, которая слишком сложна или сбивает с толку, чтобы писать, используя обычные методы написания шаблонов.

Пример синтаксиса:

{{#functionname: param1 | param2}}

Чтобы определить функцию синтаксического анализатора, см. Руководство:Функции парсера . Список расширений, определяющих пользовательские функции синтаксического анализатора, см. в разделе Категории:Расширения функций парсера .

Теги парсера

В отличие от переменных и функций парсера, которые выводят викитекст, теги парсера выводят HTML. Тег парсера — это тег XML, который вызывает функцию PHP, анализирует содержимое тега и выводит HTML, который заменяет тег и его содержимое на странице. Теги парсера также могут передавать аргументы функции PHP. For example, ‎<syntaxhighlight> is a parser tag defined by Расширение:SyntaxHighlight .

Syntax example:

<tagname param1name="param1value" param2name="param2value"> some text </tagname>

To define a parser tag, see Руководство:Теги расширений . For a list of extensions that define custom parser tags, see Категория:Расширения для тэгов .

Behavior switches

A behavior switch calls a PHP function, but, unlike other methods of extending wiki markup, behavior switches usually do not output any content. Instead, they change the behavior of the page or set a page property. For example, adding __NOTOC__ to a page hides the table of contents.

Syntax example:

__SWITCHNAME__

To define a behavior switch, see Руководство:Волшебные слова . For a list of extensions that define custom behavior switches, see Справка:Волшебные слова .

Link markup

Link markup customizations change the way MediaWiki interprets internal links.

Syntax example:

[[ ... ]]

For a list of extensions that define custom link markup, see Category:Link markup extensions/ru .

Adding new token types

To add new token types or to change the entire markup strategy, implementers need to add functions to one or more of the various parser and page output hooks: