Manual:Magic words/ru



Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function. Both variables and parser functions use this technique. All text mapped to that ID will be replaced with the return value of the function. The mapping between the text strings and the ID is stored in the variable $magicWords in a file that can be loaded using $wgExtensionMessagesFiles[].

Стандартные волшебные слова реализованы в CoreParserFunctions.php.

Как работают волшебные слова
Всякий раз, когда MediaWiki находит текст между двойными скобками, необходимо решить, является ли XXX переменной, функцией парсера или шаблоном. Чтобы сделать это, задается несколько вопросов:


 * 1) Есть ли связанное ID волшебного слова? В качестве первого шага разбора разметки в виде, MediaWiki пытается перевести XXX в ID волшебного слова. Таблица переводов определяется в $magicWords.
 * 2) *Если нет связанного с XXX ID волшебного слова, предполагается что XXX это шаблон.
 * 3) Переменная ли это? Если найдено ID волшебного слова, MediaWiki далее проверяет есть ли у него какие-либо параметры.
 * 4) *Если параметры не найдены, MediaWiki далее проверяет было ли ID волшебного слова определено как ID переменной. Чтобы проверить это, с помощью вызова  извлекается список волшебных слов. Этот метод получает список ID переменных из списка, который определен в исходном коде (смотрите Справка:Переменные), а также из списка с пользовательскими ID переменных, из всех функций, которые подключены к хуку (hook) MagicWordwgVariableIDs.
 * 5) **Если ID волшебного слова было классифицировано как переменная, хуки MediaWiki будут вызывать функции, связанные с именем события 'ParserGetVariableValueSwitch', пока не будет найдена та, которая распознает волшебное слово и сможет вернуть его значение.
 * 6) Функция парсера ли это? Если нет каких-либо параметров или если ID волшебного слова не найдено в списке переменных ID волшебных слов, тогда MediaWiki подразумевает что это волшебное слово функция парсера или шаблон. Если ID волшебного слова найдено в списке функций парсера, который объявляется с помощью вызова, то рассматривается как функция парсера и отображается с помощью функции под именем  . Иначе предполагается что это шаблон.
 * 1) Функция парсера ли это? Если нет каких-либо параметров или если ID волшебного слова не найдено в списке переменных ID волшебных слов, тогда MediaWiki подразумевает что это волшебное слово функция парсера или шаблон. Если ID волшебного слова найдено в списке функций парсера, который объявляется с помощью вызова, то рассматривается как функция парсера и отображается с помощью функции под именем  . Иначе предполагается что это шаблон.
 * 1) Функция парсера ли это? Если нет каких-либо параметров или если ID волшебного слова не найдено в списке переменных ID волшебных слов, тогда MediaWiki подразумевает что это волшебное слово функция парсера или шаблон. Если ID волшебного слова найдено в списке функций парсера, который объявляется с помощью вызова, то рассматривается как функция парсера и отображается с помощью функции под именем  . Иначе предполагается что это шаблон.

Определение волшебных слов
Для волшебных слов, чтобы они смогли делать свое волшебство, мы должны определить две вещи:
 * Связь (отображение) между wiki-текстом и ID волшебного слова
 * Связь (отображение) между ID волшебного слова и некоторой php-функцией, которая интерпретирует волшебное слово.

Связывание wiki-текста с ID волшебного слова
Переменная $magicWords используется для ассоциации всех ID магических слов с языково-зависимым массивом, который описывает все текстовые строки, которые связаны с ID волшебного слова. Important: This only sets up the back end i18n mapping, you still have to write other code to make MediaWiki use the magic word for anything

Первый элемент этого массива это целочисленный флаг, указывающий, является ли волшебное чувствительным к регистру. Остальные элементы это список текста, который должен быть связан с ID волшебного слова. Если флаг чувствительности к регистру равен 0, то любые варианты регистра в имени будут совпадать. Если флаг чувствительности к регистру равен 1, то только точные совпадения по регистру будут ассоциированы с ID волшебного слова. Таким образом формат выглядит так

Такая ассоциация создается переменной $magicWords, в файле, зарегистрированном с помощью $wgExtensionMessagesFiles[].

In the example below, a Spanish MediaWiki installation will associate the magic word ID 'MAG_CUSTOM' with "personalizado", "custom", "PERSONALIZADO", "CUSTOM" and all other case variants. In an English MediaWiki only "custom" in various case combinations will be mapped to 'MAG_CUSTOM':

Файл :

Файл инициализации расширения :

Note that "ExampleMagic" is a different to the key you would use for a plain internationalization file (normally just the title of the extension, i.e. "Example"). "Magic" has been appended deliberately so one does not overwrite the other.

Ассоциация ID волшебного слова с PHP-функцией
Механизм ассоциации ID волшебного слова с функцией рендеринга зависит от того, будет ли волшебное слово использоваться как функция парсера или как переменная. Для получения более подробной информации смотрите:


 * Руководство:Функции парсера
 * Руководство:Переменные

Регистрация волшебных слов
В MediaWiki 1.8 и выше отсутствует явное требование регистрации ID волшебных слов. Достаточно зарегистрировать функцию парсера или переменные, которые их используют. Для версий до 1.8, смотрите раздел ниже.

Локализация

 * ''Для справки смотрите Справка:Волшебные слова#Локализация.

You can read more on definition and usage of magic words for localisation at Localisation#PLURAL and GENDER support in JavaScript, Localisation#Localizing namespaces and special page aliases, Localisation#Switches in messages…; Localisation#Be aware of PLURAL use on all numbers, Localisation#Users have grammatical genders, Avoid  in messages.

Волшебные слова в MediaWiki версиях до 1.8
Версии MediaWiki до 1.8 отличаются в следующих случаях:

 Manual:Hooks/LanguageGetMagic did not pass a language parameter. To simulate this parameter, extensions backported to 1.7 or earlier can extract the language of $wgContLang on their own and proceed as normal and/or offer a language independent process for selecting the ID-text mapping. Расширения, которые использовали магические слова, должны были явно регистрировать свои ID волшебных слов используя хук MagicWordMagicWords. Этот метод просто просил исполнителя предоставлять ID волшебного слова.

 

Переключатели поведения (волшебные слова с двойным подчеркиванием)
Переключатели поведения это особый тип волшебных слов. Их можно узнать по двойному подчеркиванию (за место двойных скобок). Например,.

Эти волшебные слова обычно не выводят какое-либо содержимое. Вместо этого они изменяют поведение страницы и/или устанавливают какое-либо свойство страницы. Такие волшебные слова перечислены в  а также в Help:Magic words#Behavior switches. Эффект от каждого такого переключателя поведения определен в. Если эффект не определен, волшебное слово просто установит свойство страницы в таблице page_props.

См. также

 * Справка:Волшебные слова - список переменных таких как и