No edit summary Tag: 2017 source edit |
(Changed categories.) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
<bookshelf src="Book:User manual" /> | |||
==What is a subpage? == | ==What is a subpage? == | ||
To structure wiki content, you can create subpages for a page. This is useful if you have a larger topic and you want to break this topic down into manageable chunks of information. For example, if you have a page about a car, you could have subpages about major car components such as Brakes and Transmission. Subpages can have subpages of their own. | To structure wiki content, you can create subpages for a page. This is useful if you have a larger topic and you want to break this topic down into manageable chunks of information. For example, if you have a page about a car, you could have subpages about major car components such as Brakes and Transmission. Subpages can have subpages of their own. | ||
| Line 15: | Line 16: | ||
<section end="training-slides" /> | <section end="training-slides" /> | ||
[[File:Subpage syntax.drawio.png|alt=Subpage syntax|center|thumb|450x450px|Subpage syntax]] | |||
<section end="training" /> | <section end="training" /> | ||
| Line 25: | Line 25: | ||
Installation Guide/System Preparation/Windows | Installation Guide/System Preparation/Windows | ||
Installation Guide/System Preparation Windows/IIS</pre> | Installation Guide/System Preparation Windows/IIS</pre> | ||
{{ | {{Messagebox|type=note|Note text = Since MediaWiki interprets slashes as subpages, you should not use slashes in page names.|boxtype=note}} | ||
==Reasons for using subpages== | ==Reasons for using subpages== | ||
Typical applications for subpages are: | Typical applications for subpages are: | ||
| Line 43: | Line 43: | ||
To display the subpages of the page ''VisualEditor '' in the namespace Manual without showing the namespace or the main page name in the results and without including redirected pages, the syntax is: | To display the subpages of the page ''VisualEditor '' in the namespace Manual without showing the namespace or the main page name in the results and without including redirected pages, the syntax is: | ||
<syntaxhighlight lang="text"> | <syntaxhighlight lang="text"> | ||
{{Special:PrefixIndex/Manual:VisualEditor/ |hideredirects=1 |stripprefix=1}} | {{Special:PrefixIndex/Manual:Extension/VisualEditor/ |hideredirects=1 |stripprefix=1}} | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 49: | Line 49: | ||
Output: | Output: | ||
{{Special:PrefixIndex/Manual:VisualEditor/ |hideredirects=1 |stripprefix=1}} | {{Special:PrefixIndex/Manual:Extension/VisualEditor/ |hideredirects=1 |stripprefix=1}} | ||
The correct display of the subpages is only visible in read-mode after saving the page. The list is displayed automatically in a multi-column layout | The correct display of the subpages is only visible in read-mode after saving the page. The list is displayed automatically in a multi-column layout | ||
For more flexibility in the output of subpages, you can work with the [[Manual:Extension/DynamicPageList3|extension DPL 3]] which is included in BlueSpice. | For more flexibility in the output of subpages, you can work with the [[Manual:Extension/DynamicPageList3|extension DPL 3]] which is included in BlueSpice. | ||
{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=To create subpage lists, the extension SubPageList is}} | |||
{{Box Links-en|Topic1=https://www.mediawiki.org/wiki/Help:Subpages|Topic2=[[Manual:Extension/DynamicPageList3 | Creating page lists]]}} | From BlueSpice 4.2., the [[Reference:SubPageList|SubPageList]] extension is also available. It makes it much easier to create a flexible subpage list, since it includes many useful parameters. | ||
{{Box Links-en|Topic1=https://www.mediawiki.org/wiki/Help:Subpages|Topic2=[[Manual:Extension/DynamicPageList3 | Creating page lists]]|Topic3=[[Reference:SubPageList]]|Topic4=[[Reference:DynamicPageList3]]}} | |||
[[En:{{FULLPAGENAME}}]] | [[En:{{FULLPAGENAME}}]] | ||
[[de:Unterseiten_erstellen]] | [[de:Unterseiten_erstellen]] | ||
[[Category:Concept]] | [[Category:Concept]] | ||
Latest revision as of 10:47, 29 August 2022
What is a subpage?
To structure wiki content, you can create subpages for a page. This is useful if you have a larger topic and you want to break this topic down into manageable chunks of information. For example, if you have a page about a car, you could have subpages about major car components such as Brakes and Transmission. Subpages can have subpages of their own.
Subpages are automatically displayed in the breadcrumb navigation of the page:
Characteristics of a subpage
- Syntax-based: A slash in the page title creates a subpage (e.g.,
Installation Guide/System Preparation). - Navigation: A subpage creates navigation points (breadcrumb).
- Hierarchy: Enables "strongly associated" page hierarchies.
- Language versions: Management of language versions of a page.
Creating a subpage
To create a subpage, it is simply appended to the page name with a slash without spaces. Subpages can in turn have subpages:
Installation Guide/System Preparation Installation Guide/System Preparation/Windows Installation Guide/System Preparation Windows/IIS
Note:Since MediaWiki interprets slashes as subpages, you should not use slashes in page names.
Reasons for using subpages
Typical applications for subpages are:
- To create modular pages: For a larger topic, you can create a main page and link it to individual detail pages. The advantage is that the detail pages can then be specifically linked from other pages.
- To maintain archives: If the discussions on the user discussion page become too long, file them in a subpage.
- To translate a page: If the content of a page should be available in other languages. You can create a subpage in German for an English page, for example.
- To document a template: If you have a very complex template, you can document its functionality in subpages of the template.
Creating a list of subpages
To list the subpages of the current page, add the following tag to the source text of the page:
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}
Example:
To display the subpages of the page VisualEditor in the namespace Manual without showing the namespace or the main page name in the results and without including redirected pages, the syntax is:
{{Special:PrefixIndex/Manual:Extension/VisualEditor/ |hideredirects=1 |stripprefix=1}}
Output:
The correct display of the subpages is only visible in read-mode after saving the page. The list is displayed automatically in a multi-column layout
For more flexibility in the output of subpages, you can work with the extension DPL 3 which is included in BlueSpice.
To create subpage lists, the extension SubPageList is is available from BlueSpice 4.2.
From BlueSpice 4.2., the SubPageList extension is also available. It makes it much easier to create a flexible subpage list, since it includes many useful parameters.
