「ヘルプ:Subpages」の版間の差分
細 (1版) |
細 (1版 をインポートしました) |
||
(4人の利用者による、間の13版が非表示) | |||
1行目: | 1行目: | ||
<languages/> | <languages/> | ||
− | {{PD Help Page}} | + | {{TNT|PD Help Page}} |
− | |||
<translate> | <translate> | ||
− | '''Subpages''' introduce some hierarchical organization into wiki pages, with levels of the hierarchy separated by slashes (<tvar| | + | <!--T:1--> |
+ | '''Subpages''' introduce some hierarchical organization into wiki pages, with levels of the hierarchy separated by slashes (<tvar|slash><code>/</code></>). | ||
− | === Where it works === | + | === Where it works === <!--T:2--> |
− | By default, MediaWiki's subpage feature is turned off in the main namespace, but can be used on | + | <!--T:3--> |
+ | By default, MediaWiki's subpage feature is turned off in the main namespace, but can be used on [[<tvar|help-talkpages>Special:MyLanguage/Help:Talk pages</>|talk pages]] and [[<tvar|help-userpages>Special:MyLanguage/Help:User page</>|user pages]]. See [[<tvar|help-ns>Special:MyLanguage/Help:Namespaces</>|Help:Namespaces]] for description of namespaces and <tvar|man-wg-ns-with-sp>[[Special:MyLanguage/Manual:$wgNamespacesWithSubpages#Enabling-for-a-namespace|$wgNamespacesWithSubpages]]</> to learn how to modify this default behavior. In namespaces where the feature is switched off, any forward slashes (<tvar|slash2><code>/</code></>) within a page name are simply part of the page name and do nothing special. | ||
− | + | <!--T:23--> | |
+ | When subpages are enabled in a namespace, a forward slash in the title of a page always causes the page to be a subpage, even when this is not intentional or desirable. | ||
− | + | <!--T:4--> | |
+ | As a consequence of the forward slash being a reserved character when subpages are enabled, an alternative character might be needed. Back slashes (<tvar|backslash><code>\</code></>) 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 "[[wikt:⧸|big solidus]]" (<tvar|u1>U+29F8</>), which results in Foo⧸bar (cf. a real slash: Foo/bar), or the [[wikt:⁄|solidus]] (<tvar|u2>U+2044</>), which results in Foo⁄bar. Three possible technical disadvantages (apart from the visual difference from a real slash) arise from this hack: | ||
</translate> | </translate> | ||
+ | # <translate><!--T:5--> | ||
+ | People without the necessary fonts won’t be able to view the character properly;</translate> | ||
+ | # <translate><!--T:6--> | ||
+ | Redirects from the title with a slash must be created, so that linking and search will work correctly.</translate> | ||
+ | # <translate><!--T:7--> | ||
+ | Both the [[<tvar|man-ns>Special:MyLanguage/Manual:Namespace#Subject-and-talk</>|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.</translate> | ||
<translate> | <translate> | ||
− | + | === How it works === <!--T:8--> | |
− | |||
− | |||
− | |||
− | |||
− | === How it works === | ||
+ | <!--T:9--> | ||
Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.: | Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.: | ||
+ | <!--T:10--> | ||
* [[Help:Subpages]] – this page | * [[Help:Subpages]] – this page | ||
* [[Help:Subpages/subpage]] – child page | * [[Help:Subpages/subpage]] – child page | ||
29行目: | 35行目: | ||
* [[Help:Subpages/subpage/sub-subpage/sub-sub-subpage/sub-sub-sub-subpage]] – great 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 | + | <!--T:11--> |
+ | 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 [[<tvar|help-links-int>Special:MyLanguage/Help:Links#Internal</>|Help:Links]]. | ||
+ | |||
+ | <!--T:24--> | ||
+ | There are [[Help:Magic words#Page names|Magic words]] to split the name of a subpage, such as <code><nowiki>{{BASEPAGENAME}}</nowiki></code> and <code><nowiki>{{SUBPAGENAME}}</nowiki></code>, and the parser function <code><nowiki>{{</nowiki>[[Special:MyLanguage/Help:Extension:ParserFunctions#.23titleparts|#titleparts:]]<nowiki>}}</nowiki></code> for finer control. | ||
+ | <!--T:12--> | ||
Note that the part of page names after a slash is case sensitive '''including the first letter.''' | Note that the part of page names after a slash is case sensitive '''including the first letter.''' | ||
− | + | <!--T:13--> | |
+ | [[w:Breadcrumb links|Breadcrumb links]] will appear automatically at the top of the subpage, linking to each parent page that exists. These links do not appear, however, if the parent pages have not yet been created or if the subpage feature is turned off. | ||
+ | |||
+ | <!--T:25--> | ||
+ | As these automatic breadcrumb links are not in the page content, the breadcrumbs do not place parent pages in the [[Help:What links here|What links here]] and [[Help:Related changes|Related changes]] lists. | ||
− | === Use of subpages === | + | === Use of subpages === <!--T:14--> |
+ | <!--T:15--> | ||
There are various uses for the subpage feature. Some of the typical usages of subpages are: | There are various uses for the subpage feature. Some of the typical usages of subpages are: | ||
− | * to create archives of old discussions under a [[Help:Talk pages|talk page]] | + | * to create archives of old discussions under a [[<tvar|help-talkpages2>Special:MyLanguage/Help:Talk pages</>|talk page]] |
− | * to create scratchpad editing spaces under a [[Help:User page|user page]] | + | * to create scratchpad editing spaces under a [[<tvar|help-userpages2>Special:MyLanguage/Help:User page</>|user page]] |
− | * to create other language versions of a document in multilingual wikis | + | * to create other language versions of a document in multilingual wikis</translate> |
+ | <translate> | ||
+ | <!--T:28--> | ||
+ | * to create a template's subpages for its documentation, for its code sandbox, for its testcases, and for any subtemplate code | ||
− | 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 | + | <!--T:16--> |
+ | 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 [[<tvar|help-cat>Special:MyLanguage/Help:Category</>|category]] feature, which is more suitable for creating a hierarchical network of information. | ||
− | == Displaying subpages == | + | == Displaying subpages == <!--T:17--> |
+ | <!--T:18--> | ||
Subpages can be listed very plainly by transcluding [[Special:PrefixIndex]], like this: | Subpages can be listed very plainly by transcluding [[Special:PrefixIndex]], like this: | ||
</translate> | </translate> | ||
54行目: | 75行目: | ||
<translate> | <translate> | ||
+ | <!--T:19--> | ||
Which produces this: | Which produces this: | ||
</translate> | </translate> | ||
60行目: | 82行目: | ||
<translate> | <translate> | ||
− | Since the | + | <!--T:20--> |
− | + | Since the [[<tvar|help-magicwords>Special:MyLanguage/Help:Magic words</>|magic word]] <tvar|fullpagename><code><nowiki>{{FULLPAGENAME}}</nowiki></code></> outputs the current page, the general wiki markup to show all subpages of the current page is <tvar|all-subpages><code><nowiki>{{Special:PrefixIndex/{{FULLPAGENAME}}/}}</nowiki></code></>.</translate> | |
+ | <translate> | ||
+ | <!--T:26--> | ||
+ | You can pass parameters to this, e.g. <code><nowiki>{{Special:PrefixIndex/{{FULLPAGENAME}}/ |hideredirects=1 |stripprefix=1}}</nowiki></code></translate> | ||
+ | <translate> | ||
− | + | <!--T:27--> | |
+ | The [[:Category:Subpage extensions|subpage extensions]], such as [[<tvar|ext-subpagelist>Special:MyLanguage/Extension:SubPageList</>|Extension:SubPageList]], let you customize the display of subpages. | ||
− | * | + | == See also == <!--T:21--> |
− | + | ||
− | + | <!--T:22--> | |
− | * | + | * [[Special:MyLanguage/Manual:$wgNamespacesWithSubpages|Manual:$wgNamespacesWithSubpages]] |
− | + | * [[Meta:Help:Link#Subpage feature|Meta:Help:Link#Subpage feature]] | |
− | + | * [[Special:MyLanguage/Help:Variables#Page-names|Help:Variables#Page names]] | |
− | |||
− | |||
− | |||
* [[Special:PrefixIndex]] — Provides a list of subpages. | * [[Special:PrefixIndex]] — Provides a list of subpages. | ||
+ | * [[Special:MyLanguage/:Category:Subpage_extensions|Subpage related extensions]] | ||
+ | * {{Wikipedia|Subpages}} | ||
</translate> | </translate> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | [[Category:Help{{ | + | [[Category:Help{{translation}}|{{PAGENAME}}]] |
− | [[Category:Subpage{{ | + | [[Category:Subpage{{translation}}|{{PAGENAME}}]] |
2016年7月24日 (日) 00:25時点における最新版
Note: When you edit this page, you agree to release your contribution under the CC0. See Public Domain Help Pages for more info.
|
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 $wgNamespacesWithSubpages to learn how to modify this default behavior. 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.
When subpages are enabled in a namespace, a forward slash in the title of a page always causes the page to be a subpage, even when this is not intentional or desirable.
As a consequence of the forward slash being a reserved character when subpages are enabled, an alternative character might be needed. 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.
There are Magic words to split the name of a subpage, such as {{BASEPAGENAME}}
and {{SUBPAGENAME}}
, and the parser function {{#titleparts:}}
for finer control.
Note that the part of page names after a slash is case sensitive including the first letter.
Breadcrumb links will appear automatically at the top of the subpage, linking to each parent page that exists. These links do not appear, however, if the parent pages have not yet been created or if the subpage feature is turned off.
As these automatic breadcrumb links are not in the page content, the breadcrumbs do not place parent pages in the What links here and Related changes lists.
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
- to create a template's subpages for its documentation, for its code sandbox, for its testcases, and for any subtemplate code
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}}/}}
.
You can pass parameters to this, e.g. {{Special:PrefixIndex/{{FULLPAGENAME}}/ |hideredirects=1 |stripprefix=1}}
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
Wikipedia: Subpages |