Ahenket: Nieuwe pagina aangemaakt met '{{redirect|WP:MAGIC|help on the automatic transformation of wikitext|Help:Magic|the WikiProject on stage magic and illusions|Wikipedia:WikiProject Magic}} {{Shortcu...'

2013-07-17T10:08:39Z

Nieuwe pagina aangemaakt met '{{redirect|WP:MAGIC|help on the automatic transformation of wikitext|Help:Magic|the WikiProject on stage magic and illusions|Wikipedia:WikiProject Magic}} {{Shortcu...'

Nieuwe pagina

{{redirect|WP:MAGIC|help on the automatic transformation of wikitext|Help:Magic|the WikiProject on stage magic and illusions|Wikipedia:WikiProject Magic}}
{{Shortcut|H:MW|WP:MAGIC}}

'''Magic words''' (which include '''parser functions''', '''variables''' and '''behavior switches''') are features of [[Help:Wiki markup|wiki markup]] that enable various instructions to be given to the [[Help:MediaWiki namespace|MediaWiki]] software. For example, the magic words may be used to suppress or position the table of contents, or to produce other variable outputs, as is often required in [[WP:Templates|templates]].

A quick reference for magic words can be found on this page. For more complete documentation, see the following pages on the MediaWiki site:
*'''[[mw:Help:Magic words]]''' for all standard magic words, including the "standard" parser functions
*'''[[mw:Help:Extension:ParserFunctions]]''' for some additional parser functions, including conditional expressions

==General information==
There are three types of magic words:
:#'''Behavior switches''': uppercase words surrounded by double underscores, e.g., <tt><nowiki>__NOTOC__</nowiki></tt> or other keywords using parser function syntax
:#'''Variables''': uppercase words surrounded by double braces (thus resembling [[Help:Template|templates]]), e.g., <tt><nowiki>{{PAGENAME}}</nowiki></tt>
:#'''Parser functions''': keywords in double braces with parameters after a colon (some beginning with #), e.g., <tt><nowiki>{{#expr:2+2}}</nowiki></tt>

Some magic words are [[case sensitivity|case-insensitive]], but not all. [[Whitespace character|White space]] is stripped from the start and end of keywords and parameters, as in template syntax.

Page-dependent magic words will affect or return data about the ''current'' page, even if the word is added through a [[WP:Transclusion|transcluded]] template or included system message.

It is possible to [[Help:Substitution|substitute]] parser functions and most variables in the same way that templates are substituted (using the <tt>subst:</tt> keyword). This causes their current value (as evaluated at the time of substitution) to be written into the wikitext.

==Behavior switches==
{{hatnote|For documentation, see the [[mw:Help:Magic words#Behavior switches|Behavior switches]] section of the MediaWiki page, unless otherwise stated.}}
*<code><nowiki>__NOTOC__</nowiki></code> (can appear anywhere in the wikitext; suppresses the table of contents)
*<code><nowiki>__FORCETOC__</nowiki></code> (can appear anywhere in the wikitext; makes a table of contents appear in its normal position above the first heading)
*<code><nowiki>__TOC__</nowiki></code> (places a table of contents at the word's position)

*<code><nowiki>__NOEDITSECTION__</nowiki></code> (hides the section "edit" links beside all headings on the page) (use <nowiki><h2></nowiki> tags to hide the edit link for one heading only)
*<code><nowiki>__NEWSECTIONLINK__</nowiki></code> (adds a "+" link for adding a new section on a non-"Talk" page)
*<code><nowiki>__NONEWSECTIONLINK__</nowiki></code> (removes the "+" link on "Talk" pages)

*<code><nowiki>__NOGALLERY__</nowiki></code> (on a category page, replaces thumbnails with normal links)
*<code><nowiki>__HIDDENCAT__</nowiki></code> (on a category page, makes it a [[WP:HIDDENCAT|hidden category]])
*<code><nowiki>__INDEX__</nowiki></code> (tells search engines to index the page)
*<code><nowiki>__NOINDEX__</nowiki></code> (tells search engines not to index the page)
*<code><nowiki>__STATICREDIRECT__</nowiki></code> (On redirect pages, don't allow MediaWiki to automatically update the link when someone moves a page and checks "Update any redirects that point to the original title", also used to tell interwikibots that this redirect might be seen as an article)
*<code><nowiki>__DISAMBIG__</nowiki></code> (marks a page as a [[WP:DAB|disambiguation page]] and places it in [[Special:DisambiguationPages]], and places inward links in [[Special:DisambiguationPageLinks]]). See [[mw:Extension:Disambiguator]].

*<code><nowiki>{{DISPLAYTITLE:</nowiki>''title''<nowiki>}}</nowiki></code> (changes the [[WP:DISPLAYTITLE|displayed form]] of the page title)
*<code><nowiki>{{DEFAULTSORT:</nowiki>''sortkey''<nowiki>}}</nowiki></code> (sets a default category [[WP:SORTKEY|sort key]])

*<code><nowiki>{{noexternallanglinks}}</nowiki></code> to suppress all [[Wikidata:Help:Linking Wikipedia pages|Wikidata]] automatic [[Help:Interlanguage links|interlanguage links]]. Equivalent to <code><nowiki>{{noexternallanglinks:*}}</nowiki></code>. Links for individual languages can be suppressed by specifying language codes in a pipe-separated list, e.g. <code><nowiki>{{noexternallanglinks:fr|es|ja}}</nowiki></code>. See [[mw:Extension:Wikibase Client#noexternallanglinks]].

==Variables==
{{hatnote|For documentation, see the [[mw:Help:Magic words#Variables|Variables]] section of the MediaWiki page.}}

* <tt><nowiki>{{FULLPAGENAME}}</nowiki></tt> ([[Help:Page name|page title]] including [[help:namespace|namespace]])
* <tt><nowiki>{{PAGENAME}}</nowiki></tt> (page title excluding namespace)
* <tt><nowiki>{{BASEPAGENAME}}</nowiki></tt> (page title excluding ''current'' [[Help:Subpages|subpage]] and namespace - effectively the parent page without the namespace)
* <tt><nowiki>{{SUBPAGENAME}}</nowiki></tt> (subpage part of title)
* <tt><nowiki>{{SUBJECTPAGENAME}}, {{ARTICLEPAGENAME}}</nowiki></tt> (associated non-talk page)
* <tt><nowiki>{{TALKPAGENAME}}</nowiki></tt> (associated talk page)
* <tt><nowiki>{{NAMESPACE}}</nowiki></tt> (namespace of current page)
* <tt><nowiki>{{SUBJECTSPACE}}, {{ARTICLESPACE}}</nowiki></tt> (associated non-talk namespace)
* <tt><nowiki>{{TALKSPACE}}</nowiki></tt> (associated talk namespace)
* <tt><nowiki>{{FULLPAGENAMEE}}, {{NAMESPACEE}}</nowiki></tt> etc. (equivalents encoded for use in MediaWiki [[URL]]s)

''Note: the previous variables can all take a parameter, to operate on a page other than the current page''.

* <tt><nowiki>{{SITENAME}}</nowiki></tt> ({{SITENAME}})
* <tt><nowiki>{{SERVER}}</nowiki></tt> ({{SERVER}})
* <tt><nowiki>{{SERVERNAME}}</nowiki></tt> ({{SERVERNAME}})
* <tt><nowiki>{{SCRIPTPATH}}</nowiki></tt> ({{SCRIPTPATH}})
* <tt><nowiki>{{CURRENTVERSION}}</nowiki></tt> (current MediaWiki version)
* <tt><nowiki>{{REVISIONID}}</nowiki></tt> (latest revision to current page—it can't be substituted and also doesn't work in preview)
* <tt><nowiki>{{REVISIONDAY}}, {{REVISIONDAY2}}, {{REVISIONMONTH}}, {{REVISIONYEAR}}, {{REVISIONTIMESTAMP}}, {{REVISIONUSER}}</nowiki></tt> (date, time, editor at last edit)

* <tt><nowiki>{{CURRENTYEAR}}, {{CURRENTMONTH}}, {{CURRENTMONTHNAME}}, {{CURRENTMONTHABBREV}}, {{CURRENTDAY}}, {{CURRENTDAY2}}, {{CURRENTDOW}}, {{CURRENTDAYNAME}}, {{CURRENTTIME}}, {{CURRENTHOUR}}, {{CURRENTWEEK}}, {{CURRENTTIMESTAMP}}</nowiki></tt> (current date/time variables)
* <tt><nowiki>{{LOCALYEAR}}</nowiki></tt> etc. (as previously, based on site's local time)

* <tt><nowiki>{{NUMBEROFPAGES}}, {{NUMBEROFARTICLES}}, {{NUMBEROFFILES}}, {{NUMBEROFEDITS}}, {{NUMBEROFVIEWS}}, {{NUMBEROFUSERS}}, {{NUMBEROFADMINS}}, {{NUMBEROFACTIVEUSERS}}</nowiki></tt> (statistics on English Wikipedia; add <tt>:R</tt> to return numbers without commas)

==Parser functions==
{{Shortcut|WP:PF}}
{{hatnote|For documentation, see the [[mw:Help:Magic words|Meta magic words page]] or the [[mw:Help:Extension:ParserFunctions|ParserFunctions Extension page]], unless otherwise stated.}}
===Metadata===
*<tt><nowiki>{{PAGEID}}</nowiki></tt> (unique page identifier number)
*<tt><nowiki>{{PAGESIZE:</nowiki>''page name''<nowiki>}}</nowiki></tt> (size of page in bytes)
*<tt><nowiki>{{PROTECTIONLEVEL:</nowiki>''action''<nowiki>}}</nowiki></tt> (protection level for given action on the current page)
*<tt><nowiki>{{PENDINGCHANGELEVEL}}</nowiki></tt> (level of [[WP:PC|pending changes]] protection on the current page)
*<tt><nowiki>{{PAGESINCATEGORY:</nowiki>''categoryname''<nowiki>}}</nowiki></tt> (number of pages in the given [[Help:Categories|category]])
*<tt><nowiki>{{NUMBERINGROUP:</nowiki>''groupname''<nowiki>}}</nowiki></tt> (number of users in a specific [[Help:User rights|group]])

Add <tt>|R</tt> to return numbers without commas.

===Formatting===
*<tt><nowiki>{{lc:</nowiki>''string''<nowiki>}}</nowiki></tt> (convert to lower case)
*<tt><nowiki>{{lcfirst:</nowiki>''string''<nowiki>}}</nowiki></tt> (convert first character to lower case)
*<tt><nowiki>{{uc:</nowiki>''string''<nowiki>}}</nowiki></tt> (convert to upper case)
*<tt><nowiki>{{ucfirst:</nowiki>''string''<nowiki>}}</nowiki></tt> (convert first character to upper case)
*<tt><nowiki>{{formatnum:</nowiki>''unformatted num''<nowiki>}}</nowiki></tt> (format a number with comma separators; add <tt><nowiki>|</nowiki>R</tt> to unformat a number)
*<tt><nowiki>{{#formatdate:</nowiki>''date''|''format''<nowiki>}}</nowiki></tt> (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 <tt>dmy</tt>, <tt>mdy</tt>, <tt>ymd</tt> or <tt>ISO 8601</tt> formats, with the user's preference overriding the specified format)
*<tt><nowiki>{{padleft:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></tt>, <tt><nowiki>{{padright:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></tt> (pad with zeros to the right or left; an alternative padding string can be given as a third parameter; the alternative padding string may be truncated if its length does not evenly divide the required number of characters)
*<tt><nowiki>{{plural:</nowiki>''n''|''is''<nowiki>|</nowiki>''are''<nowiki>}}</nowiki></tt> (produces alternative text according to whether ''n'' is greater than 1)
*<tt><nowiki>{{#time:</nowiki>''format string''|''date/time object''<nowiki>}}</nowiki></tt> (for date/time formatting; also <tt>#timel</tt> for local time. Covered at the [[mw:Help:Extension:ParserFunctions##time|extension documentation page]].)
*<tt><nowiki>{{gender:</nowiki>''username''|''masculine''|''feminine''|''neutral''}}</tt> (produces alternative text according to the gender specified by the given user in his/her preferences)
*<tt><nowiki>{{#tag:</nowiki>''tagname''|''content''|''parameter1''=''value1''|''parameter2''=''value2''}}</tt> (equivalent to an HTML tag or pair of tags; can be used for [[WP:REFNEST|nesting references]])

===Paths===
*<tt><nowiki>{{localurl:</nowiki>''page name''<nowiki>}}</nowiki></tt>, <tt><nowiki>{{localurl:</nowiki>''page name''<nowiki>|</nowiki>''query string''<nowiki>}}</nowiki></tt> (relative path to the title)
*<tt><nowiki>{{fullurl:</nowiki>''page name''<nowiki>}}</nowiki></tt>, <tt><nowiki>{{fullurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></tt> (absolute path to the title, without a protocol prefix)
*<tt><nowiki>{{canonicalurl:</nowiki>''page name''<nowiki>}}</nowiki></tt>, <tt><nowiki>{{canonicalurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></tt> (absolute path to the title, with a protocol prefix)
*<tt><nowiki>{{filepath:</nowiki>''file name''<nowiki>}}</nowiki></tt> (absolute URL to a media file)
*<tt><nowiki>{{urlencode:</nowiki>''string''<nowiki>}}</nowiki></tt> (input encoded for use in URL query strings: {{urlencode:like this}})
** <tt><nowiki>{{urlencode:</nowiki>''string''<nowiki>|PATH}}</nowiki></tt> (input encoded for use in URL paths: {{urlencode:like this|PATH}})
** <tt><nowiki>{{urlencode:</nowiki>''string''<nowiki>|WIKI}}</nowiki></tt> (input encoded for use as MediaWiki page names: {{urlencode:like this|WIKI}})
*<tt><nowiki>{{anchorencode:</nowiki>''string''<nowiki>}}</nowiki></tt> (input encoded for use in MediaWiki URL section anchors)
*<tt><nowiki>{{ns:</nowiki>''n''<nowiki>}}</nowiki></tt> (name for the [[Help:Namespace|namespace]] with index ''n''; use <tt><nowiki>{{nse:}}</nowiki></tt> for the equivalent encoded for MediaWiki URLs)
*<tt><nowiki>{{#rel2abs:</nowiki> ''path'' <nowiki>}}</nowiki></tt> (converts a relative file path to absolute; see the [[mw:Help:Extension:ParserFunctions|extension documentation]])
*<tt><nowiki>{{#titleparts:</nowiki> ''pagename'' | ''number of segments to return'' | ''first segment to return'' <nowiki>}}</nowiki></tt> (splits title into parts; see the [[mw:Help:Extension:ParserFunctions|extension documentation]])

===Conditional expressions===
{{hatnote|For documentation, see the [[mw:Help:Extension:ParserFunctions|ParserFunctions Extension page]]. Note that some parameters are optional.}}
*<tt><nowiki>{{#expr:</nowiki> ''expression'' <nowiki>}}</nowiki></tt> (evaluates the given expression; see [[Help:Calculation]])
*<tt><nowiki>{{#if:</nowiki> ''test string'' | ''value if non-empty'' | ''value if empty'' <nowiki>}}</nowiki></tt> (selects one of two values based on whether the test string is empty)
*<tt><nowiki>{{#ifeq:</nowiki> ''string 1'' <nowiki>|</nowiki> ''string 2'' <nowiki>|</nowiki> ''value if equal'' <nowiki>|</nowiki> ''value if unequal'' <nowiki>}}</nowiki></tt> (selects one of two values based on whether the test strings are equal – numerically if applicable)
*<tt><nowiki>{{#iferror:</nowiki> ''test string'' <nowiki>|</nowiki> ''value if error'' <nowiki>|</nowiki> ''value if correct'' <nowiki>}}</nowiki></tt> (selects value based on whether the test string generates a parser error)
*<tt><nowiki>{{#ifexpr:</nowiki> ''expression'' <nowiki>|</nowiki> ''value if true'' <nowiki>|</nowiki> ''value if false'' <nowiki>}}</nowiki></tt> (selects value based on evaluation of expression)
*<tt><nowiki>{{#ifexist:</nowiki> ''page title'' | ''value if exists'' | ''value if doesn't exist'' <nowiki>}}</nowiki></tt> (selects value depending on whether a page title exists)
*<tt><nowiki>{{#switch:</nowiki> ''test'' | ''case1'' = ''value for case 1'' | ... | ''default'' <nowiki>}}</nowiki></tt> (provides alternatives based on the value of the test string)

Note that with <code>#if:</code> expressions, a variable like <code><nowiki>{{{1}}}</nowiki></code> always requires a final pipe: <code><nowiki>{{{1|}}}</nowiki></code>. If it is absent, then whenever the parameter 1 is absent, instead of leaving the field blank the software will use the actual text ''<code>{{{1}}}</code>'' and the field will never be empty.

For the use of these functions in tables, see [[Wikipedia:Conditional tables|WP:Conditional tables]].

For examples and more explanation, see [[Help:Conditional expressions]] and [[Help:Switch parser function]].

===Other===
*<code><nowiki>{{#babel:</nowiki> ''babelcode1'' | ''babelcode2'' | ... <nowiki>}}</nowiki></code> (replacement for the {{tlx|babel}} template; see [[mw:Extension:Babel#Usage|Extension:Babel]])
*<code><nowiki>{{#coordinates:</nowiki> ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (see [[mw:Extension:GeoData|Extension:GeoData]])
*<code><nowiki>{{#invoke:</nowiki> ''module'' | ''function'' | ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (calls a function located in a Scribunto module; see [[Wikipedia:Lua]])
*<code><nowiki>{{#property:</nowiki> ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (see [[m:Wikidata/Notes/Inclusion syntax v0.3]])

==See also==
*[[mw:Localisation]]
*[[mw:Manual:Extending wiki markup]]
*[http://svn.wikimedia.org/viewvc/mediawiki/trunk/phase3/includes/parser/CoreParserFunctions.php?view=log CoreParserFunctions.php]
* [[User:Cacycle/wikEd|wikEd]], a MediaWiki editor with syntax highlighting for templates and parser functions

[[Category:Wikipedia features]]

[[he:עזרה:משתנים]]

Help:Magic words - Bewerkingsoverzicht

Ahenket: Nieuwe pagina aangemaakt met '{{redirect|WP:MAGIC|help on the automatic transformation of wikitext|Help:Magic|the WikiProject on stage magic and illusions|Wikipedia:WikiProject Magic}} {{Shortcu...'