View source for Help:MediaWiki namespace

{{Short description|MediaWiki: prefix, such as MediaWiki:Noarticletext}}
{{redirect|Wikipedia:MediaWiki|information about the entire MediaWiki software application|MediaWiki}}
{{Information page|WP:MWN|WP:MEDIAWIKI|WP:INTERFACE}}
{{namespaces}}
The '''MediaWiki namespace''' is a [[Wikipedia:Namespace|namespace]] containing system messages, the text to be displayed in certain places in the interface. Only [[Wikipedia:Administrators|administrators]], [[Wikipedia:Interface administrators|interface administrators]] and [[m:interface editors|interface editors]] can edit pages in this namespace. In addition, pages in this namespace ending with <code>.css</code> or <code>.js</code> are furthermore restricted to interface administrators and interface editors. However, all editors can propose changes on appropriate talk pages.

== Overview ==
The MediaWiki namespace allows administrators and interface editors to [[m:Help:System message|customise or translate the MediaWiki web interface]].

{{Caution|text= Some messages ''must'' have HTML links, and others ''must'' have wikilinks.  To find out which is which, you must know where the message is used in the interface.}}

Because the changes to these pages have a global effect, they are [[WP:PROT|protected]] from editing, and '''only administrators and interface editors have the ability to edit them'''.<ref>By default, all messages are protected. This is necessary for a number of reasons:

* Many messages are in plain HTML, so users could insert malicious scripts
* Vandalism of some messages would be extremely disruptive; for example, changes to the text of the links in the sidebar would immediately be visible to all users
* A few messages can in theory cause the software to stop working if they are changed. In practice the software ignores the database contents for the changed page, taking the regular expression straight out of the message files, for performance and stability reasons.

If an administrator wishes to allow non-administrators to edit a MediaWiki page, a method is to place the message on a template, and then transclude the template back onto the MediaWiki page. Another method is to redirect the page to one in a non-MediaWiki namespace.</ref>  Non-admins who would like to request a minor change can do so by using the {{tlx|editprotected}} template on the talk page of the MediaWiki page. More substantive changes should be discussed at an appropriate section of the [[Wikipedia:Village pump]]; an edit request should then be made if there is [[WP:Consensus|consensus]] for the change.

Changes that can benefit other wiki sites and are not specific to Wikipedia can be submitted to [[translatewiki.net]] (also known as TWN, formerly known as BetaWiki). See [[translatewiki:Translating:MediaWiki]]. Since English is the original language of the messages, changes to them cannot be directly edited in translatewiki.net, and have to be discussed in the [[translatewiki:Support|support page there]].

MediaWiki pages can not and should not have documentation on the page itself for several reasons: among other things &lt;noinclude> tags usually do not function in this namespace and the amount of data in MediaWiki space needs to be kept low for performance reasons. Instead, a description of the message can be put at the top of the talk page. A template {{tl|interface explanation}} is available for this. Pages using this template can be found in [[:Category:MediaWiki messages with interface explanation]].

Some messages have old documentation available by setting the 'language' to <kbd>qqq</kbd>. For instance, [[MediaWiki:Login]] has old, and somewhat incorrect, documentation at [[MediaWiki:Login/qqq]]. Don't update the /qqq messages, instead update the top of the talk page.

The message names for a particular interface element can be found using the "Add a toolbox link to reload the current page with the system message names exposed" Advanced Gadget in the [[Special:Preferences#mw-prefsection-gadgets|Special:Preferences]]. Once enabled a "message names" item appears in the tool box, when clicked the names of all items are displayed.

==Overview of messages==
{{See|Wikipedia:Software notices}}
The template {{tl|MediaWiki messages}} (shown below) lists a selection of key messages. Not included are

* [[WP:Abusefilter|Edit filter]] warnings, as there are many of these, and they can be found [[Special:PrefixIndex/MediaWiki:Abusefilter-|here]].
* [[Wikipedia:tags|Tags]] added automatically to [[help:edit summary|edit summaries]] by [[wp:edit filter|edit filters]], which are listed at [[Special:Tags]].
* Messages describing Preferences options (<kbd>Mediawiki:Tog-</kbd>) – [{{fullurl:Special:AllMessages|prefix=tog-}} search for these].
* Messages providing [[tooltip]]s (<kbd>Mediawiki:Tooltip-</kbd>) – [{{fullurl:Special:AllMessages|prefix=tooltip-}} search for these].
* Messages relating to [[WP:Cite.php|Cite.php]] are listed and discussed at [[Help talk:Cite errors]].
* [[MediaWiki:Uploadtext]] and related subpages (the subpages transclude pages from <kbd>Wikipedia:</kbd> space) – these are covered at [[Wikipedia talk:Upload]].
* [[CSS]] files, which are described at [[MediaWiki talk:Common.css]].
* [[Wikipedia:Gadget|Gadget]]-related messages – [[Special:PrefixIndex/MediaWiki:Gadget|Gadgets]].

The template {{tl|interface explanation}}, used on <kbd>MediaWiki talk:</kbd> pages (generally those with some discussion), adds pages it is on into [[:Category:MediaWiki messages with interface explanation]].

A complete list of messages is available at [[Special:Allmessages]]. MediaWiki messages serving the software default are called "unmodified" and appear as red links in the Allmessages list, and do not appear in a [https://en.wikipedia.org/w/index.php?title=Special:PrefixIndex&prefix=&namespace=8 Prefix-based search] as they don't technically exist as pages. Because [[Special:Allmessages]] displays '''all''' system messages and it's contents (the page is over 1 MB) some users might prefer to view these messages alphabetically:
[{{fullurl:Special:Allpages|from=MediaWiki:%21}} @] [[Special:Prefixindex/MediaWiki:A|A]] [[Special:Prefixindex/MediaWiki:B|B]] [[Special:Prefixindex/MediaWiki:C|C]] [[Special:Prefixindex/MediaWiki:D|D]] [[Special:Prefixindex/MediaWiki:E|E]] [[Special:Prefixindex/MediaWiki:F|F]] [[Special:Prefixindex/MediaWiki:G|G]] [[Special:Prefixindex/MediaWiki:H|H]] [[Special:Prefixindex/MediaWiki:I|<small> </small>I<small> </small>]] [[Special:Prefixindex/MediaWiki:J|J]] [[Special:Prefixindex/MediaWiki:K|K]] [[Special:Prefixindex/MediaWiki:L|L]] [[Special:Prefixindex/MediaWiki:M|M]] [[Special:Prefixindex/MediaWiki:N|N]] [[Special:Prefixindex/MediaWiki:O|O]] [[Special:Prefixindex/MediaWiki:P|P]] [[Special:Prefixindex/MediaWiki:Q|Q]] [[Special:Prefixindex/MediaWiki:R|R]] [[Special:Prefixindex/MediaWiki:S|S]] [[Special:Prefixindex/MediaWiki:T|T]] [[Special:Prefixindex/MediaWiki:U|U]] [[Special:Prefixindex/MediaWiki:V|V]] [[Special:Prefixindex/MediaWiki:W|W]] [[Special:Prefixindex/MediaWiki:X|X]] [[Special:Prefixindex/MediaWiki:Y|Y]] [[Special:Prefixindex/MediaWiki:Z|Z]]

For a list of '''all''' MediaWiki pages, see [[Special:Prefixindex/MediaWiki:]], or [https://en.wikipedia.org/w/index.php?title=Special%3ASearch&redirs=1&ns8=1 search the MediaWiki namespace]. This includes custom titleblacklist notices, or edit filter notices and other pages that is not part of standard MediaWiki messages.

{{MediaWiki messages|state=expanded}}

==Finding system messages==
{{Shortcut|WP:QQX}}
You can find a message key by browsing Wikipedia in the special pseudo-language code <code>'''qqx'''</code>, which can be done by appending <code>?[[:mw:uselang|uselang]]=qqx</code>to the URL, or <code>&uselang=qqx</code> if the URL already contains a <code>?</code> character ([{{fullurl:{{FULLPAGENAME}}|uselang=qqx}} example]). All the messages will then be replaced by their message keys, so you can identify which message is responsible. Messages that are always in the content language will not be shown using qqx. [[Special:Preferences#mw-prefsection-gadgets]] has the option "Add a toolbox link to reload the current page with the system message names exposed". This gadget uses the same qqx you can add manually.

When the URL includes a fragment that links to a particular point on the page such as a section or a tab like e.g. [[Special:Preferences#mw-prefsection-rendering|special page "Preferences"]] you will have to add the fragment after the uselang parameter, e.g. <code>Special:Preferences?uselang=qqx#mw-prefsection-rendering</code>.

Message keys which depend on data sent by the user may not be shown when qqx is used. [{{SERVER}}{{SCRIPTPATH}}/api.php?action=query&meta=allmessages&amlang=en Allmessages from the API] lists around 26,000 messages. They can be searched for a string with {{keypress|Ctrl|F}} in many browsers. Note that the underlying wikitext is often shown and not only the rendered text.

A list of all messages can be seen at [[Special:AllMessages]].

==Technical details==
The MediaWiki namespace is a mechanism allowing administrators to [[m:Help:System message|customise or translate the MediaWiki web interface]]. It is enabled by default in recent mediawiki versions, [[mw:Manual:$wgUseDatabaseMessages]] = true enables them.  The contents of the MediaWiki namespace pages override any corresponding settings in the language files, i.e., the static version of messages. Using the MediaWiki namespace is a bit slower than other namespaces.

The namespace number of {{ns:8}} messages is '''8''', with a corresponding {{ns:9}} namespace '''9''' to discuss individual messages.
Some projects offer templates like {{tiw|en|editprotected}} to propose modifications, others have a page like
[[m:Meta:Requests for help from a sysop or bureaucrat|Meta:Requests for help from a sysop or bureaucrat]] for this purpose.

;Links to MediaWiki messages work like links to ordinary pages, examples:
:<kbd><nowiki>[[MediaWiki:Edit]]</nowiki></kbd> [[MediaWiki:Edit]],
:<kbd><nowiki>[[w:de:MediaWiki:Edit]]</nowiki></kbd> [[w:de:MediaWiki:Edit]],
:<kbd><nowiki>[{{fullurl:m:MediaWiki:Edit|action=render}} demo]</nowiki></kbd> [{{fullurl:m:MediaWiki:Edit|action=render}} demo].

Each message in the [[gerrit:g/mediawiki/core/+/refs/heads/master/languages/i18n/en.json|<code>i18n/en.json</code>]] file corresponds to a page in the MediaWiki namespace. For example, there is a line in the JSON file:
<syntaxhighlight lang="json">
"recentchanges": "Recent changes",
</syntaxhighlight>

This corresponds to the page [[MediaWiki:Recentchanges]], and {{evaldemo|int:Recentchanges}}. When this page is edited the new message is automatically used for the recent changes link in the left pane of the desktop site. Similarly [[w:fr:MediaWiki:Recentchanges]] has the content <em>Modifications récentes</em>, note that the page name itself is not translated.

===Transclusion===
[[WP:TRANS|Transclusion]] of MediaWiki messages can make sense, as noted below historically these messages also covered the function of templates.
*{{evaldemo|MediaWiki:Edit|&#61;}}, see {{tim|Ed}}.
*{{evaldemo|int:Edit|&#61;}}, [[Help:colon function|colon function]] '''int:''' is a shorthand for '''MediaWiki:'''.
*{{evaldemo|int:Example|&#61;}}, but only as far as the message exists.
*{{evaldemo|MediaWiki:Example|&#61;}} doesn't exist.

The difference between {{tlc|MediaWiki:}} and {{tlc|int:}} is that {{tlc|MediaWiki:}} transcludes using the default language of the Wiki (i.e. English), whereas {{tlc|int:}} transcludes using the language set by the user's preferences. For example, if your user language is not set to English, the following two lines will differ:
*{{MediaWiki:articlepage}}
*{{int:articlepage}}

However many messages are not suited for transclusion, because they contain '''$1''' and similar parameters not evaluated by the
template parser, or raw [[w:Cascading Style Sheets|CSS]] and [[w:en:XHTML|XHTML]] markup not permitted on normal pages. 

==== With parameters ====
MediaWiki messages may have parameters as '''$1''', '''$2''', ... and they are variables used in the software. When transcluding it with custom changed parameters, {{tlc|int:}} transclusions would be preferred.

===Interlanguage links===
[[Help:Interwiki linking|Interlanguage link]]s in MediaWiki messages typically won't work as expected. Adding <kbd>&lt;noinclude&gt;</kbd> isn't good enough, because something has to evaluate it, as it's the case for messages [[#Inclusion|included]] like ordinary templates, but not {{clarifyme}} for messages used internally as system messages.

Instead, one can use in-page interlanguage links on the talk pages, {{tim|ilm}} does this for some major projects.

== History ==

The MediaWiki namespace was introduced on December 6, 2003. Before this time, user interface text was part of the PHP software and could only be changed by software developers. Since the introduction they have been editable by normal administrators.

Until June 2004, the MediaWiki namespace was also used for creating other boilerplate text messages, to be used in articles. This function was replaced with the [[Wikipedia:Template namespace|Template namespace]]; a conversion script running as "{{u|Template namespace initialisation script}}" was run by developer [[User:Tim Starling|Tim Starling]], which moved all non-system messages to the new namespace, and replaced MediaWiki: (via the {{Magic word|msg:}} magic word) references in articles with Template: in order to bypass the redirects. In October and November 2005, these redirects were deleted. This background explains why the concept now known as "templates" is sometimes referred to as "messages".

For a short time, before the renaming from votes for deletion (VfD) to [[Wikipedia:articles for deletion|articles for deletion]] (AfD), deletion debates used MediaWiki: messages named in the format "MediaWiki:VfD-''articlename''".  These were moved to the Template: space in June 2004 and are now (as of January 2006) subpages of [[Wikipedia:Articles for deletion]] or [[Wikipedia:Votes for deletion]].

==See also==
*[[m:Help:MediaWiki namespace/old|MediaWiki namespace in version 1.2.6]]
*[[Template:MediaWiki interface message]]
*[[Wikipedia:WikiProject Usability/MediaWiki]]
*[[MediaWiki talk:Sitenotice]] - creating sitenotices
*[[Wikipedia:Bug reports and feature requests]] - on filing a "bug" to get the MediaWiki software fixed or enhanced. See also [[WP:DevMemo]].
*[[Wikipedia:Template limits]]
*[[WP:Tools]] / [https://wiki.toolserver.org/view/Category:Tools_by_tags Tools by tags] - externally hosted tools which complement the MediaWiki software

==Notes==
{{reflist}}

==External links==
* [http://www.mediawiki.org www.mediawiki.org].
{{Wikipedia technical help|collapsed}}
{{CSS and JS MediaWiki messages|style=}}
[[Category:MediaWiki Help]]
[[Category:Wikipedia features]]