Помогнете на вълшебни думи - MediaWiki

Съдържание

  • 1 Ключове за поведение
  • 2 Променлива
    • 2.1 Дата и час
    • 2.2 Технически метаданни
    • 2.3 Статистика
    • 2.4 Имена на страници
      • 2.4.1 URL кодирани имена на страници
    • 2.5 Пространства от имена
    • 2.6 Други
  • 3 Функции на парсер
    • 3.1 Технически метаданни на друга страница
    • 3.2 URL данни
    • 3.3 Пространства от имена
    • 3.4 Форматиране
    • 3.5 Локализация
    • 3.6 Модификатори на преводача
    • 3.7 Разни

Вълшебни думи са низове от текст, които MediaWiki свързва с променлива стойност или функция, като време, подробности за сайта или имена на страници. Тази страница обяснява само стандартните вълшебни думи; за техническо ръководство вижте Ръководство: Магически думи .

вълшебни

Има три основни типа магически думи:

  • Ключове за поведение: те обикновено се пишат под формата на главни букви, заменени с двойно подчертаване, например.__FOO__ .
  • променливи: това са думи с главни букви, заобиколени от двойни скоби, например.> . Като такива те много приличат на някои формати.
  • Функции на парсер: те получават параметри и са във форма >, да бъде във форма >, например. >. Вижте също Помощ: Разширение: Парсер Функции и Разширение: Scribunto .

Променливите и функциите за парсер могат да използват subst:, както и формати. Зависимите от страницата магически думи ще повлияят или ще върнат данни за страницата текущ (по подразбиране), дори ако думата е добавена чрез преписан формат или включено системно съобщение.

Превключвател за поведение контролира външния вид или поведението на страницата (ако се поддържа от използвания скин) и често може да се използва за указване на пропуска или включването на конкретно съдържание. Някои от тях не се поддържат, например, от скина на Minerva

Променливите връщат информация за текущата страница, уики или дата. Синтаксисът им е подобен на форматите. Софтуерът следи променливите, отбелязани като „ [Скъпо] ”, А броят на такива променливи, които могат да бъдат включени в дадена страница, е ограничен.

Ако името на формат противоречи на променлива, променливата ще бъде използвана (така че за да транскрибирате шаблона: PAGENAME формат, ще трябва да напишете>). В някои случаи добавянето на параметри ще принуди анализатора да извика формат; например> изключване на шаблон: CURRENTDAYNAME, не променлива.

Дата и час

Следните променливи връщат текущата дата и час в UTC.

Поради MediaWiki и кеширането на браузъра, тези променливи се показват, когато страницата е кеширана, а не текущата дата.

Използването на тези променливи води до кеширане на страниците за по-ограничен брой секунди. Това е конфигурирано в MagicWordFactory.

Вълшебните думи за дата и час са форматирани на езика на съдържанието на wiki. От 1.19 те зависят от езика на съдържанието на wiki.

Следните променливи са същите като преди, но използват конфигурацията на сървъра на сайта или $ wgLocaltimezone.

За да форматирате времето по-подробно или да създадете текущата година и седмица по-съвместими с ISO-8601, може да искате да инсталирате Extension: ParserFunctions, за да използвате функцията за партер #time..

Технически метаданни

Променлива Какво създава описание Версии уебсайт
> MediaWiki Име на сайта на Wiki ($ wgSitename)
> //www.mediawiki.org URL адрес на домейн ($ wgServer).
> www.mediawiki.org Имена на домейни и поддомейни (вече не зависят от $ wgServerName от версия 1.17).
>

Не е преведена единица. Език:> .

Не е преведена единица. Език: en.

Той може да получи втори аргумент noerror или noreplace за потискане на съобщенията за грешки при използване на DISPLAYTITLE на една страница многократно или да накарате този DISPLAYTITLE да не прави нищо, ако преди това на страницата е посочен друг DISPLAYTITLE.

(за noerror и noreplace)

(за noerror и noreplace)

Статистика

Числата, върнати от тези променливи, обикновено съдържат разделители (запетаи, точки или интервали, в зависимост от местния език), но могат да върнат необработени числа с флага ": R" (например,> → 1.010.874 и> → 1010874).

Броят на магическите думи е форматиран на езика на съдържанието на wiki. От 1.19, това зависи от езика на съдържанието на страницата.

Съответно, броят на

  • всички страници
  • обикновени страници (с изключение на подкатегории и файлове)
  • подкатегории или
  • файлове

Имена на страници

Заглавие на страницата в непосредствено по-високо ниво на подстраница без пространство от имена.

Ще върне лентата на страницата Помощ: Заглавие/Foo/Бар .

Ако не съществува подстраница, се връща стойността на>.

Нито едно от тях не е засегнато от промени в заглавието на дисплея с помощта на>; върнатите стойности са оригиналното заглавие на страницата.

Магическите думи> и> работят само в пространства от имена, които имат активирани подстраници. Вижте $ wgNamespacesWithSubpages за информация относно активирането на подстраници.

От 1.15+ всички те могат да вземат параметър, позволяващ спецификация на страницата, на която да се работи, вместо само на текущата страница:

  • > → Главна страница
Внимание:Ако заглавието на страницата съдържа части, които са "." Или ".", магическата дума не връща нищо. > → '. Нищо не се връща.
Внимание:Заглавията на страници, съдържащи определени знаци, като апострофи или звездички *, могат да доведат до неочаквани резултати, когато се обработват с тези вълшебни думи, напр. >>>. Вижте грешки T16779, T18474, T37628, T37746. Един лесен начин да се поправи това е опаковането на името на страницата в> от разширението ParserFunctions.

URL кодирани имена на страници

По-долу са еквиваленти, кодирани за използване в URL адресите на MediaWiki (т.е. интервали, заменени с долни черти и някои символи HTML, избягали с цифрово кодиране на символи):

Имайте предвид, че>,> и> имат различни реализации. Вижте Ръчно: Кодиране на PAGENAMEE за подробности.

пространства от имена

По-долу са еквиваленти, кодирани за използване в URL адресите на MediaWiki (интервали, заменени с долни черти и някои символи кодирани в проценти):

От 1.15+ те могат да вземат параметър с име на цяла страница и ще върнат исканото пространство от имена, свързано с тази страница, вместо с текущата страница:

  • > → 0
  • > → (Страниците в основното пространство ще се върнат празни)
  • > → шаблон
  • > → шаблон
  • > → шаблон
  • > → Шаблонна беседа

Параметърът не трябва да е име на пространство от имена:

Други

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

Функциите за парсер са много подобни на променливите, но вземат един или повече параметри (технически всяка магическа дума, която приема параметър, е функция за парсер), а името понякога има префикс с хеш, за да ги различи от шаблоните.

Тази страница описва само функции на парсер, които са неразделна част от софтуера MediaWiki. Други функции за парсер могат да бъдат добавени от разширения на MediaWiki като Extension: ParserFunctions. За тези вижте Помощ: Разширение: ParserFunctions .

Технически метаданни на друга страница

действие | име на страница>>

  • Когато даденият параметър е равен на текущото заглавие на анализатора, функцията на анализатора ще даде предишните версии при визуализация и при заместване, което включва празни низове, когато се използва при създаване на страница, но използва стойностите от текущата версия за изглед на страница, включително преглед на стари ревизии. В този случай това е скъпа функция за парсер.

Данни за URL

Функция за парсер Вход → Изход Описание Версии
име на страница >>
име на страница
| QUERY_STRING >>		 >
→/wiki/MediaWiki
>
→ /w/index.php?title=MediaWiki&printable=yes		 Относителният път към заглавието.
име на страница >>
име на страница
| QUERY_STRING >>
interwiki: име на отдалечена страница
| QUERY_STRING >>		 >
→ //www.mediawiki.org/wiki/Category:Top_level

Параметърът nowiki обикновено премахва връзката около файловия път (което не може да се види в този пример).

Имайте предвид, че по подразбиране се промени от | WIKI на | QUERY в 1.17; това може да счупи шаблони, които разчитат на тази функция.

пространства от имена

> връща текущото локализирано име за пространството от имена с този индекс, канонично име или локален псевдоним. По този начин>,> и> (старо име за пространството от имена на файлове) всички връщат "Файл". На wiki, където езикът на съдържанието е френски,> също е валиден, но> (локализацията на „Файл“ на немски) не е.

> е еквивалентът, кодиран за URL адресите на MediaWiki. Прави същото, но заменя интервалите с долни черти, което го прави използваем във външни връзки.

Пространства от имена на съдържание Говорете за пространства от имена Изход за употреба Изход за употреба
> /> Посредничество > /> Специален
(не говоря страница)
> /> > /> Говоря
> /> Клиент > /> Потребителски разговор
> /> Проект
Варира между уикитата 		> /> Проектна беседа
> /> или> Филе > /> или> Файлова беседа
> /> MediaWiki > /> Беседа на MediaWiki
> /> шаблон > /> Шаблонна беседа
> /> Помогне > /> Помощ за разговор
> /> Категория > /> Категория беседа

Не бъркайте локализираните пространства от имена с персонализирани пространства от имена.

Форматиране

Взема неформатиран номер (арабски, без разделители на групи и. Като десетичен разделител) и го извежда в локализирания цифров скрипт и форматиран с десетични и десетични разделители на групи, според локала по подразбиране на wiki.
Параметърът | R може да се използва за обръщане на поведението, за използване в математически ситуации: той е надежден и трябва да се използва само за деформиране на числа, за които е известно, че са форматирани точно както formatnum ги форматира с локала на wiki.

Параметърът NOSEP („без разделители“) означава, че не се променят никакви разделители на групи/десетици; formatnum ще преобразува само самите цифри в езици, които не използват индуистко - арабската цифрова система. NOSEP може също така да предотврати нестандартни групировки от цифри, които не бихте очаквали.

Внимание: Водещите нули не се премахват, вместо това можете да използвате>, ако имате инсталирано Extension: ParserFunctions.
Внимание: Ако не въведете числа в точния необходим формат, не очаквайте надежден изход, особено на не-английски уикита.

Ако наистина трябва да форматирате (според локала на wiki) число в неизвестен входен формат, можете да опитате да използвате formatnum два пъти (но не и ако може да има десетична група или разделителят му ще бъде изяден или номерът няма да бъде форматиран). Имайте предвид, че това е по-скоро хак, отколкото обикновен начин за продължаване, така че изходът може да не е надежден.

>
→ 2009 25 декември (ваше предварително), 25 декември 2009 (по подразбиране)
>
→ 25 декември 2009 г. (вашето предварително), 25 декември 2009 г. (по подразбиране)
>
→ 25 декември 2009 г. (вашето предварително), 25 декември 2009 г. (по подразбиране)
>
→ 2009-12-25 (вашето предварително), 2009-12-25 (по подразбиране)
>
→ 25 декември (ваше предварително), 25 декември (по подразбиране)

Бележки: В примера по-горе „your pref“ се отнася до предпочитанието ви за дата само в текущата wiki MediaWiki.