Magic words

Revision as of 12:20, 2 September 2013 by Gerald Chi (talk | contribs) (Gerald Chi moved page Magic Words to Magic words without leaving a redirect)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Editor-In-Chief: C. Michael Gibson, M.S., M.D. [1]

Overview

This is an organized index of Magic words used in MediaWiki. "XYZ" indicates user input, which is used in the example.

Table of contents

For details see Help:Section

Template:H:TOC variables

Other

Word Explanation
__NOEDITSECTION__ Hides the edit links beside headings.
__NEWSECTIONLINK__ [MW1.7+] Gives a "+"-link next to the edit-tab to make a new section on a non-talk page.
__NOCONTENTCONVERT__
__NOCC__
Don't perform the content language conversion (character and phase) in article display; for example, Chinese zh with zh_cn, zh_tw, zh_sg, zh_hk.
__NOGALLERY__ [MW1.7+] This magic word allows images in category pages to be displayed as inline links instead of gallery.
__NOTITLECONVERT__
__NOTC__
Like __NOCC__ but affecting article title only.
__END__ Allows for trailing whitespace to be included in the page save (does not seem to work anymore).
__START__ This magic word has no effect but an ID in MagicWord.php (MAG_START).


XML-style tags

nowiki: <nowiki>...</nowiki>, disables expansion/interpretation of templates, link syntax, formatting syntax, etc.:<nowiki>'''[[{{tc}}]]'''</nowiki> gives '''[[{{tc}}]]'''

noinclude: <noinclude>...</noinclude>, specifies text to appear or function calls to apply only on the transcluded page, not on the transcluding page. E.g. categorizing of a template itself (and not the transcluding page) would use this tag.

includeonly: <includeonly>...</includeonly>, specifies text to appear or function calls to apply only on the transcluding page, not on the transcluded page (which usually is a template). E.g. a template which categorizes pages where it's applied, but not the template itself, into a certain category.

onlyinclude: <onlyinclude>...</onlyinclude>, specifies text to appear or function calls to apply only on the transcluding page, not on the transcluded page. This tag is distinguished from the <includeonly> tag in that text or code on the transcluded page not enveloped by the tag will not be transcluded, whether or not the <noinclude> tag is in use.

pre: <pre>...</pre>, ditto, also for multiple lines; it is rendered with a new paragraph at the start and end: a<pre>'''[[{{tc}}]]'''</pre> gives a

'''[[{{tc}}]]'''

math: <math>...</math>, e.g. <math>\sqrt{a^2+b^2}</math> gives <math>\sqrt{a^2+b^2}</math>; see Help:Displaying a formula hiero: <hiero>...</hiero>, e.g. <hiero>A1</hiero> gives: <hiero>A1</hiero>

categorytree: <categorytree>...</categorytree> provides a dynamic view of the category structure specified as a tree.

Time

The time in UTC. Note that if the page was displayed by the same user and has not changed (has not been edited) since the last time it was displayed, it is possible that the page may be cached (by the user's browser) and the displayed time or date may not change. Also, if a heavily used page, rather than freshly rendered by the software each time it is generated, is instead being retrieved from a caching system (such as the main page on Wikipedia) the date or time may not change from the last time the page was originally retrieved by the caching hardware or software.

Word Example Explanation
{{CURRENTDAY}} 26 Displays the current day in numeric form.
{{CURRENTDAY2}} 26 [MW1.6+] Same as {{CURRENTDAY}}, but with leading zero (01 .. 31).
{{CURRENTDAYNAME}} Thursday Name of the day in the language of the project or English.
{{CURRENTDOW}} 4 Same as {{CURRENTDAYNAME}}, but as a number (0=Sunday, 1=Monday...).
{{CURRENTMONTH}} 12 The number 01 .. 12 of the month.
{{CURRENTMONTHABBREV}} Dec [MW1.5+] Same as {{CURRENTMONTH}}, but in abbreviated form (Jan .. Dec).
{{CURRENTMONTHNAME}} December Same as {{CURRENTMONTH}}, but in named form (January .. December).
{{CURRENTTIME}} 19:59 The current time (00:00 .. 23:59).
{{CURRENTHOUR}} 19 The current hour (00 .. 23).
{{CURRENTMINUTE}} Template:CURRENTMINUTE The current minute (00 .. 59).
{{CURRENTSECOND}} Template:CURRENTSECOND The current second (00 .. 59).
{{CURRENTWEEK}} 52 Number of the current week (1-53) according to ISO 8601 with no leading zero.
{{CURRENTYEAR}} 2024 Returns the current year.
{{CURRENTTIMESTAMP}} 20241226195926 [MW1.7+] ISO 8601 time stamp.

Local time

The time depending on the local timezone of the wiki (not depending on the timezone in the user's preference settings). (All words [MW1.8+] )

Word Example Explanation
{{LOCALDAY}} 26 Displays the local day of the month in numeric form.
{{LOCALDAY2}} 26 Same as {{LOCALDAY}}, but with a leading zero (01 .. 31).
{{LOCALDAYNAME}} Thursday Name of the day in the language of the project or English.
{{LOCALDOW}} 4 Same as {{LOCALDAYNAME}}, but as a number (0=Sunday, 1=Monday...).
{{LOCALMONTH}} 12 The number 01 .. 12 of the month.
{{LOCALMONTHABBREV}} Dec Same as {{LOCALMONTH}}, but in abbreviated form as Jan .. Dec.
{{LOCALMONTHNAME}} December Same as {{LOCALMONTH}}, but in named form as January .. December.
{{LOCALTIME}} 19:59 The local time (00:00 .. 23:59).
{{LOCALHOUR}} 19 The local hour (00 .. 23).
{{LOCALWEEK}} 52 Number of the local week (1-53) according to ISO 8601 with no leading zero.
{{LOCALYEAR}} 2024 Returns the local year.
{{LOCALTIMESTAMP}} 20241226195926 ISO 8601 time stamp.

Statistics

Statistics variables give thousands separators unless ":R" for "raw" is added (actually, these versions are parser functions).

Word Example Explanation
{{CURRENTVERSION}} 1.42.3 [MW1.7+] Template:H:mwg [2]
{{NUMBEROFEDITS}}
{{NUMBEROFEDITS:R}}
1,736,106
1736106
[MW1.10+ (r21319)] Returns the total number of page edits since MediaWiki, the software that runs this site, was installed.
{{NUMBEROFARTICLES}}
{{NUMBEROFARTICLES:R}}
140,997
140997
A variable which returns the total number of articles on the Wiki.
{{NUMBEROFPAGES}}
{{NUMBEROFPAGES:R}}
304,241
304241
[MW1.7+] Returns the total number of pages. [3]
{{NUMBEROFFILES}}
{{NUMBEROFFILES:R}}
74,541
74541
[MW1.5+] Returns the number of uploaded files (rows in the image table).
{{NUMBEROFUSERS}}
{{NUMBEROFUSERS:R}}
9,541
9541
[MW1.7+] Returns the number of registered users (rows in the user table).
{{NUMBEROFADMINS}}
{{NUMBEROFADMINS:R}}
98
98
[MW1.7+] Returns the number of administrators (users in the sysop group).
{{PAGESINNAMESPACE}}  disabled here Longer alias of PAGESINNS
{{PAGESINNS:ns}}
{{PAGESINNS:ns:R}}
{{PAGESINNS:2}} 
{{PAGESINNS:2:R}} 
disabled here
[MW1.7+] Returns the number of pages in the given namespace. Disabled by default, enable with Template:H:mwg.

Page names and related info

Parser functions

Not working at the position of the page where the tag is located but on the page header, and throughout the page, respectively (see below):

  • DISPLAYTITLE: allow the page header to be different from the page name.
  • DEFAULTSORT: Sets a default category sort key for the page.

Formatting

Word Example Explanation
{{#language:}} {{#language:da}} = dansk [MW1.7+] Native name of language code.
{{lc:}} {{lc:AbC dEf}} = abc def [MW1.5+] LowerCase
{{lcfirst:}} {{lcfirst:Ab Cd}} = ab Cd [MW1.5+] LC first char.
{{uc:}} {{uc:aBc DeF}} = ABC DEF [MW1.5+] UpperCase
{{ucfirst:}} {{ucfirst:aB cD}} = AB cD [MW1.5+] UC first char.
{{formatnum:}} {{formatnum:-299792458.56789}} = −299,792,458.56789 [MW1.7+] Add decimal separators according to the wiki's default locale. Leading minus and plus are recognized.
{{padleft:}}




{{padright:}}

{{padleft:7|3|0}} = 007

{{padleft:0|3|0}} = 000 (bug)

{{padleft:bcd|6|a}} = aaabcd
{{padleft:café|8|-}} = ----café(<==Bug effect)
{{padleft:cafe|8|-}} = ----cafe

{{padleft:bcd|6|{{!}}}} = |||bcd

{{padright:bcd|6|a}} = bcdaaa
{{padright:0|6|a}} = 0aaaaa (bug)


First case is, for example, applicable to years in a category... giving an ordered year to sort by pipetricks order, or any such ordering where left extended zeros allow a proper sorting.

[MW1.8+] Pads a string with a character to the specified width. Note that there's a little bug that interprets non-US-ASCII characters as two, instead of one character (see the difference in café and cafe in the examples.)

It does not seem possible to use padleft and padright for padding with characters with a multi-character code, such as &nbsp;, which would be useful with padleft for sorting tables with Javascript.

Padding "0" does not work, it returns the same. This seems to be a bug.[1]

With regard to #language and Template:Tim, see also:

Image modifiers

These are image modifiers used in [[Image:title.ext|modifier|...|modifier]] links. Some are mutually exclusive, and then the last specified wins.

Size

The last unrecognized modifier is used as caption for framed images or together with thumbnails. It's also used as description alt=text.

Word Usage Explanation
framed
frame
enframed
[[Image:Mediawiki.png|framed]] Places an image in a frame with a description. Uses original size and stubbornly ignores width parameter if given.
In general, far better to use thumb, as is only suitable for small images.
border [[Image:Mediawiki.png|border]] Shows a 1px border around the image.
thumbnail
thumb
[[Image:Mediawiki.png|thumbnail]] Modifies image size, sets it dependent on user's favorite thumbnail size in one's preferences, or on the given width parameter (see below).
thumb=xyz [[Image:Mediawiki.png|thumb=Wiki.png]] Manualthumb: instead of displaying an automatically-sized thumbnail for Mediawiki.png, display the image Wiki.png.
width px
100x200px
[[Image:Mediawiki.png|40px]]
[[Image:Mediawiki.png|100x200px]]
Scales image to given width  in pixels
Scales image to no more than 100 pixels wide and no more than 200 high, but image scaled to retain its true aspect ratio within the boundary specified.

Position

For details see Help:Images and other uploaded files

The positions are mutually exclusive; the last specified wins. Template:- can stop floating. For inline images only modifier px (see above) is supported.

Word Usage Explanation
right [[Image:Mediawiki.png|right]] Modifies position, floats the image to the right.
left [[Image:Mediawiki.png|left]] Modifies position, floats the image to the left.
none [[Image:Mediawiki.png|none]] Explicitly states that the image should not float.
center
centre
[[Image:Mediawiki.png|center]] Modifies position, like none but centered.

Miscellany

Word Example Explanation
{{DISPLAYTITLE:xyz}} [MW 1.7+] Set the page's title [4], enabled in Wikimedia projects since June 2007 ([5]). Also see Template:H:mwg.
{{DIRMARK}}
{{DIRECTIONMARK}}

[MW1.7+] u+200E left to right or u+200D right to left mark
{{CONTENTLANGUAGE}} en [MW1.7+] code of the site's default interface language (Template:H:mwg)
{{DEFAULTSORT:xyz}} {{DEFAULTSORT:xyz}} [MW1.10+] Sets a default category sort key for the whole current page (also applying for category tags before this tag)[2].
#REDIRECT #REDIRECT [[target]]
at top of source page
Creates a redirect to another page.

Notes and references

  1. Function pad in includes/CoreParserFunctions.php puts, oddly, the $string itself as a condition for the padding. To be reported as bug.
  2. "Technology report", en-Wikipedia Signpost, January 2007

Template modifiers

Word Usage Explanation
{{subst:}} {{subst:XYZ}} Substitutes the template call with the content of the template.
{{msg:}} {{msg:XYZ}} If a template clashes with a magic word, use of the msg: modifier will use the template instead of the magic word. Otherwise, the magic word is used.
{{msgnw:}} {{msgnw:XYZ}} The template message is pasted as unevaluated <nowiki> text.
{{INT:}} {{INT:XYZ}} If a template clashes with a MediaWiki:message, use of the INT: modifier will use the message instead of the template. Otherwise, the template is used.


Template:WikiDoc Sources