Help:Subpages
Important note: When you edit this page, you agree to release your contribution into the public domain. If you don't want this or can't do this due to license restrictions, please don't edit. This page is one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see Help:Contents for an overview of all pages. See Project:PD help/Copying for instructions. |
Subpages introduce some hierarchical organization into wiki pages, with levels of the hierarchy separated by slashes (/
).
Where it works
By default, MediaWiki’s subpage feature is turned off in the main namespace, but can be used on talk pages and user pages. See Help:Namespaces for description of namespaces and Manual:$wgNamespacesWithSubpages#Enabling for a namespace to learn how to modify this default behaviour. In namespaces where the feature is switched off, any forward slashes (/) within a page name are simply part of the page name and do nothing special.
It’s not possible to use forward slashes in the title of a page from a namespace where subpages are activated, however back slashes (\) are treated as normal characters in subpage naming and can be used in place of forward slashes. Additionally, as a crude hack, a character similar to the forward slash can be used instead, such as the "big solidus" (U+29F8), which results in Foo⧸bar (cf. a real slash: Foo/bar), or the solidus (U+2044), which results in Foo⁄bar. Three possible technical disadvantages (apart from the visual difference from a real slash) arise from this hack:
- People without the necessary fonts won’t be able to view the character properly;
- Redirects from the title with a slash must be created, so that linking and search will work correctly.
- Both the subject and talk versions of a page (and their corresponding subpages, e.g. discussion archives) need to use the hack, so that moving a page would take all connected pages to the new title (if that setting is selected during the move). For example, subpages are disabled in the main namespace in Wikipedia, so while the talk page would need to use the solidus character to prevent having them marked as subpages, the corresponding page in the main namespace could keep an actual slash, is this goes unnoticed.
How it works
Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.:
- Help:Subpages – this page
- Help:Subpages/subpage – child page
- Help:Subpages/subpage/sub-subpage – grandchild page
- Help:Subpages/subpage/sub-subpage/sub-sub-subpage – great grandchild page
- Help:Subpages/subpage/sub-subpage/sub-sub-subpage/sub-sub-sub-subpage – great great grandchild page
You can link directly to any page’s subpage using the normal double square brackets notation, by providing the full name – including the slash(es) and the individual subpage name(s). You can also link from one page to one of its own subpages using certain shortcuts, which are covered at Help:Links#Internal links.
Note that the part of page names after a slash is case sensitive including the first letter.
In subpages, (a) link(s) back to antecedent page(s) will automatically appear at the top. These links do not appear, however, if the antecedent pages have not yet been created or if the subpage feature is turned off.
Use of subpages
There are various uses for the subpage feature. Some of the typical usages of subpages are:
- to create archives of old discussions under a talk page,
- to create scratchpad editing spaces under a user page,
- to create other language versions of a document in multilingual wikis.
Subpages are useful for organising information hierarchically. On the other hand, subpages tend to have a long name that is hard to remember, so it may be more user-friendly to use them as little as possible. You can also organize pages with the category feature, which is more suitable for creating a hierarchical network of information.
Displaying subpages
Subpages can be listed very plainly by transcluding Special:PrefixIndex, like this:
{{Special:PrefixIndex/Help:Subpages/}}
Which produces this:
Since the magic word {{FULLPAGENAME}} outputs the current page, the general wiki markup to show all subpages of the current page is {{Special:PrefixIndex/{{FULLPAGENAME}}/}}
.
The subpage extensions, such as Extension:SubPageList, let you customize the display of subpages.
See also
- Manual:$wgNamespacesWithSubpages
- Meta:Help:Link#Subpage feature
- Help:Variables#Page names
- Special:PrefixIndex – Provides a list of subpages.
- Subpage related extensions
Language: | English |
---|