Manual:Magic words/da



Magisk ord er en teknik til kortlægning af en række wiki tekststrenge til et enkelt ID, der er forbundet med en funktion. Både variabler og parser funktioner bruger denne teknik. Al kortlagt tekst til ID'et vil blive erstattet med funktionens returværdi. Kortlægningen mellem tekststrengene og ID'et er gemt i variablen $magicWords i en fil, der kan indlæses ved hjælp af $wgExtensionMessagesFiles[].

Standard magiske ord er indbygget i CoreParserFunctions.php.

Hvordan magiske ord virker
Når MediaWiki finder tekst mellem dobbelte parenteser skal programmet afgøre, om XXX er en variabel, parser funktion eller skabelon. For at afgøre dette, stiller det en række spørgsmål:


 * 1) Har det et tilhørende magisk ord ID? Som et første skridt i at løse opmærkning med formen . Metoden får sin liste over variable ID'ere fra en stærkt kodet liste af variable ID'er (se Help:Variable) og fra en liste over brugerdefinerede variable ID'er leveret af alle funktioner, der er knyttet til krogen MagicWordwgVariableIDs.
 * 2) **Hvis magisk ord ID'et er blevet klassificeret som en variabel, kalder MediaWiki krogen de funktioner, der er forbundet med hændelsesnavnet 'ParserGetVariableValueSwitch' indtil der findes en, som anerkender det magiske ord og kan returnere dens værdi.
 * 3) Er det en parser funktion? Hvis der er nogen parametre, eller hvis magisk ord ID'et mangler fra listen over variable magisk ord ID'er, så antager MediaWiki, at det magiske ord er en parser funktion eller skabelon. Hvis magisk ord ID'et er fundet på listen over parser funktioner erklæret via et kald til, behandles det som en parser funktion og gengives ved hjælp af funktion med navnet  . Ellers antages det at være en skabelon.
 * 1) Er det en parser funktion? Hvis der er nogen parametre, eller hvis magisk ord ID'et mangler fra listen over variable magisk ord ID'er, så antager MediaWiki, at det magiske ord er en parser funktion eller skabelon. Hvis magisk ord ID'et er fundet på listen over parser funktioner erklæret via et kald til, behandles det som en parser funktion og gengives ved hjælp af funktion med navnet  . Ellers antages det at være en skabelon.

Definition af magiske ord
For at gøre et magisk ord magisk, skal vi definere to ting:
 * en kortlægning mellem wikitekst og et magisk ord ID
 * en kortlægning mellem et magisk ord ID og nogle php-funktioner, der fortolker det magiske ord.

Kortlægning af wikitekst til magisk ord ID'er
Variablen $magicWords bruges til at knytte hvert magisk ord ID med en sprog-afhængig tabel, der beskriver alle tekststrenge, der er kortlagt til magisk ord ID'et.

Det første element i denne tabel er et flag, der angiver om det magiske ord følsom overfor store og små bogstaver. De resterende elementer er en liste over tekst, der skal knyttes til magisk ord ID'et. Hvis stort/lille begyndelsesbogstav flaget er 0, vil alle bostavs-varianter af navnene i tabellen matche. Hvis begyndelsesbogstav flaget er 1, vil kun eksakt match være forbundet med magisk ord ID'et.

Denne forbindelse er skabt af $magicWords i en registreret fil, der bruger $wgExtensionMessagesFiles[].

I eksemplet nedenfor, vil en spansk MediaWiki-installation forbinde magisk ord ID'et 'MAG_CUSTOM' med "#personalizado", "#custom", "#PERSONALIZADO", "#CUSTOM" og alle andre bogstavs-varianter. I en engelsk MediaWiki vil kun "#custom" i forskellige bogstavs-kombinationer blive kortlagt til 'MAG_CUSTOM':

Filen

Udvidelses initialiseringsfilen :

Bemærk, at "ExampleMagic" er anderledes fra nøglen du ville bruge til en almindelig internationaliseringsfil (normalt bare titlen på udvidelsen, nemlig "Eksempel"). "Magic" er blevet vedhæftet bevidst, så man ikke overskriver den anden.

Knytning af et magisk ord ID til en PHP-funktion
Mekanismen for tilknytning af magisk ord ID'er med visnings-funktioner afhænger af om det magiske ord vil blive brugt som en parser funktion eller en variabel. For mere information, se venligst:


 * parser funktioner
 * variabel

Registrering af magiske ord
I MediaWiki 1.8 og nyere der ikke er noget udtrykkeligt krav om at registrere magisk ord ID'er. Registrering af parser funktionen eller variabler, der anvender dem, er tilstrækkelig. For versioner ældre end 1.8, se nedenfor.

Sprog-versioner

 * ''See Help:Magic words#Localisation for help.

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.

Magic words in MediaWiki versions before 1.8
MediaWiki versions prior to 1.8 differed in the following ways:

 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. Extensions that used magic words had to explicitly register their magic word IDs using the hook MagicWordMagicWords. This method simply asked the implementer to supply the ID of the magic word.

 

Behavior switches (double underscore magic words)
Behavior switches are a special type of magic word. They can be recognized by their use of double underscores (rather than double braces). For example,.

These magic words typically do no output any content, but instead change the behavior of a page and/or set a page property. These magic words are listed in  and also at Help:Magic words#Behavior switches. The effect of each behavior switch is defined in. If no specific effect is defined, the magic word will simply set a page property in the page_props table.