Difference between revisions of "Template:Documentation subpage/doc"
m (1 revision) |
m (1 revision) |
||
(One intermediate revision by the same user not shown) | |||
Line 4: | Line 4: | ||
{{tl|documentation subpage}} | {{tl|documentation subpage}} | ||
'''OR''' | '''OR''' | ||
− | {{tlx|documentation subpage| | + | {{tlx|documentation subpage|<nowiki>[[</nowiki><var>main page to link to</var><nowiki>]]</nowiki>}} |
=== Userboxes === | === Userboxes === | ||
Line 10: | Line 10: | ||
{{tl|userbox documentation subpage}} | {{tl|userbox documentation subpage}} | ||
'''OR''' | '''OR''' | ||
− | {{tlx|userbox documentation subpage| | + | {{tlx|userbox documentation subpage|<nowiki>[[</nowiki><var>main userbox page to link to</var><nowiki>]]</nowiki>}} |
=== Customization of text === | === Customization of text === | ||
− | To manually change the text of the template, the " | + | To manually change the text of the template, the "<code>text1=<var>your text here</var></code>" and/or "<code>text2=<var>your other text here</var></code>" parameters can be specified. "<code>text1=</code>" changes the automatic text on the first line to your own word(s). "<code>text2=</code>" changes the automatic text on the second line to your own word(s). If "<code>text1=</code>" parameter is specified without the "<code>text2=</code>" parameter, both the first and second line of text will be custom based on the text given in the "<code>text1=</code>" parameter. |
Example usage: | Example usage: | ||
− | {{tlx|documentation subpage|text1 | + | {{tlx|documentation subpage|text1<nowiki>=</nowiki><var>custom first and second line text</var>}} |
− | {{tlx|documentation subpage|text2 | + | {{tlx|documentation subpage|text2<nowiki>=</nowiki><var>custom second line text only</var>}} |
− | {{tlx|documentation subpage|text1 | + | {{tlx|documentation subpage|text1<nowiki>=</nowiki><var>custom first line text</var>|text2<nowiki>=</nowiki><var>custom second line text</var>}} |
== How it is displayed == | == How it is displayed == | ||
This template should be placed at the top of "/doc" pages. It changes output depending on where it is viewed: | This template should be placed at the top of "/doc" pages. It changes output depending on where it is viewed: | ||
* On a "/doc" page, it displays a box explaining template documentation and links to the template page. | * On a "/doc" page, it displays a box explaining template documentation and links to the template page. | ||
− | * On other pages (ie, pages transcluding the "/doc" page), the template will not show. The template page itself (which contains | + | * On other pages (ie, pages transcluding the "/doc" page), the template will not show. The template page itself (which contains <code>{{tl|Documentation}}</code>) will automatically note that the documentation is [[Wikipedia:Transclusion|transcluded]] from a subpage. |
== Functions == | == Functions == | ||
Line 31: | Line 31: | ||
== See also == | == See also == | ||
− | + | {{Documentation/see also}} | |
− | {{ Documentation/see also }} | ||
− | + | <includeonly> | |
− | + | <!-- categories and interwiki links --> | |
− | [[Category:Template documentation| | + | [[Category:Template documentation| ]] |
[[Category:Template namespace templates]] | [[Category:Template namespace templates]] | ||
− | |||
− | |||
− | |||
[[tn:Template:Documentation subpage]] | [[tn:Template:Documentation subpage]] | ||
</includeonly> | </includeonly> |
Latest revision as of 20:06, 7 February 2014
40px | Template:Strong for Template:Terminate sentence It contains usage information, categories and other content that is not part of the original template page. |
Usage
{{documentation subpage}}
OR
{{documentation subpage|[[main page to link to]]}}
Userboxes
When used to document usage of a userbox, it may be preferred to have this template state "userbox"/"userbox page" instead of "template"/"template page" or "user template"/"user template page". If this is preferred, use:
{{userbox documentation subpage}}
OR
{{userbox documentation subpage|[[main userbox page to link to]]}}
Customization of text
To manually change the text of the template, the "text1=your text here
" and/or "text2=your other text here
" parameters can be specified. "text1=
" changes the automatic text on the first line to your own word(s). "text2=
" changes the automatic text on the second line to your own word(s). If "text1=
" parameter is specified without the "text2=
" parameter, both the first and second line of text will be custom based on the text given in the "text1=
" parameter.
Example usage:
{{documentation subpage|text1=custom first and second line text}}
{{documentation subpage|text2=custom second line text only}}
{{documentation subpage|text1=custom first line text|text2=custom second line text}}
How it is displayed
This template should be placed at the top of "/doc" pages. It changes output depending on where it is viewed:
- On a "/doc" page, it displays a box explaining template documentation and links to the template page.
- On other pages (ie, pages transcluding the "/doc" page), the template will not show. The template page itself (which contains
{{Documentation}}
) will automatically note that the documentation is transcluded from a subpage.
Functions
In addition to the output message, the template categorizes pages to Category:Template documentation pages, Category:User documentation pages, or similar (named after the subject space), but only for documentation pages in namespaces with the subpage feature. It defaults the sort key to the page name without namespace (ie, "Foo" on "Template:Foo", so it would be sorted in categories under 'F').
See also
General information about documentation for templates:
{{Documentation}} family:
- {{Documentation}}
- {{Documentation subpage}}
Meta-Wiki {{Documentation}} ancestor: