Help:Namespace

From Meta, a Wikimedia project coordination wiki
(Redirected from Namespaces)
Jump to: navigation, search
MediaWiki Handbook: Contents, Readers, Editors, Moderators, System admins, Researchers +/-

Page titles in MediaWiki are composed of two parts: an optional namespace name, and the remainder of the title. For example, this page has the title Help:Namespace, so it is in the Help namespace. A title without a colon, for example Goings-on, is in the main namespace.

By default, a wiki using the MediaWiki software has 18 namespaces, including:

  • the main namespace, where page names have no prefix
  • 15 additional namespaces, each with its own prefix. (Two namespaces, the so-called 'project' namespaces, get their names from the name of the wiki project, and so differ in name from one wiki to the next; on the Wikipedia, they are called Wikipedia: and Wikipedia talk:. On each wiki, these project namespaces (whatever they may happen to be for that wiki), can be referred to by the pseudonyms "Project:" and "Project Talk:", respectively.)
  • two pseudo-namespaces

In addition to these 18 namespaces, the Wikipedia specially adds to these the Portal: and Portal talk: namespaces. Other wiki projects may have their own additional custom namespaces.

But take note:

  • Namespace prefixes should not be confused with prefixes for interwiki linking.
  • If a page title contains a colon, but the initial part of the title is not one of the pre-defined namespaces, that page is considered to be in the main namespace.

Namespace uses[edit]

Namespaces allow, among other things, a separation of content from policy and discussion. They encourage separation of the pages of a wiki into a core set intended for public viewing, and private information intended for the editing community.

The core set is the main namespace. Other namespaces that are also useful to viewers are:

  • the image namespace (with the full-size images)
  • the category namespace (for navigation)
  • the help pages and the preferences page (as far as they concern viewing)

By default, searches and the random page feature are restricted to the main namespace, thus the user interface is directed towards readers who are not part of the community. Note that this separation of community and readership is not a feature of many wiki engines. It may not be required for your editing community. You are always free to put discussion and policy in the main namespace, if you desire.

On most Wikimedia wikis, pages in the main namespace and a few other ones are actively policed by the community, with inappropriate content being quickly removed. The rules for the other namespaces are generally more relaxed.

From MediaWiki 1.5 Recent changes ditto.

  • Searching can be restricted to any subset of namespaces

User contributions can show all or be restricted to a namespace of choice.

The subpage feature can be enabled for selected namespaces.

It is possible to customize the visual appearance of pages and the appearance and function of templates based on namespace. See sections Template programming and CSS based namespace detection below.

List of namespaces[edit]

The two pseudo-namespaces, main namespace and 15 auxiliary namespaces in this project (Meta) are as follows (the variables for them are also shown).

Note that the number of pages in each namespace may not be displayed on all MediaWiki projects, because this counting feature may be disabled: on this Wiki, per-namespace page counting is currently disabled.

Variables Alternate syntax Name, linked to list of all such pages Nr. of pages
(see note above)
Notes
{{ns:-2}} {{ns:media}} "Media"   pseudo-namespace for images and other files themselves, as opposed to the image description pages; see also below
{{ns:-1}} {{ns:special}} "Special"   pseudo-namespace for special pages (list: Special:SpecialPages)
{{ns:0}} main disabled main namespace, no prefix, or optionally a colon (this is needed when using the page as template)
{{ns:1}} {{ns:talk}} Talk disabled see Help:Talk page for this and the following odd-numbered namespaces
{{ns:2}} {{ns:user}} User disabled registered users (list: Special:ListUsers) have a user homepage User:username (linked to by the system from user names in lists of edits, e.g. on page histories, and from signatures on talk pages); this and subpages of it can be used to present oneself, for project-related bookmarks, and for drafts, tests, and other working material. One can put here material to give oneself one-step access to it from any page in the same project, and one can put here links to give oneself two-step access to the link targets from any page in the same project as the user page. For users who do not log in, the same applies, with the IP as username. Dynamic IPs are a complication.
{{ns:3}} {{ns:user_talk}} User talk disabled  
{{ns:4}} {{ns:project}} Meta disabled the project namespace for matters about the project, such as guidelines and discussions; see also the [[Help:|Help:]] namespace
{{ns:5}} {{ns:project_talk}} Meta talk disabled  
{{ns:6}} {{ns:file}} File disabled images and other uploaded files, with image description pages (list: Special:ListFiles)
{{ns:7}} {{ns:file_talk}} File talk disabled  
{{ns:8}} {{ns:mediawiki}} MediaWiki disabled system messages (list: Special:AllMessages), editable by users, or if protected, by sysops
{{ns:9}} {{ns:mediawiki_talk}} MediaWiki talk disabled  
{{ns:10}} {{ns:template}} Template disabled the default namespace for templates: the wikitext code {{name }} refers to and includes the page Template:name
{{ns:11}} {{ns:template_talk}} Template talk disabled  
{{ns:12}} {{ns:help}} Help disabled typically used for the MediaWiki User's Guide, with the wikitext a frequently refreshed copy of the master version on Meta-Wikipedia, but with project-specific templates
{{ns:13}} {{ns:help_talk}} Help talk disabled  
{{ns:14}} {{ns:category}} Category disabled each page (list: Special:Categories) represents a category of pages, with each category page displaying a list of pages in that category and optional additional text.
{{ns:15}} {{ns:category_talk}} Category talk disabled  

Note that all characters of namespace prefixes are case-insensitive, so one can write, for example, "mediawiki". Also, underscores in namespace prefixes are equivalent to any non-zero number of spaces (leading or trailing spaces or underscores are ignored) : underscores are used only when encoding URLs but treated otherwise like spaces.

These names are set in the MessagesXX.php language files. The English defaults are below:

$namespaceNames = array(
    NS_MEDIA            => 'Media',
    NS_SPECIAL          => 'Special',
    NS_MAIN                => '',
    NS_TALK                => 'Talk',
    NS_USER             => 'User',
    NS_USER_TALK        => 'User_talk',
    # NS_PROJECT set by $wgMetaNamespace
    NS_PROJECT_TALK     => '$1_talk',
    NS_FILE             => 'File',
    NS_FILE_TALK        => 'File_talk',
    NS_MEDIAWIKI        => 'MediaWiki',
    NS_MEDIAWIKI_TALK   => 'MediaWiki_talk',
    NS_TEMPLATE         => 'Template',
    NS_TEMPLATE_TALK    => 'Template_talk',
    NS_HELP             => 'Help',
    NS_HELP_TALK        => 'Help_talk',
    NS_CATEGORY         => 'Category',
    NS_CATEGORY_TALK    => 'Category_talk',
);

Generic namespace names[edit]

On the column "Alternate syntax" in the table at the beginning of the previous section, a list of project-independent namespace names (also called generic namespace names) is shown in the form of {{ns:namespace name}}, the same as those on Meta and the English Wikipedia, except that "Meta" and "Wikipedia" are replaced by "Project". The prefixes are the terms listed, followed by a colon. Like any namespace name, a project-independent namespace name is case-insensitive.

The prefix "Project:" is for every project automatically converted to the project namespace, e.g. try the link Project:xyz. It is like a piped link. Therefore a page name starting with "Project:" is not possible (unless, of course, that is the name of the project).

Similarly the other project-independent namespace prefixes are also automatically converted to the project-specific ones.

An exception to the rule that the link label is the name used in the wikitext and not the converted name, applies if the target of a redirect is expressed using a project-independent namespace name: in that case the converted name is shown on the redirect page, compare [1] with the preview of [2].

Other namespace aliases[edit]

On some wikis there are also other namespace aliases (again case-insensitive):

  • on the English Wikipedia:
    • wp for Wikipedia, try e.g. w:wp:a
    • wt for Wikipedia talk, try e.g. w:wt:a

A namespace alias cannot be equal to an interwiki prefix. For example, a wiki community cannot decide to set "tt" as alias for "Template talk" as long as it wants to keep its use as interwiki prefix for the corresponding Tatar wiki, try tt:a.

See also mw:Manual:$wgNamespaceAliases.

Prefixes in various languages[edit]

For Wikimedia projects this project prefix is "Wikipedia:", "Wiktionary:", "Wikibooks:", "Wikisource:", "Wikiquote:" and "Meta:". In languages other than English, the Wikipedia project has its own prefixes: in French "Wikipédia:", in Czech "Wikipedie:", in Russian "Википедия:", in Korean "위키백과:", in Hindi "विकिपीडिया:", in Hebrew ":ויקיפדיה" and in Arabic ":ويكيبيديا". The last two are RTL languages which put the prefixes on the right. In URLs the prefixes are always on the left.

To check which prefix is used in a project, you may edit and preview a page in the project to render the variable {{ns:Project}} (and cancel the edit after the check), though what you will see is deprived of a colon. Another way: visiting any project page there, you will find it at the left (in LTR languages) or the right (in RTL languages) of the page title. This applies even for non-existing pages, so, in view of the conversion explained in the previous section, you can use a URL like http://ar.wikipedia.org/wiki/Project:A. Also you may go to a project page of a target language from a project page of a language familiar to you (e.g. en:Wikipedia:Contact us) by clicking an interlanguage link, if applicable. "Talk", "User", "Image" and combinations can also be translated in the case of non-English wikis.

Colon in page name[edit]

Adding a colon to a page name does not automatically create a new namespace. To see the namespace of a page, use {{NAMESPACE}} which returns the namespace. For this page it returns "Help". The same code would return an empty string for a page in the main namespace. Similarly, {{PAGENAME}} returns the page name without prefix. For this page it returns "Namespace". {{FULLPAGENAME}} returns both namespace and pagename; for this page, that is "Help:Namespace".

To take some examples from Wiktionary: Wiktionary:FAQ has Talk page Wiktionary talk:FAQ, but Wiktionary Appendix:Colours has Talk page Talk:Wiktionary Appendix:Colours, because the first is in the project preface namespace and the second is not. In Special:Allpages, accordingly, the first is, unlike the second, not in the list of articles, but in the page list of the namespace Wiktionary.

Special namespace[edit]

Main article: Help:Special page

The namespace "Special:" consists of "special pages", which are created by the software on demand, for example Special:Recentchanges.

Custom namespaces[edit]

For instructions on creating a custom namespace or for more information, see Help:Custom namespaces.

A project can have additional namespaces. For example, if a single project is multilingual (as opposed to the case of sister projects, each in one language) there may be a namespace Help and also a namespace Hilfe:, for help pages in the English and German language, respectively.

A list of all namespaces is in the dropdown menus of Special:Prefixindex, Special:Allpages, Special:Recentchanges, and "My contributions". With the Query extension a list including also the numbers of the namespaces is given by {{SERVER}}{{SCRIPTPATH}}/api.php?action=query&meta=siteinfo&siprop=namespaces , for this project //meta.wikimedia.org/w/api.php?action=query&meta=siteinfo&siprop=namespaces .

Custom namespaces are numbered from 100. See m:Help:MediaWiki help policy for a list of custom namespaces on Meta.

Template programming[edit]

Templates can automatically detect namespaces and thus change how they look or what they do, depending on what type of page they are used on. They can do this by using magic words such as {{NAMESPACE}} and parser functions such as {{#ifeq:}}.

The English Wikipedia has several meta-templates that make it easy to detect namespaces. Then you don't have to handle magic words and parser functions in your own template code. Or you can use them as code examples to learn how to do it. Here are two of them:

  • {{main other}} – A very easy to use one. There are several variants of this one for different needs.
  • {{namespace detect}} – The very versatile one.

If you copy these templates to another language Wikipedia or other Wikimedia project, then read the section "Copying to other projects?" in their documentation.

CSS based namespace detection[edit]

When MediaWiki renders a page it adds some CSS classes in the HTML body tag to indicate the namespace of the page. This can be used in CSS code to detect namespace. For instance for this page the body tag looks like this:

<body class="mediawiki ltr ns-12 ns-subject page-Help_Namespace skin-monobook">

The "ns-12" class indicates that this is a "Help:" page. And the "ns-subject" class indicates that this is a subject page, that is not a talk page and not a "Special:" page.

Class Description
ns--1, ns-special All "Special:" pages, see Special:SpecialPages. Note the double dashes in "ns--1".
ns-0 - ns-999 Each of the namespaces, such as ns-0 (main), ns-1 (Talk) and so on.
ns-subject Pages in all subject namespaces, that is all even namespaces. Such as ns-0 (main), ns-2 (User) and so on. Not talk pages and not "Special:" pages.
ns-talk All talk pages, that is all uneven namespaces. Such as ns-1 (Talk), ns-3 (User talk) and so on.

This can be used in CSS code to detect namespace and change looks of something or even hide it based on what type of page the object is shown on. For instance like this:

.ns-subject .somebox {   /* Green border when on subject pages. */
    border: 1px solid #00FF00;
}
.ns-talk .somebox {   /* Blue border when on talk pages. */
    border: 1px solid #0000FF;
}

The English Wikipedia uses this to change the colour of the pages based on namespace. See the lines with ".ns-0" in MediaWiki:Monobook.css.

See also[edit]

Links to other help pages[edit]

Help contents
Meta · Wikinews · Wikipedia · Wikiquote · Wiktionary · Commons: · Wikidata · MediaWiki · Wikibooks · Wikisource · MediaWiki: Manual · Google
Versions of this help page (for other languages see further)
What links here on Meta or from Meta · Wikipedia · MediaWiki
Reading
Go · Search · Stop words · Namespace · Page name · Section · Backlinks · Redirect · Category · Image page · Special pages · Printable version
Tracking changes
Recent changes (enhanced) | Related changes · Watching pages · Diff · Page history · Edit summary · User contributions · Minor edit · Patrolled edit
Logging in and preferences
Logging in · Preferences · User style
Editing
Starting a new page · Advanced editing · Editing FAQ · Edit toolbar · Export · Import · Shortcuts · Edit conflict · Page size
Referencing
Links · URL · Piped links · Interwiki linking · Footnotes
Style and formatting
Wikitext examples · CSS · Reference card · HTML in wikitext · Formula · List · Table · Sorting · Colors · Images and file uploads
Fixing mistakes
Show preview · Testing · Reverting edits
Advanced functioning
Expansion · Template · Advanced templates · Parser function · Parameter default · Variable · System message · Substitution · Array · Calculation · Embed page
Others
Special characters · Renaming (moving) a page · Preparing a page for translation · Talk page · Signatures · Sandbox · Legal issues for editors
Languages: English  · Deutsch · English · français · italiano · 日本語 · Nederlands · português · русский