Pomoc Kúzelné slová - MediaWiki

Obsah

  • 1 Prepínače správania
  • 2 Premenlivá
    • 2.1 Dátum a čas
    • 2.2 Technické metadáta
    • 2.3 Štatistika
    • 2.4 Názvy strán
      • 2.4.1 Názvy stránok kódovaných URL
    • 2.5 Menné priestory
    • 2.6 Ostatné
  • 3 Funkcie syntaktického analyzátora
    • 3.1 Technické metadáta inej stránky
    • 3.2 Údaje URL
    • 3.3 Menné priestory
    • 3.4 Formátovanie
    • 3.5 Lokalizácia
    • 3.6 Modifikátory prekladača
    • 3.7 Rôzne

Magické slová sú reťazce textu, ktoré MediaWiki spája s hodnotou premennej alebo funkciou, ako napríklad čas, podrobnosti o stránke alebo názvy stránok. Táto stránka vysvetľuje iba štandardné magické slová; technickú príručku nájdete v príručke: Magické slová .

slová

Existujú tri všeobecné typy čarovných slov:

  • Prepínače správania: sú zvyčajne písané vo forme veľkých písmen, nahradené dvojitými podčiarknutiami, napríklad.__FOO__ .
  • premenné: sú to slová veľkými písmenami obklopené dvojitými zátvorkami, napríklad.> . Preto sú veľmi podobné niektorým formátom.
  • Funkcie syntaktického analyzátora: dostávajú parametre a sú buď tvaru >, byť vo forme >, napríklad. >. Pozri tiež Pomoc: Extension: ParserFunctions a Extension: Scribunto .

Premenné a funkcie syntaktického analyzátora môžu používať subst:, ako aj formáty. Kúzelné slová závislé od stránky ovplyvnia alebo vrátia údaje o stránke Prúd (predvolené), aj keď je slovo pridané prostredníctvom prepisovaného formátu alebo zahrnutej systémovej správy.

Prepínač správania riadi vzhľad alebo správanie stránky (ak to podporuje použitý vzhľad) a často ho možno použiť na určenie vynechania alebo zahrnutia konkrétneho obsahu. Niektoré z nich nie sú podporované, napríklad skinom Minervy

Premenné vrátia informácie o aktuálnej stránke, wiki alebo dátume. Ich syntax je podobná formátom. Softvér sleduje premenné označené ako „ [Nákladné] ”, A počet takýchto premenných, ktoré je možné zahrnúť na stránku, je obmedzený.

Ak je názov formátu v rozpore s premennou, použije sa premenná (takže na prepis formátu Šablóna: PAGENAME budete musieť napísať>). V niektorých prípadoch pridanie parametrov prinúti syntaktický analyzátor vyvolať formát; napríklad> vylúčiť šablónu: CURRENTDAYNAME, nie premenná.

Dátum a čas

Nasledujúce premenné vrátia aktuálny dátum a čas v UTC.

Kvôli MediaWiki a ukladaniu do vyrovnávacej pamäte prehliadača sa tieto premenné zobrazujú, keď bola stránka uložená v pamäti, nie aktuálny dátum.

Použitie týchto premenných spôsobí, že sa stránky ukladajú do medzipamäte na obmedzenejší počet sekúnd. Toto je nakonfigurované v MagicWordFactory.

Magický dátum a čas sú formátované v jazyku obsahu wiki. Od 1.19 závisia od jazyka obsahu wiki.

Nasledujúce premenné sú rovnaké ako predtým, ale používajú konfiguráciu servera lokality alebo $ wgLocaltimezone.

Ak chcete získať podrobnejšie formátovanie času alebo zabezpečiť, aby bol aktuálny rok a týždeň kompatibilnejší s normou ISO-8601, možno budete chcieť nainštalovať rozšírenie: ParserFunctions, aby ste mohli použiť funkciu #time parser..

Technické metadáta

Premenná Čo vytvára verzie popisu webovú stránku
> MediaWiki Názov wiki stránky ($ wgSitename)
> //www.mediawiki.org URL domény ($ wgServer).
> www.mediawiki.org Názvy domén a subdomén (od verzie 1.17 už nezávisia od $ wgServerName).
>

Nepreložená jednotka. Jazyk:> .

Nepreložená jednotka. Jazyk: en.

Môže dostať druhý argument noerror alebo miesto potlačiť chybové správy pri viacnásobnom použití DISPLAYTITLE na jednej stránke alebo dosiahnuť, aby tento DISPLAYTITLE neurobil nič, ak už bol na stránke zadaný iný DISPLAYTITLE.

(pre noerror a noreplace)

(pre noerror a noreplace)

Štatistika

Čísla vrátené týmito premennými zvyčajne obsahujú oddeľovače (čiarky, bodky alebo medzery, v závislosti od miestneho jazyka), môžu však vracať nespracované čísla s príznakom „: R“ (napríklad> → 1.010.874 a> → 1010874).

Počet čarovných slov je formátovaný v jazyku obsahu wiki. Od verzie 1.19 závisí od jazyka obsahu stránky.

Respektíve počet

  • všetky strany
  • bežné stránky (okrem podkategórií a súborov)
  • podkategórie alebo
  • súbory

Názvy stránok

Názov stránky na bezprostredne vyššej úrovni podstránky bez menného priestoru.

Vrátil by lištu na stránke Pomoc: Titul/Foo/lišta .

Ak neexistuje žiadna podstránka, vráti sa hodnota>.

Na nič z toho nemá vplyv zmena zobrazovaného názvu pomocou>; vrátené hodnoty sú pôvodný názov stránky.

Čarovné slová> a> fungujú iba v menných priestoroch, ktoré majú povolené podstránky. Informácie o povolení podstránok nájdete na stránke $ wgNamespacesWithSubpages.

Od verzie 1.15+ môžu všetci mať parameter, ktorý umožňuje špecifikáciu stránky, na ktorej sa má pracovať, nielen aktuálnej stránky:

  • > → Hlavná stránka
Výstraha:Ak nadpis stránky obsahuje akékoľvek časti, ktoré sú „.“ Alebo „.“, zázračné slovo nevráti nič. > → '. Nič sa nevracia.
Výstraha:Názvy stránok, ktoré obsahujú určité znaky, napríklad apostrofy alebo hviezdičky *, môžu pri používaní týchto čarovných slov spôsobiť neočakávané výsledky, napr. >>>. Viď chyby T16779, T18474, T37628, T37746. Jeden jednoduchý spôsob, ako to napraviť, je zabalenie názvu stránky do> z rozšírenia ParserFunctions.

Názvy stránok zakódované do URL

Nasledujú ekvivalenty kódované na použitie v adresách URL MediaWiki (tj. Medzery nahradené podčiarkovníkmi a niektoré znaky HTML unikli pomocou číselného kódovania znakov):

Upozorňujeme, že>,> a> majú odlišné implementácie. Podrobnosti nájdete v príručke: Kódovanie PAGENAMEE.

menné priestory

Nasledujú ekvivalenty kódované na použitie v adresách URL MediaWiki (medzery nahradené znakom podčiarknutia a niektoré znaky kódované percentuálne):

Od verzie 1.15+ môžu tieto mať parameter názvu celej strany a namiesto aktuálnej stránky vrátia požadovaný menný priestor spojený s touto stránkou:

  • > → 0
  • > → (Stránky v hlavnom priestore sa vrátia prázdne)
  • > → šablóna
  • > → šablóna
  • > → šablóna
  • > → Prednáška o šablóne

Parameter nesmie byť názov menného priestoru:

Iné

Funkcie syntaktického analyzátora

Funkcie syntaktického analyzátora sú veľmi podobné premenným, ale berú jeden alebo viac parametrov (technicky je každé čarovné slovo, ktoré preberá parameter, funkciou syntaktického analyzátora) a na ich odlíšenie od šablón má niekedy názov predponu hash.

Táto stránka popisuje iba funkcie syntaktického analyzátora, ktoré sú neoddeliteľnou súčasťou softvéru MediaWiki. Ďalšie funkcie syntaktického analyzátora môžu byť pridané rozšíreniami MediaWiki, ako napríklad Extension: ParserFunctions. Pre tých, ktorí hľadajú pomoc: Extension: ParserFunctions .

Technické metadáta inej stránky

konať | názov stránky>>

  • Keď je daný parameter rovný aktuálnemu názvu analyzátora, funkcia syntaktického analyzátora prinesie predchádzajúce verzie pri náhľade a substitúcii, ktoré zahŕňajú prázdne reťazce pri použití pri vytváraní stránky, ale s použitím hodnôt z aktuálnej verzie pre zobrazenie stránky vrátane prezeranie starých revízií. V tomto prípade ide o nenákladnú funkciu syntaktického analyzátora.

Údaje URL

Funkcia syntaktického analyzátora Vstup → Výstup Popis Verzie
názov stránky >>
názov stránky
| QUERY_STRING >>		 >
→/wiki/MediaWiki
>
→ /w/index.php?title=MediaWiki&printable=yes		 Relatívna cesta k názvu.
názov stránky >>
názov stránky
| QUERY_STRING >>
interwiki: názov vzdialenej stránky
| QUERY_STRING >>		 >
→ //www.mediawiki.org/wiki/Category:Top_level

Parameter nowiki zvyčajne odstráni prepojenie okolo cesty k súboru (čo v tomto príklade nevidno).

Upozorňujeme, že predvolené nastavenie sa zmenilo z | WIKI na | QUERY v 1.17; môže to poškodiť šablóny, ktoré sa spoliehajú na túto funkciu.

menné priestory

> vráti aktuálny lokalizovaný názov priestoru mien s týmto indexom, kanonickým názvom alebo lokálnym aliasom. Preto>,> a> (starý názov pre priestor názvov súborov) všetky vrátia hodnotu „File“. Na wiki, kde je jazykom obsahu francúzština,> je tiež platné, ale> (lokalizácia súboru „v nemčine“) nie je.

> je ekvivalent zakódovaný pre adresy URL MediaWiki. Robí to isté, ale medzery nahrádza podčiarknutiami, takže je použiteľný v externých odkazoch.

Menné priestory obsahu Hovorte o menných priestoroch Výstup použitia Výstup použitia
> /> Sprostredkovať > /> Špeciálne
(č hovoriť stránka)
> /> > /> Porozprávajte sa
> /> Zákazník > /> Diskusia s používateľom
> /> Projekt
Líši sa medzi wiki 		> /> Diskusia k projektu
> /> alebo> Filé > /> alebo> Podajte rozhovor
> /> MediaWiki > /> Diskusia k MediaWiki
> /> šablóna > /> Prednáška o šablóne
> /> Pomoc > /> Pomôžte rozprávať
> /> Kategória > /> Diskusia o kategórii

Nezamieňajte lokalizované menné priestory s vlastnými mennými priestormi.

Formátovanie

Zoberie neformátované číslo (arabské, bez oddeľovačov skupín a. Ako oddeľovač desatinných miest) a na výstupe ho umiestni skript lokalizovaných číslic a naformátuje sa oddeľovačmi desatinných a desatinných skupín podľa predvoleného miestneho nastavenia wiki.
Parameter | R sa dá použiť na zvrátenie správania pre použitie v matematických situáciách: je spoľahlivý a mal by sa používať iba na deformovanie čísel, o ktorých je známe, že sú formátované presne tak, ako ich formatnum formátuje pomocou miestneho nastavenia wiki.

Parameter NOSEP ("bez oddeľovačov") znamená, že sa nezmenia žiadne oddeľovače skupín/desatinných miest; formatnum prevedie iba samotné číslice na jazyky, ktoré nepoužívajú hindsko-arabskú číselnú sústavu. NOSEP môže zabrániť aj neštandardným zoskupeniam číslic, ktoré by ste nečakali.

Výstraha: Vedúce nuly sa neodstránia. Ak máte nainštalované rozšírenie: ParserFunctions, môžete namiesto nich použiť>.
Výstraha: Ak nezadávate čísla v presnom požadovanom formáte, neočakávajte spoľahlivý výstup, najmä na neanglických wiki.

Ak naozaj potrebujete naformátovať (podľa miestneho nastavenia wiki) číslo v neznámom vstupnom formáte, môžete skúsiť použiť formatnum dvakrát (ale nie, ak môže mať desatinnú skupinu, alebo bude zjedený jeho oddeľovač alebo číslo nebude formátovať). Uvedomte si, že ide skôr o hack než o bežný postup, takže výstup nemusí byť spoľahlivý.

>
→ 25. decembra 2009 (vaše preferencie), 25. decembra 2009 (predvolené)
>
→ 25. decembra 2009 (vaše preferencie), 25. decembra 2009 (predvolené nastavenie)
>
→ 25. decembra 2009 (vaše preferencie), 25. decembra 2009 (predvolené nastavenie)
>
→ 2009-12-25 (váš pref), 2009-12-25 (predvolené)
>
→ 25 decEmber (váš preferovaný), DecEmber 25 (predvolené)

Poznámky: V príklade vyššie sa výraz „váš preferovaný“ vzťahuje na vaše preferencie dátumu iba na aktuálnej wiki stránke MediaWiki.