Magiska ord är textsträngar som MediaWiki associerar med ett returvärde eller en funktion, till exempel tid, siddetaljer eller sidnamn. Den här sidan förklarar bara standard magiska ord; För en teknisk referens, se Manual:Magiska ord.
Det finns tre vanliga typer av magiska ord:
Beteendeväxlare: dessa skrivs vanligtvis som stora bokstäver omgivna av dubbla understreck, t.ex__FOO__.
Variabler: Dessa är versaler omgivna av dubbla hakparenteser, t.ex.{{FOO}}. Som sådan ser de mycket ut som mallar.
Variabler och parserfunktioner kan använda subst:, precis som mallar. Sidberoende magiska ord påverkar eller returnerar data om den nuvarande sidan (som standard), även om ordet läggs till via en transkluderad mall eller inkluderat systemmeddelande.
Beteendeväxlare
En beteendeväxlare styr layouten eller beteendet på sidan (om det stöds av utseendet) och kan ofta användas för att ange önskvärda utelämningar eller inkluderingar i innehållet. Notera att några av dessa ej stöds av Minerva-utseendet.
Tvingar innehållsförteckningen att visas på sin normala position (innan den första rubriken, upphäver __NOTOC__).
__TOC__
Placerar en innehållsförteckning vid ordets nuvarande position (upphäver __NOTOC__). Om detta används flera gånger visas innehållsförteckningen vid första ordets position.
Redigering
__NOEDITSECTION__
Döljer sektionen för redigeringslänkarna bredvid rubrikerna. Det här är särskilt användbart där en rubrik skapas från en mall: den normala wikisektionsredigeringen skulle i detta fall redigera mallkoden, som normalt är kontraintuitiv för användaren. Användning av detta i en mall kommer att breda ut effekten till den mallen, sidorna den finns med i, och alla andra mallar som ingår på samma sida. För en lösning, se här.
__NEWSECTIONLINK__
Lägger till en länk bredvid fliken "Redigera" för att lägga till ett nytt avsnitt på en sida som inte är en diskussionssida (se Lägga till avsnitt i slutet).
≥ 1.7
__NONEWSECTIONLINK__
Tar bort länken bredvid fliken "Redigera" på sidor i diskussionsnamnrymden.
Används på en kategorisida, ersätter miniatyrer i en kategorivy med vanliga länkar.
≥ 1.7
__HIDDENCAT__
Används på en kategorisida, döljer kategorin från listorna över kategorier i dess medlemmar och förälderkategorier (det finns ett alternativ i användarinställningar för att visa dem).
På wikier med språkvarianter, utför inte någon omvandling av innehållsspråk (tecken och fas) i artikelvisningen; till exempel, visa bara kinesiska (zh) istället för varianter som zh_cn, zh_tw, zh_sg eller zh_hk.
__NOTITLECONVERT__ __NOTC__
På wikier med språkvarianter, utför inte språkomvandling på titeln (allt annat innehåll konverteras).
Övrigt
__START__
Ingen effekt. Användes för att peka på var databasmeddelandet börjar efter en kommentar som inte ska överföras. Borttagen i r1695 och helt borttagen i r24784
Berätta för sökmotorer att inte indexera sidan (det vill säga listas inte i sökmotorns resultat). Den hörsammar variabeln $wgExemptFromUserRobotsControl.
På omdirigeringssidor, låter inte MediaWiki automatiskt uppdatera länken när någon flyttar en sida och kontrollerar "$fixDoubleRedirects" (vilket kräver $wgFixDoubleRedirects).
Inaktiverar den globala användarsidan. Om den finns på den centrala användarsidan kommer den att förhindras visas på fjärranslutna wikier, och det avgör också om en länk till en användarsida på fjärransluten wiki ska vara röd eller blå.
Variabler returnerar information om aktuell sida, wiki eller datum. Deras syntax motsvarar mallar. Variabler markerade som "[expensive]" spåras av mjukvaran, och antalet som kan inkluderas på en sida är begränsat.
Om ett mallnamn står i konflikt med en variabel kommer variabeln att användas (så för att transkludera mallen Template:PAGENAME behöver du skriva {{Template:PAGENAME}}). I vissa fall kommer parametrar att tvinga parsern att anropa en mall; till exempel, {{CURRENTDAYNAME|x}} transkluderar Template:CURRENTDAYNAME, inte variabeln.
Datum och tider
Följande variabler returnerar det aktuella datumet och tiden i UTC.
På grund av MediaWiki och webbläsarens caching visas dessa variabler ofta när sidan cachats istället för den aktuella tiden.
Användningen av dessa variabler gör så att sidan förblir cachad i en mer begränsad andel sekunder. Detta konfigureras i MagicWordFactory.
Magiska ord för datum och tid formateras på wikins innehållsspråk. Sedan 1.19 beror de på språket för sidinnehåll.
Underdomän och domänens namn (inte längre beroende av $wgServerName från och med version 1.17).
{{DIRMARK}}
{{DIRECTIONMARK}}
Utmatar en Unicode riktningsmarkör som passar till wikins grundspråks riktning (‎ för vänster-till-höger wikier, ‏ för höger-till-vänster wikier), användbar i text med text som går i flera riktningar. Sedan 1.19, beror den på sidans innehållsspråk.
Utmatar skyddsnivån (t ex "autoconfirmed", "sysop") för en given åtgärd (t.ex. "redigera", "flytta") på den aktuella sidan. Returnerar en tom sträng om den inte är skyddad.
Ger utgångsdatum för skydd (t ex "20160418155030", "oändlighet") för en given åtgärd (t.ex. "redigera", "flytta") på den aktuella sidan. Returnerar "oändlighet" om den inte skyddats.
[Resurskrävande] Returnerar källorna till något kaskaderat skydd som verkar på den aktuella sidan. Sidor kommer returnera sin egen titel om de inte transkluderar sig själva.
Unikt revisions-ID Den här är tom i förhandsvisningar, därav kan det endast ge ett felmeddelande i förhandsvisningar. Har kanske stängts av i miser mode.
≥ 1.5
{{REVISIONDAY}}
5
Dag i månaden redigeringen gjordes (nummer utan nolla).
≥ 1.8
{{REVISIONDAY2}}
05
Dag i månaden redigeringen gjordes (nummer med nolla).
≥ 1.8
{{REVISIONMONTH}}
08
Månaden redigeringen gjordes (nummer med nolla sedan 1.17+, utan nolla i tidigare versioner).
Formatera den aktuella sidans rubrik. Värdet måste motsvara standardtiteln: endast versalisering till vissa delar av titeln (inte alla) och ersättning av mellanslag med understreck är tillåtna (detta kan ändras med $manual-wg-limit-disp-title). Det kan inaktiveras eller aktiveras av $wgAllowDisplayTitle; inaktiverad som standard före 1.10+, aktiverad som standard därefter.
Det kan ta ett andra argument om "noerror" eller "noreplace" för att undertrycka felmeddelanden när flera visningsbeteckningar används på en sida eller för att få displaytitle att göra ingenting om en displaytitle redan har angivits tidigare på sidan.
Används för att kategorisera sidor, anger en standard sorteringsnyckel för kategori. Till exempel om du sätter {{DEFAULTSORT:Smith, John }} i slutet av John Smith, skulle sidan sorteras under "S" som standard i kategorier. Det kan ta ett andra argument om noerror eller noreplace för att undertrycka felmeddelanden när flera standardvärden används på en sida eller för att få $2 att ingenting göra om en defaultsort redan angavs tidigare på sidan.
Nummer som returneras av dessa variabler innehåller normalt separatorer (kommatecken, prickar eller mellanslag, beroende på det lokala språket) men kan returnera råa nummer med flaggan ":R" (till exempel {{NUMBEROFPAGES}} → 987 137 och {{NUMBEROFPAGES:R}} → 987137).
Använd "|R" för magiska ord som kräver en parameter som PAGESINCATEGORY (till exempel {{PAGESINCATEGORY:Help}} och {{PAGESINCATEGORY:Help|R}} eller {{PAGESINCATEGORY:Help|subcats}} och {{PAGESINCATEGORY:Help|subcats|R}}). Gäller även på {{PAGESIZE:sidnamn}} här ovan.
Magiska ord för datum och tid formateras på wikins innehållsspråk. Sedan 1.19 beror de på språket för sidinnehåll.
[Resurskrävande]Antal sidor i den angivna namnrymden (ersätt "index" med relevant namnrymdsindex). Exempelvis kommer $pins14 att mata ut antalet kategorisidor. $pins0 skiljer sig från $noa eftersom den tidigare innehåller omdirigeringar och disambigueringssidor. Inaktiverad som standard, aktivera med $manual-wg-allow-slow-parser-funct. For instance, {{PAGESINNAMESPACE:14}} will output the number of category pages. {{PAGESINNS:0}} differs from {{NUMBEROFARTICLES}} in that the former includes redirects and disambiguation pages. Disabled by default, enable with $wgAllowSlowParserFunctions.
≥ 1.7
Sidnamn
Variabel
För den senaste sidan
Beskrivning
Versioner
{{FULLPAGENAME}}
Help:Magic words/sv
Namnrymd och fullständig sidtitel (inklusive alla underside-nivåer).
≥ 1.6
{{PAGENAME}}
Magic words/sv
Hela sidtiteln (inklusive alla underside-nivåer) utan namnrymden.
{{BASEPAGENAME}}
Magic words
Sidans titel på den närmast överordnade underside-nivån utan namnrymden. Skulle returnera Title/Foo på sidan Help:Title/Foo/Bar.
≥ 1.7
{{ROOTPAGENAME}}
Magic words
Namn på roten för den aktuella sidan. Skulle returnera Title på sidan Help:Title/Foo/Bar.
≥ 1.22
{{SUBPAGENAME}}
sv
Rubriken för en undersida. Skulle returnera Bar på sidan Help:Title/Foo/Bar.
Om ingen undersida finns, returneras värdet {{PAGENAME}}.
Fullständigt sidnamn för det associerade ämnet (t.ex. artikel eller fil). Användbart på diskussionssidor.
≥ 1.7
{{TALKPAGENAME}}
Help talk:Magic words/sv
Fullständigt sidnamn för den associerade diskussionssidan.
≥ 1.7
Inga av dessa påverkas av ändringar av rubriken, vid användning av {{DISPLAYTITLE:xxxx}}; returneras den ursprungliga rubriken.
De magiska orden {{BASEPAGENAME}} och {{SUBPAGENAME}} fungerar bara i namnrymder som har delsidor aktiverade. Se $wgNamespacesWithSubpages för information om hur du aktiverar delsidor.
Från och med 1.15+, kan alla ta en parameter, vilket tillåter att specifikationen av sidan kan opereras på, istället för bara den aktuella sidan:
{{PAGENAME:Template:Main Page}} → Main Page
Varning:
Om sidtiteln innehåller delar som är "." eller "..", returnerar det magiska ordet ingenting.
Sidtitlar som innehåller vissa tecken, till exempel apostrofer ' eller asterisker *, kan ge oväntade resultat när de hanteras med dessa magiska ord, t.ex. {{PAGESINCATEGORY:{{PAGENAME}}}}. Se buggar T16779, T18474, T37628, T37746. Ett enkelt sätt att åtgärda detta är att paketera sidnamnet i {{#titleparts:}} från ParserFunctions-tillägget.
Följande är ekvivalenter kodade för användning i MediaWiki-webbadresser (mellanslag ersatta med understreck och vissa tecken procentkodade):
{{NAMESPACEE}}
{{SUBJECTSPACEE}}
{{ARTICLESPACEE}}
{{TALKSPACEE}}
Från och med 1.15+ kan dessa ta en parameter
för fullständigt sidnamn och returnera den begärda namnrymden som är associerad med den sidan, i stället för med den aktuella sidan:
{{NAMESPACENUMBER:MediaWiki}} → 0
{{NAMESPACE:MediaWiki}} → (Pages in main space will return empty)
{{NAMESPACE:Template:Main Page}} → Template
{{SUBJECTSPACE:Template:Main Page}} → Template
{{ARTICLESPACE:Template:Main Page}} → Template
{{TALKSPACE:Template:Main Page}} → Template talk
Parametern får inte vara ett namnrymdsnamn:
{{SUBJECTSPACE:Help talk}} → (Empty)
Övrigt
Variabel
Utmatning
Beskrivning
Versioner
{{!}}
|
Används för att inkludera ett vertikalstreck som en del av ett mallargument eller tabellcellsinnehåll. Innan detta lagts till som ett magiskt ord, implementerade många wikier detta genom att skapa Mall:! Med | som innehåll.
Parserfunktionerna liknar mycket variabler men tar en eller flera parametrar (tekniskt sett är varje magiskt ord som tar en parameter en parserfunktion), och namnet är ibland prefixat med en nummertecken för att särskilja dem från mallar.
Den här sidan beskriver bara parserfunktioner som är integrerade i MediaWiki-programvaran. Andra parserfunktioner kan läggas till med MediaWiki-tillägg som Extension:ParserFunctions. Se Help:Extension:ParserFunctions för dessa.
[Resurskrävande] Utmatar skyddsnivån (t ex "autoconfirmed", "sysop") för en given åtgärd (t.ex. "redigera", "flytta") på den aktuella sidan. Returnerar en tom sträng om den inte är skyddad.
[Resurskrävande] Utmatar skyddets utgångsdatum (t.ex. "20160418155030", "oändligt") för en åtgärd (t.ex. "redigera" och "flytta") på den angivna sidan. Returnerar "oändlighet" om inte skyddad.
[Resurskrävande] Returnerar källorna till kaskaderade skydd som verkar på den aktuella sidan. Sidor kommer returnera sin egen titel om de inte transkluderar sig själva.
*När den angivna parametern är lika med parserns nuvarande titel, kommer parserfunktionen att ge de tidigare versionerna i förhandsvisningen och på substitution, som inkluderar tomma strängar när de används vid sidskapande men använder värdena från den aktuella versionen för sidvisning, inklusive visning av gamla revisioner. I det här fallet är det en icke-resurskrävande parserfunktion.
En protokoll-relativ sökväg till titeln, som beror på $wgServer konfigurationsinställning för den lokala wikin (så kanske eller kanske inte börjar med http(s)://). Detta kommer också att lösa interwiki prefix. Obs! Obegränsade (vanliga) protokollrelativa länkar är inte automagiskt länkade.
{{urlencode:sträng}} eller {{urlencode:sträng|QUERY}} {{urlencode:sträng|WIKI}} {{urlencode:sträng|PATH}}
{{urlencode:x:y/z á é}} or {{urlencode:x:y/z á é|QUERY}} → x%3Ay%2Fz+%C3%A1+%C3%A9 {{urlencode:x:y/z á é|WIKI}} → x:y/z_%C3%A1_%C3%A9 {{urlencode:x:y/z á é|PATH}} → x%3Ay%2Fz%20%C3%A1%20%C3%A9
Observera att standardvärdet ändrats från |WIKI till |QUERY i 1.17; detta kan bryta mallar som är beroende av denna funktion.
Inmatningen kodas för användning i webbadresser. Observera att det inte finns någon urldecode-funktion som det finns i föråldrade Extension:StringFunctions.
{{ns:}} returnerar det nuvarande lokala namnet på namnrymden med det indexet, kanoniska namnet eller lokala aliaset. Därav returnerar {{ns:6}}, {{ns:File}} och {{ns:Image}} (ett gammalt namn för fil-namnrymden) alla "File". På en wiki där innehållsspråket är franska är också {{ns:Fichier}} giltig, men inte {{ns:Datei}} (det lokala namnet på fil på tyska).
{{nse:}} är den motsvarande koden för MediaWiki-URL:er. Den gör detsamma men ersätter mellanslag med understreck, vilket gör den användbar i externa länkar.
Exempel med fel inmatning (opålitlig utmatning), med eller utan |R: {{formatnum:987,654.321|R}} (den minst trasiga) {{formatnum:987.654,321|R}} {{formatnum:987 654,321|R}} {{formatnum:987 654,321|R}}
Takes an unformatted number (Arabic, no group separators and . as decimal separator) and outputs it in the localized digit script and formatted with decimal and decimal group separators, according to the wiki's default locale.
The |R parameter can be used to reverse the behavior, for use in mathematical situations: it's reliable and should be used only to deformat numbers which are known to be formatted exactly as formatnum formats them with the wiki's locale.
The NOSEP ("no separators") parameter means that no group / decimal separators are changed; formatnum will only transform the digits themselves in languages which don't use the Hindu–Arabic numeral system. NOSEP can also prevent non-standard digit groupings you wouldn't expect.
Varning:
Leading zeroes are not removed, you can use {{#expr:00001}} instead if you have Extension:ParserFunctions installed.
Varning:
If you don't input numbers in the exact format required, don't expect any reliable output, especially on non-English wikis.
If you really need to format (according the wiki's locale) a number in unknown input format, you could try and use formatnum two times (but not if it can have a decimal group, or its separator will be eaten or the number won't be formatted). Be aware that this is more a hack than a regular way to proceed, thus the output may be not reliable.
{{#dateformat:25 dec 2009|ymd}}
→ 2009 december 25 (your pref), 2009 Dec 25 (default) {{#formatdate:dec 25,2009|dmy}}
→ 25 december 2009 (your pref), 25 Dec 2009 (default) {{#dateformat:2009-12-25|mdy}}
→ december 25, 2009 (your pref), December 25, 2009 (default) {{#formatdate:2009 dec 25|ISO 8601}}
→ 2009-12-25 (your pref), 2009-12-25 (default) {{#dateformat:25 decEmber|mdy}}
→ december 25 (your pref), DecEmber 25 (default) Note: In the example hereinbefore, "your pref" refers to your date preference on the current MediaWiki wiki only.
Formats an unlinked date based on user "date format" preference, and adds metadata tagging it as a formatted date. For logged-out users and those who have not set a date format in their preferences, dates can be given a default: mdy, dmy, ymd, ISO 8601 (all case sensitive). If only the month and day are given, only mdy and dmy are valid. If a format is not specified or is invalid, the input format is used as a default. If the supplied date is not recognized as a valid date (specifically, if it contains any metadata such as from a nested use of these or similar templates), it is rendered unchanged, and no (additional) metadata is generated.
Varning:
Although the ISO 8601 standard requires that dates be in the Gregorian calendar, the ISO parameter in this function will still format dates that fall outside the usual Gregorian range (e.g. dates prior to 1583). Also, the magic word cannot properly convert between negative years (used with ISO 8601) and years BC or years BCE (used in general writing).
{{padleft:xyz|5|_}} → __xyz {{padleft:xyz|5|abc}} → abxyz {{padleft:xyz|2}} → xyz {{padleft:|1|xyz}} → x
(first character of the string)
Inserts a string of padding characters (character chosen in third parameter; default "0") of a specified length (second parameter) next to a chosen base character or variable (first parameter). The final digits or characters in the base replace the final characters in the padding; i.e. {{padleft:44|3|0}} produces 044. The padding string may be truncated if its length does not evenly divide the required number of characters.
Only the first character of the third parameter is used in versions up to 1.12, but by version 1.15, all the characters are used.
Bug (fixed in r45734): multibyte characters are interpreted as two characters, which can skew width. These also cannot be used as padding characters.
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular #Date and time, #Formatting, #Miscellaneous. More magic words are added by the Tillägg:Translate.
The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.
Användning
Inmatning → Utmatning
Beskrivning
Versioner
{{plural:2|is|are}}
{{plural:0|is|are}} → are {{plural:1*1|is|are}} → is {{plural:21 mod 10|is|are}} → are {{plural:{{#expr:21 mod 10}}|is|are}} → is {{plural:1|is|are}} → is {{plural:2|is|are}} → are {{plural:-1|is|are}} → is {{plural:-2|is|are}} → are {{plural:0.5|is|are}} → are {{plural:1.5|is|are}} → are {{plural:-0.5|is|are}} → are {{plural:-1.5|is|are}} → are (För ryska) {{PLURAL:5|1=Категория|Категории}} → Категории
Outputs the singular form (second parameter) if the absolute value of the first parameter is an expression equalling one; the plural form (third parameter) otherwise. Its functioning is language-dependent.
Some language codes (ab, av, ba, bxr, ce, crh_cyrl, cv, inh, koi, krc, kv, lbe, lez, mhr, mrj, myv, ru, tt_cyrl, tyv, udm, xal) used 3 plural forms (updated 01.2014):
Outputs the correct inflected form of the given word described by the inflection code after the colon (language-dependent). Grammar transformations are used for inflected languages like Polish. See also $wgGrammarForms.
≥ 1.7
{{gender:username|text for every gender}}
{{gender:Username|male text|female text|text for unspecified}} {{gender:|male text|female text|text for unspecified}} {{gender:.|male text|female text|text for unspecified}}
Note: The first example is basically a no-op Note: If 3rd parameter is omitted and user hasn't defined their gender, then text if user is male is returned. A blank username field ({{gender:|) means the current user, but can be used only in interface messages (MediaWiki namespace).
A dot username (.) means the default user gender on this wiki.
{{int:edit}} → Edit (Beror på användarspråket; prova: fr • ja)
Internationalizes (translates) the given interface (MediaWiki namespace) message into the user language. For msgnw and other transclusion magic words, see the Transclusion modifiers section.
Note that this can damage / confuse cache consistency in MediaWiki 1.17 and earlier, see T16404.
You may also use parameters with translations. Parameters are designated in messages with: $1, $2, $3, etc. For example, here is the message for editsectionhint: Edit section: $1 In this example, MediaWiki replaces $1.
Transclusion modifiers
{{Page name|optional params}} usually transcludes another page, by default from the Template:namespace.
These magic words modify that behavior.
Usage
Output
Description
Version
{{:xyz}}
A bare colon is not a template modifier but the prefix for the main namespace. Since transclusion defaults to the Template namespace, you would use for example, {{:UTC}} (vs. {{UTC}}) to include the text of the main namespace article UTC rather than Template:UTC.
{{int:xyz}}
Same as {{MediaWiki:xyz}}, except standard message translation is applied depending on subpages and content/user/uselang language. Another difference is: this doesn't appear under "Mallar som används på den här sidan:". Rendered as ⧼xyz⧽ if MediaWiki:xyz doesn't exist. See also Help:Systemmeddelanden.
{{msg:xyz}} {{raw:xyz}}
Even if there is a magic word named "xyz", use template:xyz unless the template doesn't exist (equivalent to {{template:xyz}}). Normally, magic words have priority when there is a conflict.
{{raw:xyz}}
If $wgEnableScaryTranscluding is enabled, and this is an interwiki transclusion, include the raw wikitext instead of the html from the foreign wiki.
The full name of the language for the given language code: native name (language autonym) by default, name translated in target language if a target language code is specified. Extension:CLDR must be installed for the translation to work.
{{#tag:taggens namn |innehåll |attribut1=värde1 |attribut2=värde2 }}
(Beror på tolkningstagg)
Alias for XML-style MediaWiki parser tags or extension tags. It allows a pre-save transform of wiki code and Extension:ParserFunctions within tags before the tag is processed. It also prevents parsing of tags in conditional paths that aren't executed (like in #if statements). Content between tags is passed as the first parameter, and any attributes for the tags can be passed as subsequent parameters. This example:
<taggens namn attribut1="värde1" attribut2="värde2">Ditt innehåll här</taggens namn>
{{#tag:ref|Citattext går här, och du kan inkludera parserfunktioner som {{#expr: ... }} och magiska ord som {{PAGENAME}}.|namn="multipel"}}
Varning:
You must write {{#tag:tagname||attribute1=value1|attribute2=value2}} to pass an empty content. No leading or trailing space of the text content are permitted between the pipe characters || before attribute1.
Varning: