(Updated formatting.) |
(Updated the Documentation template documentation from the Templates Wiki.) |
||
Line 1: | Line 1: | ||
{{#ifexist: Template:T | <!-- nothing; T already copied/exists --> | :<strong class="error">Please copy <nowiki>{{T}}</nowiki> from [[w:c:templates:Template:T]] to [[Template:T]]!</strong>}}<!-- |
|||
==Description== |
|||
-->{{#ifexist: Template:T/doc | <!-- nothing; T's documentation already copied/exists --> | :<strong class="error">Please copy <nowiki>{{T}}</nowiki>'s documentation from [[w:c:templates:Template:T/doc]] to [[Template:T/doc]]!</strong>}}<!-- |
|||
This template is used to insert descriptions on template pages. |
|||
-->{{#ifexist: Template:Tocright | <!-- nothing; Tocright already copied/exists --> | :<strong class="error">Please copy <nowiki>{{Tocright}}</nowiki> from [[w:c:templates:Template:Tocright]] to [[Template:Tocright]]!</strong>}}<!-- |
|||
-->{{#ifexist: Template:Tocright/doc | <!-- nothing; Tocright's documentation already copied/exists --> | :<strong class="error">Please copy <nowiki>{{Tocright}}</nowiki>'s documentation from [[w:c:templates:Template:Tocright/doc]] to [[Template:Tocright/doc]]!</strong>}}<!-- |
|||
<!-- you can remove this line and everything above it if you don't see any big bold red text --> |
|||
==Syntax== |
|||
<noinclude>{{Documentation subpage}}</noinclude> |
|||
; Description |
|||
: This template is used to insert documentation on template pages. |
|||
Add <code><nowiki><noinclude></nowiki>{{t|Documentation|documentation page}}<nowiki></noinclude></nowiki></code> to transclude an alternative page from the /doc subpage. |
|||
; Syntax |
|||
: Type <code><noinclude>{{T|Documentation}}</noinclude></code> at the end of the template page. |
|||
==Usage== |
|||
===On the Template page=== |
|||
This is the normal format when used: |
|||
== General usage == |
|||
=== On the Template page === |
|||
<pre> |
<pre> |
||
Template code<noinclude> |
|||
TEMPLATE CODE |
|||
{{Documentation}} |
|||
<includeonly>Any categories to be inserted into articles by the template</includeonly> |
|||
</noinclude> |
|||
</pre> |
</pre> |
||
=== On the Template/doc page === |
|||
''If your template is not a completed div or table, you may need to close the tags just before <code><nowiki>{{Documentation}}</nowiki></code> is inserted (within the noinclude tags).'' |
|||
''A line break right before <code><nowiki>{{Documentation}}</nowiki></code> can also be useful as it helps prevent the documentation template "running into" previous code.'' |
|||
===On the documentation page=== |
|||
The documentation page is usually located on the /doc subpage for a template, but a different page can be specified with the first parameter of the template (see [[#Syntax|Syntax]]). |
|||
Normally, you will want to write something like the following on the documentation page: |
|||
<pre> |
<pre> |
||
; Description |
|||
This template is used to do something. |
: This template is used to do something. |
||
; Dependencies: |
|||
:* Uses (some CSS, JS, file, or other template). |
|||
; Syntax |
|||
: Type <code>{{T|Templatename}}</code> somewhere. |
|||
; Sample output |
|||
: <code><nowiki>{{Templatename|foo}}</nowiki></code> gives... |
|||
: {{Templatename|foo}} |
|||
<includeonly>Any categories for the template itself |
|||
== Syntax == |
|||
</includeonly><noinclude> |
|||
Type <code>{{T|Templatename}}</code> somewhere. |
|||
[[Category:Template documentation]] |
|||
</noinclude> |
|||
</pre> |
|||
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or further usage information sections. |
|||
== Samples == |
|||
<code><nowiki>{{Templatename|input}}</nowiki></code> |
|||
results in... |
|||
{{Templatename|input}} |
|||
<includeonly>Any categories for the template itself</includeonly> |
|||
<noinclude>[[Category:Template documentation]]</noinclude> |
|||
</pre> |
|||
Note that the above example also uses {{T|T}}. |
|||
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or other sections. |
|||
== Dependencies == |
|||
Note that the above example also uses the [[Template:T]] template. |
|||
; Templates |
|||
: [[Template:Documentation/preload]] |
|||
: [[Template:Documentation/preload-sandbox]] |
|||
: [[Template:Documentation/preload-testcases]] |
|||
: [[Template:Tocright]] ([[Template:Tocright/doc]]) |
|||
== TemplateData == |
|||
<includeonly>[[Category:Documentation templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude> |
|||
<templatedata> |
|||
{ |
|||
"params": { |
|||
"1": { |
|||
"description": "The name of the custom /doc subpage.", |
|||
"example": "Template:Documentation/doc", |
|||
"default": "{{FULLPAGENAME}}/doc", |
|||
"label": "Custom Documentation Location", |
|||
"type": "string" |
|||
}, |
|||
"content": { |
|||
"description": "Content if documentation page will not be transcluded", |
|||
"example": "This template creates quotes.", |
|||
"label": "Inline Documentation Content", |
|||
"type": "string" |
|||
}, |
|||
"sandbox": { |
|||
"label": "Custom Sandbox Location", |
|||
"description": "Specifies the /sandbox subpage location", |
|||
"example": "Template:Example/sandbox", |
|||
"type": "string", |
|||
"default": "{{FULLPAGENAME}}/sandbox" |
|||
}, |
|||
"testcases": { |
|||
"label": "Custom Testcases Location", |
|||
"description": "Specifies the /testcases subpage location", |
|||
"example": "Template:Example/testcases", |
|||
"type": "string", |
|||
"default": "{{FULLPAGENAME}}/testcases" |
|||
}, |
|||
"heading": { |
|||
"label": "Heading text", |
|||
"description": "Changes the default \"Documentation\" header to a different one", |
|||
"example": "About this template", |
|||
"type": "string" |
|||
}, |
|||
"footer": { |
|||
"label": "Custom footer content", |
|||
"description": "Replaces the default link box with a custom one", |
|||
"example": "Documentation is automatically generated by {{T|Ambox}}.<br/>Its contents are shown here.", |
|||
"type": "unbalanced-wikitext" |
|||
} |
|||
}, |
|||
"description": "This template is used to display documentation on template pages. It also adds some tools to help the editor to modify the /doc subpage and the template." |
|||
} |
|||
</templatedata><includeonly>[[Category:Documentation templates| ]]</includeonly> |
Revision as of 20:25, 23 August 2022

It contains usage information, categories, interlanguage links and other content that is not part of the original template page.
- Description
- This template is used to insert documentation on template pages.
- Syntax
- Type
<noinclude>
at the end of the template page.{{Documentation}}
</noinclude>
General usage
On the Template page
Template code<noinclude> {{Documentation}} </noinclude>
On the Template/doc page
; Description : This template is used to do something. ; Dependencies: :* Uses (some CSS, JS, file, or other template). ; Syntax : Type <code>{{T|Templatename}}</code> somewhere. ; Sample output : <code><nowiki>{{Templatename|foo}}</nowiki></code> gives... : {{Templatename|foo}} <includeonly>Any categories for the template itself </includeonly><noinclude> [[Category:Template documentation]] </noinclude>
Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or further usage information sections.
Note that the above example also uses {{T}}
.
Dependencies
- Templates
- Template:Documentation/preload
- Template:Documentation/preload-sandbox
- Template:Documentation/preload-testcases
- Template:Tocright (Template:Tocright/doc)
TemplateData
This template is used to display documentation on template pages. It also adds some tools to help the editor to modify the /doc subpage and the template.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Custom Documentation Location | 1 | The name of the custom /doc subpage.
| String | optional |
Inline Documentation Content | content | Content if documentation page will not be transcluded
| String | optional |
Custom Sandbox Location | sandbox | Specifies the /sandbox subpage location
| String | optional |
Custom Testcases Location | testcases | Specifies the /testcases subpage location
| String | optional |
Heading text | heading | Changes the default "Documentation" header to a different one
| String | optional |
Custom footer content | footer | Replaces the default link box with a custom one
| Unbalanced wikitext | optional |