Difference between revisions of "Help:Magic words"
m |
m (updating) |
||
Line 1: | Line 1: | ||
{{pp-vandalism|small=yes}} | {{pp-vandalism|small=yes}} | ||
− | {{ | + | {{redirect|H:MW|the MediaWiki namespace|Help:MediaWiki namespace|information about the entire MediaWiki software application|w:MediaWiki}} |
{{BattleTechWiki how-to|H:MW|BTW:MAGIC|BTW:MAGICWORD|BTW:MAGICWORDS}} | {{BattleTechWiki how-to|H:MW|BTW:MAGIC|BTW:MAGICWORD|BTW:MAGICWORDS}} | ||
− | '''Magic words''' (including '''parser functions''', '''variables''' and '''behavior switches''') are features of [[Help:Wiki markup|wiki markup]] that give instructions to BattleTechWiki's underlying [[MediaWiki]] software. For example, magic words can suppress or position the table of contents, disable indexing by external search engines, and produce output dynamically based on the current page or on user-defined conditional logic. Some of these features are especially useful for [[ | + | '''Magic words''' (including '''parser functions''', '''variables''' and '''behavior switches''') are features of [[Help:Wiki markup|wiki markup]] that give instructions to BattleTechWiki's underlying [[w:MediaWiki|MediaWiki]] software. For example, magic words can suppress or position the table of contents, disable indexing by external search engines, and produce output dynamically based on the current page or on user-defined conditional logic. Some of these features are especially useful for [[BattleTechWiki:Templates|templates]]. |
This page is a quick reference for magic words. For more information, refer to the main MediaWiki documentation: | This page is a quick reference for magic words. For more information, refer to the main MediaWiki documentation: | ||
Line 17: | Line 17: | ||
The software generally interprets magic words in the following way: | The software generally interprets magic words in the following way: | ||
− | * Magic words are [[case sensitive]]. | + | * Magic words are [[w:case sensitive|case sensitive]]. |
− | * [[Whitespace character|White space]] is generously allowed for readability. It will be stripped from the start and end of their keywords and parameters (as is also done in template calls using named parameters). | + | * [[w:Whitespace character|White space]] is generously allowed for readability. It will be stripped from the start and end of their keywords and parameters (as is also done in template calls using named parameters). |
− | * They can be [[ | + | * They can be [[BattleTechWiki:Transclusion|transcluded]], even variables "about the current page". This is ensured by the parsing order. |
* Instead of magically transforming into HTML instructions, {{tag|[[help:wikitext#Nowiki|nowiki]]|o}} tags remove this magic so a magic word can itself be displayed (documented), e.g. <code><nowiki><nowiki>{{#magic:}}</nowiki></nowiki></code>or <code><nowiki>{{#magic:<nowiki/>}}</nowiki></code>. | * Instead of magically transforming into HTML instructions, {{tag|[[help:wikitext#Nowiki|nowiki]]|o}} tags remove this magic so a magic word can itself be displayed (documented), e.g. <code><nowiki><nowiki>{{#magic:}}</nowiki></nowiki></code>or <code><nowiki>{{#magic:<nowiki/>}}</nowiki></code>. | ||
Magic words compared to templates: | Magic words compared to templates: | ||
* As with templates, magic words can be [[help:transclusion|transcluded]] and [[Help:substitution|substituted]]. | * As with templates, magic words can be [[help:transclusion|transcluded]] and [[Help:substitution|substituted]]. | ||
− | * The names of magic words are purposely chosen to be unlike the names of templates, and vice versa. Many parser function names will begin with a <code>#</code>([[Hash (character)|pound or hash]]), but template names | + | * The names of magic words are purposely chosen to be unlike the names of templates, and vice versa. Many parser function names will begin with a <code>#</code>([[w:Hash (character)|pound or hash]]), but template names will not start with a <code>#</code>, and probably not end in a <code>:</code>(colon), or be all-uppercase. |
* The first parameter's syntax differs. In <code>{{#magic: <nowiki/>p1 | p2 | p3}}</code>, the name is <code>#magic</code>and it is followed by an unspaced <code>:</code>and a required input parameter, <code>p1</code>. With a template, <code>p1</code>is optional and it is preceded by a <code>|</code>(pipe) instead of a <code>:</code>, e.g. <code>{{template<nowiki/>|p1}}</code>. | * The first parameter's syntax differs. In <code>{{#magic: <nowiki/>p1 | p2 | p3}}</code>, the name is <code>#magic</code>and it is followed by an unspaced <code>:</code>and a required input parameter, <code>p1</code>. With a template, <code>p1</code>is optional and it is preceded by a <code>|</code>(pipe) instead of a <code>:</code>, e.g. <code>{{template<nowiki/>|p1}}</code>. | ||
+ | |||
+ | Most magic words can be used in any needed locations on a page; see [[MOS:ORDER]] for guidance on where to place magic words that are behavior switches. | ||
==Behavior switches== | ==Behavior switches== | ||
Line 34: | Line 36: | ||
|- | |- | ||
! scope=row id=TOC | <kbd><nowiki>__TOC__</nowiki></kbd> | ! scope=row id=TOC | <kbd><nowiki>__TOC__</nowiki></kbd> | ||
− | | Places the page's [[Help:Table of contents|table of contents (TOC)]] at the word's position. | + | | Places the page's [[Help:Table of contents|table of contents (TOC)]] at the word's position. This magic word does not work in skins that present the table of contents outside the article content e.g. the default Vector 2022 skin. |
|- | |- | ||
! scope=row id=FORCETOC | <kbd><nowiki>__FORCETOC__</nowiki></kbd> | ! scope=row id=FORCETOC | <kbd><nowiki>__FORCETOC__</nowiki></kbd> | ||
− | | Forces the TOC to appear in its default position, even when there are fewer than four headings. Can be used anywhere on a page. | + | | Forces the TOC to appear in its default position, even when there are fewer than four headings. Can be used anywhere on a page. This magic word does not work in skins that present the table of contents outside the article content e.g. the default Vector 2022 skin. |
|- | |- | ||
! scope=row id=NOTOC | <kbd><nowiki>__NOTOC__</nowiki></kbd> | ! scope=row id=NOTOC | <kbd><nowiki>__NOTOC__</nowiki></kbd> | ||
Line 58: | Line 60: | ||
|- | |- | ||
! scope=row id=HIDDENCAT | <kbd><nowiki>__HIDDENCAT__</nowiki></kbd> | ! scope=row id=HIDDENCAT | <kbd><nowiki>__HIDDENCAT__</nowiki></kbd> | ||
− | | Makes a category [[ | + | | Makes a category [[WP:HIDDENCAT|hidden]] when included on that category's page. |
|- | |- | ||
! scope=row id=INDEX | <kbd><nowiki>__INDEX__</nowiki></kbd> | ! scope=row id=INDEX | <kbd><nowiki>__INDEX__</nowiki></kbd> | ||
Line 64: | Line 66: | ||
|- | |- | ||
! scope=row id=NOINDEX | <kbd><nowiki>__NOINDEX__</nowiki></kbd> | ! scope=row id=NOINDEX | <kbd><nowiki>__NOINDEX__</nowiki></kbd> | ||
− | | Instructs search engines not to index the page. See [[ | + | | Instructs search engines not to index the page. See [[Wikipedia:Controlling search engine indexing]]. |
|- | |- | ||
! scope=row id=STATICREDIRECT | <kbd><nowiki>__STATICREDIRECT__</nowiki></kbd> | ! scope=row id=STATICREDIRECT | <kbd><nowiki>__STATICREDIRECT__</nowiki></kbd> | ||
Line 70: | Line 72: | ||
|- | |- | ||
! scope=row id=DISAMBIG | <kbd><nowiki>__DISAMBIG__</nowiki></kbd> | ! scope=row id=DISAMBIG | <kbd><nowiki>__DISAMBIG__</nowiki></kbd> | ||
− | | Marks a page as a [[ | + | | Marks a page as a [[WP:DAB|disambiguation page]], adds it to [[Special:DisambiguationPages]] and places inward links in [[Special:DisambiguationPageLinks]]. (See [[mw:Extension:Disambiguator]].) |
|- | |- | ||
! scope=row id=DISPLAYTITLE | <kbd>{<nowiki/>{DISPLAYTITLE:''title''}}</kbd> | ! scope=row id=DISPLAYTITLE | <kbd>{<nowiki/>{DISPLAYTITLE:''title''}}</kbd> | ||
− | | Used to amend the [[ | + | | Used to amend the [[WP:DISPLAYTITLE|displayed form]] of the page's title. |
|- | |- | ||
! scope=row id=DEFAULTSORT | <kbd>{<nowiki/>{DEFAULTSORT:''sortkey''}}</kbd> | ! scope=row id=DEFAULTSORT | <kbd>{<nowiki/>{DEFAULTSORT:''sortkey''}}</kbd> | ||
− | | Sets the default [[ | + | | Sets the default [[Help:Category#Sorting category pages|key]] (the index) under which the page is categorised. Functionality is documented at {{section link|Help:Category#Default sort key}}, and guidelines are at {{section link|Wikipedia:Categorization#Sort keys}}. |
|- | |- | ||
− | ! scope=row id=NOEXTERNALLANGLINKS | <kbd>[[mw | + | ! scope=row id=NOEXTERNALLANGLINKS | <kbd>[[mw:Wikibase/Installation/Advanced configuration#noexternallanglinks|{<nowiki/>{NOEXTERNALLANGLINKS}}]]</kbd> |
− | || (equivalent to {<nowiki/>{NOEXTERNALLANGLINKS|*}}{{thinsp}}) Suppresses the automated inclusion of [[Wikidata:Help:Linking | + | || (equivalent to {<nowiki/>{NOEXTERNALLANGLINKS|*}}{{thinsp}}) Suppresses the automated inclusion of [[Wikidata:Help:Linking Wikipedia pages|Wikidata]] [[Help:Interlanguage links|interlanguage links]] on the lefthand side of the page. Links to particular rather than all languages may be suppressed by using {<nowiki/>{NOEXTERNALLANGLINKS|''list''}}, where ''list'' a [[Vertical bar|pipe]]-[[Delimiter|delimited]] list of [[language code]]s (e.g. {<nowiki/>{NOEXTERNALLANGLINKS|fr{{pipe}}es{{pipe}}ja}} to suppress the French ("fr"), Spanish ("es") and Japanese ("ja") interlanguage links). |
|} | |} | ||
==Variables== | ==Variables== | ||
− | {{Shortcut| | + | {{Shortcut|WP:VAR}} |
− | {{ | + | {{Further|mw:Help:Magic words#Variables|Wikipedia:Page name#sub}} |
− | {{ | + | {{Redirect|WP:VAR|policies and guidelines with WP:*VAR shortcuts, mostly about style matters|WP:VARS}} |
+ | {{Redirect|WP:PAGENAME|the article naming policy|Wikipedia:Article titles}} | ||
{| class="wikitable plainrowheaders" | {| class="wikitable plainrowheaders" | ||
Line 99: | Line 102: | ||
! scope=row id=PAGENAME | <kbd>{<nowiki/>{PAGENAME}}</kbd> | ! scope=row id=PAGENAME | <kbd>{<nowiki/>{PAGENAME}}</kbd> | ||
| {{PAGENAME}} | | {{PAGENAME}} | ||
− | | Title line excluding [[ | + | | Title line excluding [[Wikipedia:Namespace|namespace]]. |
|- | |- | ||
! scope=row id=BASEPAGENAME | <kbd>{<nowiki/>{BASEPAGENAME}}</kbd> | ! scope=row id=BASEPAGENAME | <kbd>{<nowiki/>{BASEPAGENAME}}</kbd> | ||
Line 149: | Line 152: | ||
! scope=row id=SHORTDESC | <kbd>{<nowiki/>{SHORTDESC}}</kbd> | ! scope=row id=SHORTDESC | <kbd>{<nowiki/>{SHORTDESC}}</kbd> | ||
| <!-- do not invoke this magic word here: shows nothing and places page in error-tracking category --> | | <!-- do not invoke this magic word here: shows nothing and places page in error-tracking category --> | ||
− | | Only works on the English | + | | Only works on the English Wikipedia, where it displays a short description below the article title on mobile platforms. {{crossref|printworthy=y|See [[Wikipedia:Short description]].}} |
|} | |} | ||
− | ''Note:'' The magic words above can also take a parameter, in order to parse values on a page other than the current page. A colon (<kbd>:</kbd>) is used to pass the parameter, rather than a pipe (<kbd>{{!}}</kbd>) that is used in templates, like <kbd><nowiki>{{MAGICWORD:value}}</nowiki></kbd>. For example, <kbd><nowiki>{{TALKPAGENAME: | + | ''Note:'' The magic words above can also take a parameter, in order to parse values on a page other than the current page. A colon (<kbd>:</kbd>) is used to pass the parameter, rather than a pipe (<kbd>{{!}}</kbd>) that is used in templates, like <kbd><nowiki>{{MAGICWORD:value}}</nowiki></kbd>. For example, <kbd><nowiki>{{TALKPAGENAME:Wikipedia:MOS}}</nowiki></kbd> returns <samp><nowiki>Wikipedia talk:MOS</nowiki></samp> on any page. |
''Note:'' In the "Category" and "Category talk" namespaces, to wikilink (some) page name variables may require [[help:link|prefixing a colon]] to avoid unwanted categorization. | ''Note:'' In the "Category" and "Category talk" namespaces, to wikilink (some) page name variables may require [[help:link|prefixing a colon]] to avoid unwanted categorization. | ||
Line 222: | Line 225: | ||
| {{LOCALMONTHABBREV}} | | {{LOCALMONTHABBREV}} | ||
|- | |- | ||
− | ! scope=row id=CURRENTDAY | <kbd>{<nowiki/>{CURRENTDAY}}</kbd>{{efn|<kbd><nowiki>{{CURRENTDAY}}</nowiki></kbd>, <kbd><nowiki>{{LOCALDAY}}</nowiki></kbd>and <kbd><nowiki>{{REVISIONDAY}}</nowiki></kbd>return the day ( | + | ! scope=row id=CURRENTDAY | <kbd>{<nowiki/>{CURRENTDAY}}</kbd>{{efn|<kbd><nowiki>{{CURRENTDAY}}</nowiki></kbd>, <kbd><nowiki>{{LOCALDAY}}</nowiki></kbd> and <kbd><nowiki>{{REVISIONDAY}}</nowiki></kbd> return the day (e.g. "<samp>6</samp>"), whilst <kbd><nowiki>{{CURRENTDAY2}}</nowiki></kbd>, <kbd><nowiki>{{LOCALDAY2}}</nowiki></kbd> and <kbd><nowiki>{{REVISIONDAY2}}</nowiki></kbd> return the day with zero-padding (e.g. "<samp>06</samp>"). For all two-digit days (i.e. 10 to 31), these are the same.|name=daynote}} |
| {{CURRENTDAY}} | | {{CURRENTDAY}} | ||
! scope=row id=LOCALDAY | <kbd>{<nowiki/>{LOCALDAY}}</kbd>{{efn|name=daynote}} | ! scope=row id=LOCALDAY | <kbd>{<nowiki/>{LOCALDAY}}</kbd>{{efn|name=daynote}} | ||
Line 319: | Line 322: | ||
==Parser functions== | ==Parser functions== | ||
− | {{Shortcut| | + | {{Shortcut|WP:PF|WP:PARSER}} |
{{further|mw:Help:Magic words#Parser functions|mw:Help:Extension:ParserFunctions}} | {{further|mw:Help:Magic words#Parser functions|mw:Help:Extension:ParserFunctions}} | ||
Line 328: | Line 331: | ||
|- | |- | ||
! scope=row id=PAGEID | <kbd>{<nowiki/>{PAGEID}}</kbd> | ! scope=row id=PAGEID | <kbd>{<nowiki/>{PAGEID}}</kbd> | ||
− | | Unique page identifier number (for example, this page's ID is < | + | | Unique page identifier number (for example, this page's ID is <samp>{{PAGEID}}</samp>). |
|- | |- | ||
! scope=row id=PAGESIZE | <kbd>{<nowiki/>{PAGESIZE:''fullpagename''}}</kbd> | ! scope=row id=PAGESIZE | <kbd>{<nowiki/>{PAGESIZE:''fullpagename''}}</kbd> | ||
− | | Size of named page in bytes (for example, this page is < | + | | Size of named page in bytes (for example, this page is <samp>{{PAGESIZE:{{FULLPAGENAME}}}}</samp> bytes). |
|- | |- | ||
! scope=row id=PROTECTIONLEVEL | <kbd>{<nowiki/>{PROTECTIONLEVEL:''action''{{pipe}}''fullpagename''}}</kbd> | ! scope=row id=PROTECTIONLEVEL | <kbd>{<nowiki/>{PROTECTIONLEVEL:''action''{{pipe}}''fullpagename''}}</kbd> | ||
− | | [[ | + | | [[Wikipedia:Protection policy|Protection level]] assigned to ''action'' ("edit", "move", etc.) on named page (this page's protection level for "edit" is <kbd>{{PROTECTIONLEVEL:edit|Help:Magic words}}</kbd>). |
|- | |- | ||
! scope=row id=PROTECTIONEXPIRY | <kbd>{<nowiki/>{PROTECTIONEXPIRY:''action''{{pipe}}''fullpagename''}}</kbd> | ! scope=row id=PROTECTIONEXPIRY | <kbd>{<nowiki/>{PROTECTIONEXPIRY:''action''{{pipe}}''fullpagename''}}</kbd> | ||
− | | [[ | + | | [[Wikipedia:Protection policy|Protection expiry]] assigned to ''action'' ("edit", "move", etc.) on named page (this page's protection expiry is <kbd>{{PROTECTIONEXPIRY:edit|Help:Magic words}}</kbd>). |
|- | |- | ||
! scope=row id=PENDINGCHANGELEVEL | <kbd>{<nowiki/>{PENDINGCHANGELEVEL:''fullpagename''}}</kbd> | ! scope=row id=PENDINGCHANGELEVEL | <kbd>{<nowiki/>{PENDINGCHANGELEVEL:''fullpagename''}}</kbd> | ||
− | | Protection level for [[ | + | | Protection level for [[WP:PC|pending changes]] on the named page (this page, which doesn't have one, is <kbd>{{PENDINGCHANGELEVEL}}</kbd>). |
|- | |- | ||
! scope=row id=PAGESINCATEGORY | <kbd>{<nowiki/>{PAGESINCATEGORY:''categoryname''}}</kbd> | ! scope=row id=PAGESINCATEGORY | <kbd>{<nowiki/>{PAGESINCATEGORY:''categoryname''}}</kbd> | ||
Line 346: | Line 349: | ||
|- | |- | ||
! scope=row id=NUMBERINGROUP | <kbd>{<nowiki/>{NUMBERINGROUP:''groupname''}}</kbd> | ! scope=row id=NUMBERINGROUP | <kbd>{<nowiki/>{NUMBERINGROUP:''groupname''}}</kbd> | ||
− | | Number of users in the [[ | + | | Number of users in the [[Wikipedia:User access levels|user group]] named ''groupname''. |
|} | |} | ||
Page IDs can be associated with articles via wikilinks (i.e. <code>[[Special:Redirect/page/3235121]]</code>goes to this page). | Page IDs can be associated with articles via wikilinks (i.e. <code>[[Special:Redirect/page/3235121]]</code>goes to this page). | ||
Line 382: | Line 385: | ||
|- | |- | ||
! scope=row id=mwtime | <kbd>{<nowiki/>{#time:''format''{{pipe}}''object''}}</kbd><br/><kbd>{<nowiki/>{#timel:''format''{{pipe}}''object''}}<br><br>{<nowiki/>{#time:d F Y{{pipe}}''date''{{pipe}}''langcode''}}</kbd> | ! scope=row id=mwtime | <kbd>{<nowiki/>{#time:''format''{{pipe}}''object''}}</kbd><br/><kbd>{<nowiki/>{#timel:''format''{{pipe}}''object''}}<br><br>{<nowiki/>{#time:d F Y{{pipe}}''date''{{pipe}}''langcode''}}</kbd> | ||
− | | Used to format dates and times, for ISO format, dots or English month names. <kbd>#timel</kbd> is based on local time as defined for each wiki; for English | + | | Used to format dates and times, for ISO format, dots or English month names. <kbd>#timel</kbd> is based on local time as defined for each wiki; for English Wikipedia, this is identical to <kbd>#time</kbd>.<br />The optional 3rd parameter is the output language code (French, German, Swedish: fr, de, sv, etc.). Example Finnish: <kbd><nowiki>{{#time:d F Y|June 30, 2016|fi}}</nowiki></kbd> shows: {{#time:d F Y|June 30, 2016|fi}} (June). ISO to German: <kbd><nowiki>{{#time:d. M Y|1987-10-31|de}}</nowiki></kbd> shows: {{#time:d. M Y|1987-10-31|de}}.<br />For format codes, see: [[mw:Help:Extension:ParserFunctions##time]]. Use the format <kbd><nowiki>{{#time: H:i, j F Y (e)|...}}</nowiki></kbd> to match the format used by timestamps in signatures. |
|- | |- | ||
! scope=row id=gender | <kbd>{<nowiki/>{gender:''user''{{pipe}}''m_out''{{pipe}}''f_out''{{pipe}}''u_out''}}</kbd> | ! scope=row id=gender | <kbd>{<nowiki/>{gender:''user''{{pipe}}''m_out''{{pipe}}''f_out''{{pipe}}''u_out''}}</kbd> | ||
| Outputs ''m_out'', ''f_out'' or ''u_out'' according to whether the gender specified in ''user''{{thinsp}}'s preferences is, respectively, male, female or unspecified. Other parameter permutations are available, see [[mw:Help:Magic words#gender]] and [[translatewiki:Special:MyLanguage/Gender|translatewiki:Gender]]. | | Outputs ''m_out'', ''f_out'' or ''u_out'' according to whether the gender specified in ''user''{{thinsp}}'s preferences is, respectively, male, female or unspecified. Other parameter permutations are available, see [[mw:Help:Magic words#gender]] and [[translatewiki:Special:MyLanguage/Gender|translatewiki:Gender]]. | ||
|- | |- | ||
− | ! scope=row id=mwtag | <kbd>[[mw:Help:Magic words#Miscellaneous|{<nowiki/>{#tag:'' | + | ! scope=row id=mwtag | <kbd>[[mw:Help:Magic words#Miscellaneous|{<nowiki/>{#tag:''tagname''{{pipe}}''content with magic''}}]]</kbd> |
− | | Only way to [[eval]]uate magic words ''inside a tag'', in order to generate <code><'' | + | | Only way to [[eval]]uate magic words ''inside a tag'', in order to generate <code><''tagname''>''magic''</''tagname''></code>. Also handles tag attributes. Details at [[mw:Help:Magic words#tag]]. |
|} | |} | ||
Line 397: | Line 400: | ||
|- | |- | ||
! scope=row id=localurl | <kbd>{<nowiki/>{localurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ! scope=row id=localurl | <kbd>{<nowiki/>{localurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ||
− | | Relative [[ | + | | Relative [[Path (computing)|path]] to page name. The ''query'' parameter is optional. |
|- | |- | ||
! scope=row id=fullurl | <kbd>{<nowiki/>{fullurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ! scope=row id=fullurl | <kbd>{<nowiki/>{fullurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ||
− | | Absolute path, without [[ | + | | Absolute path, without [[Application layer|protocol prefix]] (i.e. without "{{thinsp}}<nowiki>http:</nowiki>{{thinsp}}" etc.), to page name. The ''query'' parameter is optional. |
|- | |- | ||
! scope=row id=canonicalurl | <kbd>{<nowiki/>{canonicalurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ! scope=row id=canonicalurl | <kbd>{<nowiki/>{canonicalurl:''fullpagename'' {{pipe}}''query''}}</kbd> | ||
Line 409: | Line 412: | ||
|- | |- | ||
! scope=row id=urlencode | <kbd>{<nowiki/>{urlencode:''string''}}</kbd> | ! scope=row id=urlencode | <kbd>{<nowiki/>{urlencode:''string''}}</kbd> | ||
− | | [[ | + | | [[WP:ENCODE|Encodes]] ''string'' for use in URL query strings; <kbd>{{braces|urlencode:test string}}</kbd>, for example, produces: {{urlencode:test string}}. To encode ''string'' for use in URL paths or MediaWiki page names, append, respectively, {{para||PATH}} or {{para||WIKI}} (to produce "{{urlencode:test string|PATH}}" or "{{urlencode:test string|WIKI}}"). |
|- | |- | ||
! scope=row id=anchorencode | <kbd>{<nowiki/>{anchorencode:''string''}}</kbd> | ! scope=row id=anchorencode | <kbd>{<nowiki/>{anchorencode:''string''}}</kbd> | ||
Line 415: | Line 418: | ||
|- | |- | ||
! scope=row id=ns | <kbd>{<nowiki/>{ns:''n''}}</kbd> | ! scope=row id=ns | <kbd>{<nowiki/>{ns:''n''}}</kbd> | ||
− | | Returns the name of the [[ | + | | Returns the name of the [[wp:Namespace|namespace]] whose index is the number ''n''. For MediaWiki URLs, use <kbd>{<nowiki/>{nse:}}</kbd>. |
|- | |- | ||
! scope=row id=rel2abs | <kbd>[[mw:Help:Extension:ParserFunctions##rel2abs|{<nowiki/>{#rel2abs:''path''}}]] </kbd> | ! scope=row id=rel2abs | <kbd>[[mw:Help:Extension:ParserFunctions##rel2abs|{<nowiki/>{#rel2abs:''path''}}]] </kbd> | ||
Line 425: | Line 428: | ||
===Conditional=== | ===Conditional=== | ||
− | {{further| | + | {{further|Help:Conditional expressions}} |
{| class="wikitable plainrowheaders" | {| class="wikitable plainrowheaders" | ||
Line 432: | Line 435: | ||
|- | |- | ||
! scope=row id=expr |<kbd>[[mw:Help:Extension:Parser functions##expr|{<nowiki/>{#expr:''expression''}}]] </kbd> | ! scope=row id=expr |<kbd>[[mw:Help:Extension:Parser functions##expr|{<nowiki/>{#expr:''expression''}}]] </kbd> | ||
− | | Evaluates ''expression'' (see [[ | + | | Evaluates ''expression'' (see [[m:Help:Calculation]]). |
|- | |- | ||
! scope=row id=if | <kbd>[[mw:Help:Extension:Parser functions##if|{<nowiki/>{#if:''string'' {{pipe}}''result1'' {{pipe}}''result2''}}]] </kbd> | ! scope=row id=if | <kbd>[[mw:Help:Extension:Parser functions##if|{<nowiki/>{#if:''string'' {{pipe}}''result1'' {{pipe}}''result2''}}]] </kbd> | ||
− | | Outputs ''result2'' if ''string'' is [[ | + | | Outputs ''result2'' if ''string'' is [[Empty string|empty]], otherwise outputs ''result1''. |
|- | |- | ||
! scope=row id=ifeq | <kbd>[[mw:Help:Extension:Parser functions##ifeq|{<nowiki/>{#ifeq:''string1''{{pipe}}''string2'' {{pipe}}''result1'' {{pipe}}''result2''}}]] </kbd> | ! scope=row id=ifeq | <kbd>[[mw:Help:Extension:Parser functions##ifeq|{<nowiki/>{#ifeq:''string1''{{pipe}}''string2'' {{pipe}}''result1'' {{pipe}}''result2''}}]] </kbd> | ||
Line 453: | Line 456: | ||
|} | |} | ||
− | If, in these conditional functions, [[ | + | If, in these conditional functions, [[Empty string|empty]] unnamed parameters are to be parsed as empty rather than as text (i.e. as empty rather than as the text "{{{1}}}", "{{{2}}}", etc.), they will require trailing pipes (i.e. <kbd>{{(((}}1{{pipe}}{{)))}}</kbd>, <kbd>{{(((}}2{{pipe}}{{)))}}</kbd>, etc., rather than <kbd>{{(((}}1{{)))}}</kbd>, <kbd>{{(((}}2{{)))}}</kbd>, etc.). |
− | * For the use of these functions in tables, see [[ | + | * For the use of these functions in tables, see [[Help:Conditional tables]]. |
===Other=== | ===Other=== | ||
Line 460: | Line 463: | ||
! scope=col | Function | ! scope=col | Function | ||
! scope=col | Description | ! scope=col | Description | ||
+ | |- | ||
+ | ! scope=row id=babel | <kbd>[[mw:Extension:Babel#Usage|{<nowiki/>{#babel:''code1''|''code2''|...}}]]</kbd> | ||
+ | | Render [[Wikipedia:Userboxes|userboxes]] telling your language skills. Improves upon {{tl|Babel}} (an alternative). | ||
|- | |- | ||
! scope=row id=categorytree | <kbd>[[mw:Extension:CategoryTree|{<nowiki/>{#categorytree:''category''|...}}]]</kbd> | ! scope=row id=categorytree | <kbd>[[mw:Extension:CategoryTree|{<nowiki/>{#categorytree:''category''|...}}]]</kbd> | ||
| List pages in a category, recursively. | | List pages in a category, recursively. | ||
+ | |- | ||
+ | ! scope=row | <kbd>[[mw:Extension:GeoData#Parser function|{<nowiki/>{#coordinates:''arg1''|''arg2''|...}}]]</kbd> | ||
+ | | Save the [[Geographic coordinate system|GeoData coordinates]] of the subject to the page's database. Used in {{tl|coord}}. | ||
|- | |- | ||
! scope=row style=white-space:nowrap | <kbd>[[mw:Extension:Scribunto#Usage|{<nowiki/>{#invoke:''module''|''function''|''arg1''|...}}]]</kbd> | ! scope=row style=white-space:nowrap | <kbd>[[mw:Extension:Scribunto#Usage|{<nowiki/>{#invoke:''module''|''function''|''arg1''|...}}]]</kbd> | ||
− | || Use [[mw:Extension:Scribunto|Scribunto]] to transclude a [[ | + | || Use [[mw:Extension:Scribunto|Scribunto]] to transclude a [[Wikipedia:Lua|lua]] template, e.g. function ''replace'' in [[Module:String#replace|module ''String'']]. |
+ | |- | ||
+ | ! scope=row id=language | <kbd>[[mw:Help:Magic words#Miscellaneous|{<nowiki/>{#language]]:[[ISO 639|''code1''|''code2''}}]]</kbd> | ||
+ | | Print the name represented by the language code, e.g. '''en''' → '''English'''. Print in language 2 if given, e.g. <kbd><nowiki>{{#language:en|zh}}</nowiki></kbd> prints {{#language:en|zh}} | ||
|- | |- | ||
! scope=row id=lst | <kbd>[[mw:Extension:Labeled Section Transclusion|<nowiki>{{#lst:}}, {{#lsth:}}, {{#lstx:}}</nowiki>]]</kbd> | ! scope=row id=lst | <kbd>[[mw:Extension:Labeled Section Transclusion|<nowiki>{{#lst:}}, {{#lsth:}}, {{#lstx:}}</nowiki>]]</kbd> | ||
| Three ways to [[Help:Labeled section transclusion|transclude a section of a page]]. | | Three ways to [[Help:Labeled section transclusion|transclude a section of a page]]. | ||
+ | |- | ||
+ | ! scope=row id=mentor | <kbd>[[Wikipedia:Growth Team features|<nowiki>{{#mentor:Username}}</nowiki>]]</kbd> | ||
+ | | Display the currently assigned mentor for target Username, if set. | ||
+ | |- | ||
+ | ! scope=row id=property | <kbd>[[m:Wikidata/Notes/Inclusion syntax v0.4|{<nowiki/>{#property:''arg1''|''arg2''|...}}]]</kbd> | ||
+ | | Include a [[d:Help:FAQ#Terminology|property]] ([[Wikipedia:Wikidata|Wikidata]]) from a named entity, instead of the default on the page. | ||
|- | |- | ||
! scope=row id=related | <kbd>[[mw:Reading/Web/Projects/Read more|{<nowiki/>{#related:...}}]]</kbd> | ! scope=row id=related | <kbd>[[mw:Reading/Web/Projects/Read more|{<nowiki/>{#related:...}}]]</kbd> | ||
Line 475: | Line 493: | ||
! scope=row id=section | <kbd>[[Help:Labeled section transclusion|{<nowiki/>{#section:}}, {<nowiki/>{#section-h:}}, {<nowiki/>{#section-x:}}]]</kbd> | ! scope=row id=section | <kbd>[[Help:Labeled section transclusion|{<nowiki/>{#section:}}, {<nowiki/>{#section-h:}}, {<nowiki/>{#section-x:}}]]</kbd> | ||
| Aliases for <kbd><nowiki>{{#lst:}}, {{#lsth}}, {{#lstx}}</nowiki></kbd> (above). | | Aliases for <kbd><nowiki>{{#lst:}}, {{#lsth}}, {{#lstx}}</nowiki></kbd> (above). | ||
+ | |- | ||
+ | ! scope=row id=statements | <kbd>[[d:Wikidata:How to use data on Wikimedia projects|{<nowiki/>{#statements:''arg1''|...}}]]</kbd> | ||
+ | | Display the value of any statement (Wikidata) included in an item. | ||
|- | |- | ||
! scope=row id=target | <kbd>[[mw:Help:Extension:MassMessage#Parser function delivery lists|{<nowiki/>{#target:''fullpagename''}}]]</kbd> | ! scope=row id=target | <kbd>[[mw:Help:Extension:MassMessage#Parser function delivery lists|{<nowiki/>{#target:''fullpagename''}}]]</kbd> | ||
− | | Send a message to a list of talk pages on the fullpagename, using the [[ | + | | Send a message to a list of talk pages on the fullpagename, using the [[m:MassMessage|MassMessage function]]. |
|- | |- | ||
! scope=row id=int | <kbd>[[mw:Help:Magic words#Localization|{<nowiki/>{int:''pagename''}}]] </kbd> | ! scope=row id=int | <kbd>[[mw:Help:Magic words#Localization|{<nowiki/>{int:''pagename''}}]] </kbd> | ||
− | | [[ | + | | [[Wikipedia:Transclusion|Transclude]] an ''interface'' message, i.e. a [[Special:PrefixIndex/MediaWiki:|pagename in MediaWiki namespace]] |
|- | |- | ||
! scope=row id=bang | <kbd>[[mw:Help:Magic_words#Other|{<nowiki/>{!}}]] </kbd> | ! scope=row id=bang | <kbd>[[mw:Help:Magic_words#Other|{<nowiki/>{!}}]] </kbd> | ||
Line 493: | Line 514: | ||
* [[mw:Manual:Extending wiki markup]] | * [[mw:Manual:Extending wiki markup]] | ||
* [https://phabricator.wikimedia.org/diffusion/MW/history/master/includes/parser/CoreParserFunctions.php CoreParserFunctions.php] | * [https://phabricator.wikimedia.org/diffusion/MW/history/master/includes/parser/CoreParserFunctions.php CoreParserFunctions.php] | ||
+ | * [[w:User:Cacycle/wikEd|wikEd]], a MediaWiki editor with syntax highlighting for templates and parser functions | ||
+ | * {{myprefs|Gadgets|Editing|check=Syntax highlighter}} | ||
+ | * {{myprefs|Beta features|check=Wiki syntax highlighting}} | ||
* [[Special:Version]], see last section "Parser function hooks":<!--(a #section link is not possible)-->a list that should include all of the magic words on this page | * [[Special:Version]], see last section "Parser function hooks":<!--(a #section link is not possible)-->a list that should include all of the magic words on this page | ||
* {{tl|Ifexist not redirect}}, works with the <code><nowiki>{{#ifexist:}}</nowiki></code> expression while allowing redirects to be identified and parsed differently | * {{tl|Ifexist not redirect}}, works with the <code><nowiki>{{#ifexist:}}</nowiki></code> expression while allowing redirects to be identified and parsed differently | ||
[[Category:BattleTechWiki features]] | [[Category:BattleTechWiki features]] |
Revision as of 18:31, 12 January 2024
This help page is a how-to guide. It details processes or procedures of some aspect(s) of BattleTechWiki's norms and practices. It is not one of BattleTechWiki's policies or guidelines, and may reflect varying levels of consensus and vetting. |
Magic words (including parser functions, variables and behavior switches) are features of wiki markup that give instructions to BattleTechWiki's underlying MediaWiki software. For example, magic words can suppress or position the table of contents, disable indexing by external search engines, and produce output dynamically based on the current page or on user-defined conditional logic. Some of these features are especially useful for templates.
This page is a quick reference for magic words. For more information, refer to the main MediaWiki documentation:
- mw:Help:Magic words: All standard magic words, including the "standard" parser functions.
- mw:Help:Extension:ParserFunctions: Additional parser functions, including conditional expressions.
Contents
General information
In general, there are three types of magic words.
- Behavior switches: often appear in double underscores, all uppercase, e.g.,
__NOTOC__
. They will change the behavior of a page, rather than return a value. - Parser functions: all in lowercase. A parser function will be followed by colon and pipe-separated parameters, e.g.,
{{#ifexpr:Y|Yes|No}}
, wrapped in double braces. They will take a value and return a value. - Variables: these are all uppercase, e.g.,
{{PAGENAME}}
. A variable will be wrapped in double braces and will return a value in its place.
The software generally interprets magic words in the following way:
- Magic words are case sensitive.
- White space is generously allowed for readability. It will be stripped from the start and end of their keywords and parameters (as is also done in template calls using named parameters).
- They can be transcluded, even variables "about the current page". This is ensured by the parsing order.
- Instead of magically transforming into HTML instructions,
<nowiki>
tags remove this magic so a magic word can itself be displayed (documented), e.g.<nowiki>{{#magic:}}</nowiki>
or{{#magic:<nowiki/>}}
.
Magic words compared to templates:
- As with templates, magic words can be transcluded and substituted.
- The names of magic words are purposely chosen to be unlike the names of templates, and vice versa. Many parser function names will begin with a
#
(pound or hash), but template names will not start with a#
, and probably not end in a:
(colon), or be all-uppercase. - The first parameter's syntax differs. In
{{#magic: p1 | p2 | p3}}
, the name is#magic
and it is followed by an unspaced:
and a required input parameter,p1
. With a template,p1
is optional and it is preceded by a|
(pipe) instead of a:
, e.g.{{template|p1}}
.
Most magic words can be used in any needed locations on a page; see MOS:ORDER for guidance on where to place magic words that are behavior switches.
Behavior switches
Switch | Description |
---|---|
__TOC__ | Places the page's table of contents (TOC) at the word's position. This magic word does not work in skins that present the table of contents outside the article content e.g. the default Vector 2022 skin. |
__FORCETOC__ | Forces the TOC to appear in its default position, even when there are fewer than four headings. Can be used anywhere on a page. This magic word does not work in skins that present the table of contents outside the article content e.g. the default Vector 2022 skin. |
__NOTOC__ | Suppresses the appearance of the page's TOC. Can be used anywhere on a page. |
__NOEDITSECTION__ | Hides the "edit" links normally beside all headings on the page. To hide the edit link beside a particular heading, specify the heading using e.g. an HTML tag such as <h2>heading</h2> rather than with the usual wiki equals-signs syntax (e.g. == heading == ).
|
__ARCHIVEDTALK__ | Hides the "Reply" button |
__NEWSECTIONLINK__ | On non-talk pages, adds a "⧼vector-action-addsection⧽" link as a means to add a new section to the page. |
__NONEWSECTIONLINK__ | Removes the "⧼vector-action-addsection⧽" link (the add-new-section link) on talk pages. |
__NOGALLERY__ | Replaces thumbnails on a category page with normal links. |
__HIDDENCAT__ | Makes a category hidden when included on that category's page. |
__INDEX__ | Instructs search engines to index the page. |
__NOINDEX__ | Instructs search engines not to index the page. See Wikipedia:Controlling search engine indexing. |
__STATICREDIRECT__ | Prevents the link on a redirection page from being updated automatically when the page to which it redirects is moved (and "Update any redirects that point to the original title" is selected). |
__DISAMBIG__ | Marks a page as a disambiguation page, adds it to Special:DisambiguationPages and places inward links in Special:DisambiguationPageLinks. (See mw:Extension:Disambiguator.) |
{{DISPLAYTITLE:title}} | Used to amend the displayed form of the page's title. |
{{DEFAULTSORT:sortkey}} | Sets the default key (the index) under which the page is categorised. Functionality is documented at Help:Category § Default sort key, and guidelines are at Wikipedia:Categorization § Sort keys. |
{{NOEXTERNALLANGLINKS}} | (equivalent to {{NOEXTERNALLANGLINKS|*}} ) Suppresses the automated inclusion of Wikidata interlanguage links on the lefthand side of the page. Links to particular rather than all languages may be suppressed by using {{NOEXTERNALLANGLINKS|list}}, where list a pipe-delimited list of language codes (e.g. {{NOEXTERNALLANGLINKS|fr|es|ja}} to suppress the French ("fr"), Spanish ("es") and Japanese ("ja") interlanguage links). |
Variables
Page name variable | Output | Description |
---|---|---|
{{FULLPAGENAME}} | Help:Magic words | Canonical page name. Title line. Title unless letter-case is altered with {{DISPLAYTITLE}} .
|
{{PAGENAME}} | Magic words | Title line excluding namespace. |
{{BASEPAGENAME}} | Magic words | Title of parent page, excluding namespace. |
{{ROOTPAGENAME}} | Magic words | Title of topmost parent (before all subpages), excluding namespace. |
{{SUBPAGENAME}} | Magic words | On a subpage, rightmost portion of current title; higher subpagenames show as backlinks. |
{{ARTICLEPAGENAME}} | Help:Magic words | Title of the subject page associated with the current page. These are useful on talk pages (but see note about Category talk pages). |
{{SUBJECTPAGENAME}} | Help:Magic words | |
{{TALKPAGENAME}} | Help talk:Magic words | Title of the talk page associated with the current page. Useful on subject pages. |
{{NAMESPACENUMBER}} | 12 | Number of the current page's namespace. |
{{NAMESPACE}} | Help | Namespace of the title. |
{{ARTICLESPACE}} | Help | On a talk page, the namespace part of the title of the associated subject page. |
{{SUBJECTSPACE}} | Help | |
{{TALKSPACE}} | Help talk | Namespace of the talk page associated with the current page. |
{{FULLPAGENAMEE}},
{{PAGENAMEE}}, (etc.) |
Help:Magic_words,
Magic_words, (etc.) |
Adding an E to the end of the above variables, renders the above encoded for use in MediaWiki URLs (i.e. with underscores replacing spaces). |
{{SHORTDESC}} | Only works on the English Wikipedia, where it displays a short description below the article title on mobile platforms. |
Note: The magic words above can also take a parameter, in order to parse values on a page other than the current page. A colon (:) is used to pass the parameter, rather than a pipe (|) that is used in templates, like {{MAGICWORD:value}}. For example, {{TALKPAGENAME:Wikipedia:MOS}} returns Wikipedia talk:MOS on any page.
Note: In the "Category" and "Category talk" namespaces, to wikilink (some) page name variables may require prefixing a colon to avoid unwanted categorization.
Site variable | Output | Description |
---|---|---|
{{SITENAME}} | BattleTechWiki | Site name ($wgSitename). |
{{SERVER}} | https://www.sarna.net | Domain URL ($wgServer). |
{{SERVERNAME}} | www.sarna.net | Subdomain and domain name. |
{{ARTICLEPATH}} | /wiki/$1 | Relative article path ($wgArticlePath). |
{{SCRIPTPATH}} | /wiki | Relative script path ($wgScriptPath). |
{{STYLEPATH}} | https://cfw.sarna.net/wiki/skins | Relative style path ($wgStylePath). |
{{CURRENTVERSION}} | 1.34.4 | Returns current MediaWiki version. |
Other variables by type
Universal time | Local-website time | ||
---|---|---|---|
Variable | Output | Variable | Output |
{{CURRENTYEAR}} | 2024 | {{LOCALYEAR}} | 2024 |
{{CURRENTMONTH}} | 05 | {{LOCALMONTH}} | 05 |
{{CURRENTMONTHNAME}} | May | {{LOCALMONTHNAME}} | May |
{{CURRENTMONTHABBREV}} | May | {{LOCALMONTHABBREV}} | May |
{{CURRENTDAY}}[lower-alpha 1] | 30 | {{LOCALDAY}}[lower-alpha 1] | 30 |
{{CURRENTDAY2}}[lower-alpha 1] | 30 | {{LOCALDAY2}}[lower-alpha 1] | 30 |
{{CURRENTDOW}} | 4 | {{LOCALDOW}} | 4 |
{{CURRENTDAYNAME}} | Thursday | {{LOCALDAYNAME}} | Thursday |
{{CURRENTTIME}} | 12:41 | {{LOCALTIME}} | 08:41 |
{{CURRENTHOUR}} | 12 | {{LOCALHOUR}} | 08 |
{{CURRENTWEEK}} | 22 | {{LOCALWEEK}} | 22 |
{{CURRENTTIMESTAMP}}[lower-alpha 2] | 20240530124119 | {{LOCALTIMESTAMP}}[lower-alpha 2] | 20240530084119 |
Variable | Output |
---|---|
{{REVISIONDAY}}[lower-alpha 1] | 12 |
{{REVISIONDAY2}}[lower-alpha 1] | 12 |
{{REVISIONMONTH}} | 01 |
{{REVISIONYEAR}} | 2024 |
{{REVISIONTIMESTAMP}}[lower-alpha 2] | 20240112183124 |
{{REVISIONUSER}}[lower-alpha 3] | Deadfire |
- ↑ 1.0 1.1 1.2 1.3 1.4 1.5 {{CURRENTDAY}}, {{LOCALDAY}} and {{REVISIONDAY}} return the day (e.g. "6"), whilst {{CURRENTDAY2}}, {{LOCALDAY2}} and {{REVISIONDAY2}} return the day with zero-padding (e.g. "06"). For all two-digit days (i.e. 10 to 31), these are the same.
- ↑ 2.0 2.1 2.2 These timestamp outputs can be formatted with {{Format revisiontimestamp}} (aka {{FRTS}}). For example, {{FRTS|{{REVISIONTIMESTAMP}}}} turns "20240112183124" into "2024-01-12 18:31:24".
- ↑ This shows the last user to edit the page. There is no way to show the user viewing the page with magic words due to technical restrictions.
{{NUMBEROFPAGES}} | 134,910 |
---|---|
{{NUMBEROFARTICLES}} | 55,668 |
{{NUMBEROFFILES}} | 20,779 |
{{NUMBEROFEDITS}} | 1,072,773 |
{{NUMBEROFUSERS}} | 13,837 |
{{NUMBEROFADMINS}} | 11 |
{{NUMBEROFACTIVEUSERS}} | 72 |
Parser functions
Metadata
Function | Description |
---|---|
{{PAGEID}} | Unique page identifier number (for example, this page's ID is 152385). |
{{PAGESIZE:fullpagename}} | Size of named page in bytes (for example, this page is 33,271 bytes). |
{{PROTECTIONLEVEL:action|fullpagename}} | Protection level assigned to action ("edit", "move", etc.) on named page (this page's protection level for "edit" is ). |
{{PROTECTIONEXPIRY:action|fullpagename}} | Protection expiry assigned to action ("edit", "move", etc.) on named page (this page's protection expiry is infinity). |
{{PENDINGCHANGELEVEL:fullpagename}} | Protection level for pending changes on the named page (this page, which doesn't have one, is Template:PENDINGCHANGELEVEL). |
{{PAGESINCATEGORY:categoryname}} | Number of pages in the category named categoryname. Each subcategory is counted as one item. |
{{NUMBERINGROUP:groupname}} | Number of users in the user group named groupname. |
Page IDs can be associated with articles via wikilinks (i.e. Special:Redirect/page/3235121
goes to this page).
To output numbers without comma separators (for example, as "123456789" rather than "123,456,789"), append the parameter |R.
Formatting
Function | Description |
---|---|
{{lc:string}} | Converts all characters in string to lower case. |
{{lcfirst:string}} | Converts first character of string to lower case. |
{{uc:string}} | Converts all characters in string to upper case. |
{{ucfirst:string}} | Converts first character of string to upper case. |
{{formatnum:unformatted_number}} {{formatnum:formatted_num |R}} |
R}} (i.e. {{formatnum:7,654,321|R}}, for example, produces 7654321). |
{{#dateformat:date|format}} {{#formatdate:date|format}} |
Formats a date according to user preferences; a default can be given as an optional case-sensitive second parameter for users without date preference; can convert a date from an existing format to any of dmy , mdy , ymd , or ISO 8601 formats, with the user's preference overriding the specified format.
|
{{padleft:xyz|stringlength}} {{padright:xyz|stringlength}} {{padleft:xyz|length|padstr}} {{padright:xyz|length|padstr}} |
Pad with zeroes '0' to the right or left, to fill the given length; an alternative padding string can be given as a third parameter; the repeated padding string (padstr) will be truncated if its length does not evenly divide the required number of characters. |
{{plural:N|singular|plural}} | Outputs singular if N is equal to 1, otherwise outputs plural. See the documentation at mediawiki.org for more details. |
{{#time:format|object}} {{#timel:format|object}} {{#time:d F Y|date|langcode}} |
Used to format dates and times, for ISO format, dots or English month names. #timel is based on local time as defined for each wiki; for English Wikipedia, this is identical to #time. The optional 3rd parameter is the output language code (French, German, Swedish: fr, de, sv, etc.). Example Finnish: {{#time:d F Y|June 30, 2016|fi}} shows: 30 kesäkuu 2016 (June). ISO to German: {{#time:d. M Y|1987-10-31|de}} shows: 31. Okt. 1987. For format codes, see: mw:Help:Extension:ParserFunctions##time. Use the format {{#time: H:i, j F Y (e)|...}} to match the format used by timestamps in signatures. |
{{gender:user|m_out|f_out|u_out}} | Outputs m_out, f_out or u_out according to whether the gender specified in user 's preferences is, respectively, male, female or unspecified. Other parameter permutations are available, see mw:Help:Magic words#gender and translatewiki:Gender. |
{{#tag:tagname|content with magic}} | Only way to evaluate magic words inside a tag, in order to generate <tagname>magic</tagname> . Also handles tag attributes. Details at mw:Help:Magic words#tag.
|
Paths
Function | Description |
---|---|
{{localurl:fullpagename |query}} | Relative path to page name. The query parameter is optional. |
{{fullurl:fullpagename |query}} | Absolute path, without protocol prefix (i.e. without " http: " etc.), to page name. The query parameter is optional. |
{{canonicalurl:fullpagename |query}} | Absolute path, including protocol prefix, to page name. The query parameter is optional. |
{{filepath:filename}} | Absolute path to the media file filename. |
{{urlencode:string}} | Encodes string for use in URL query strings; {{urlencode:test string}}, for example, produces: test+string. To encode string for use in URL paths or MediaWiki page names, append, respectively, |PATH or |WIKI (to produce "test%20string" or "test_string").
|
{{anchorencode:string}} | Input encoded for use in MediaWiki URL section anchors. |
{{ns:n}} | Returns the name of the namespace whose index is the number n. For MediaWiki URLs, use {{nse:}}. |
{{#rel2abs:path}} | Converts a relative file path to an absolute path. |
{{#titleparts:fullpagename|number|first segment}} | Splits the fullpagename (title) into that number of segments. |
Conditional
Function | Description |
---|---|
{{#expr:expression}} | Evaluates expression (see m:Help:Calculation). |
{{#if:string |result1 |result2}} | Outputs result2 if string is empty, otherwise outputs result1. |
{{#ifeq:string1|string2 |result1 |result2}} | Outputs result1 if string1 and string2 are equal (alphabetically or numerically), otherwise outputs result2. |
{{#iferror:test_string |result1 |result2}} | Outputs result1 if test_string generates a parsing error, otherwise outputs result2. |
{{#ifexpr:expression |result1 |result2}} | Outputs result1 if expression is true, otherwise outputs result2. |
{{#ifexist:pagetitle |result1 |result2}} | Outputs result1 if the page [[pagetitle]] exists, otherwise outputs result2. Note that underscores are needed for spaces in namespaces. |
{{#switch:string |c1=r1 |c2=r2 ... |default}} | Outputs r1 if string is c1, r2 if string is c2, etc., otherwise outputs default (if provided). |
If, in these conditional functions, empty unnamed parameters are to be parsed as empty rather than as text (i.e. as empty rather than as the text "{{{1}}}", "{{{2}}}", etc.), they will require trailing pipes (i.e. {{{1|}}}, {{{2|}}}, etc., rather than {{{1}}}, {{{2}}}, etc.).
- For the use of these functions in tables, see Help:Conditional tables.
Other
Function | Description |
---|---|
{{#babel:code1|code2|...}} | Render userboxes telling your language skills. Improves upon {{Babel}} (an alternative). |
{{#categorytree:category|...}} | List pages in a category, recursively. |
{{#coordinates:arg1|arg2|...}} | Save the GeoData coordinates of the subject to the page's database. Used in {{coord}}. |
{{#invoke:module|function|arg1|...}} | Use Scribunto to transclude a lua template, e.g. function replace in module String. |
{{#language:code1|code2}} | Print the name represented by the language code, e.g. en → English. Print in language 2 if given, e.g. {{#language:en|zh}} prints English |
{{#lst:}}, {{#lsth:}}, {{#lstx:}} | Three ways to transclude a section of a page. |
{{#mentor:Username}} | Display the currently assigned mentor for target Username, if set. |
{{#property:arg1|arg2|...}} | Include a property (Wikidata) from a named entity, instead of the default on the page. |
{{#related:...}} | Links to similar topics, to engage readers. (Beta feature.) |
{{#section:}}, {{#section-h:}}, {{#section-x:}} | Aliases for {{#lst:}}, {{#lsth}}, {{#lstx}} (above). |
{{#statements:arg1|...}} | Display the value of any statement (Wikidata) included in an item. |
{{#target:fullpagename}} | Send a message to a list of talk pages on the fullpagename, using the MassMessage function. |
{{int:pagename}} | Transclude an interface message, i.e. a pagename in MediaWiki namespace |
{{!}} | Used to include a pipe character as part of a template argument or table cell contents. Before this was added as a magic word, many wikis implemented this by creating Template:! with | as the content.
|
{{=}} | Used to include an equal sign as part of a template argument or table cell contents. Before this was added as a magic word, many wikis implemented this by creating Template:= with = as the content.
|
See also
- mw:Localisation
- mw:Manual:Extending wiki markup
- CoreParserFunctions.php
- wikEd, a MediaWiki editor with syntax highlighting for templates and parser functions
- Preferences → Gadgets → Editing → Syntax highlighter
- Preferences → Beta features → Wiki syntax highlighting
- Special:Version, see last section "Parser function hooks":a list that should include all of the magic words on this page
- {{Ifexist not redirect}}, works with the
{{#ifexist:}}
expression while allowing redirects to be identified and parsed differently