Template:Documentation: Difference between revisions

From Graal Military Wiki
Content added Content deleted
(Reducing transclusion depth per discussion on talk page)
m (1 revision imported)
 
(46 intermediate revisions by 20 users not shown)
Line 1: Line 1:
<includeonly>{| class="article-table" style="width:100%;"
<!--
|- style="font-size:18px;"
Automatically add {{template sandbox notice}} when on a /sandbox page.
! Template documentation follows
-->{{#ifeq: {{SUBPAGENAME}} | sandbox
|-
| <div style="clear: both;"></div>{{template sandbox notice}}
| ''Note: the template above may sometimes be partially or fully invisible.''
}}<!--
|-
Automatically add {{pp-template}} to protected templates.
| Visit [[Template:{{PAGENAMEE}}/doc]] to edit this documentation. ([[Template:Documentation|How does this work?]])
-->{{template other
|}
| {{#ifeq: {{PROTECTIONLEVEL:move}} | sysop
<div style="margin:0 1em;">
| {{pp-template|docusage=yes}}
{{tocright}}
| {{#if: {{PROTECTIONLEVEL:edit}}
{{{{PAGENAME}}/doc}}</div></includeonly><noinclude>{{documentation}}[[Category:Template documentation| ]]</noinclude>
| {{pp-template|docusage=yes}}
| <!--Not protected, or only semi-move-protected-->
}}
}}
}}<!--
Start of green doc box.
-->{{documentation/core
| preload = {{{preload|}}} <!--Allow custom preloads-->
| heading = {{{heading|¬}}} <!--Empty but defined means no header-->
| heading-style = {{{heading-style|}}}
| content = {{{content|}}}
| link box = {{{link box|}}} <!--So "link box=off" works-->

| docpage =
{{#if: {{{1|}}}
| {{{1|}}}
| {{#switch: {{SUBJECTSPACE}}
| {{ns:0}}
| {{ns:File}}
| {{ns:MediaWiki}}
| {{ns:Category}} = {{TALKSPACE}}
| #default = {{SUBJECTSPACE}}
}}:{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}/doc
}}
| doc exist =
{{#ifexist:
{{#if: {{{1|}}}
| {{{1|}}} <!--Other docname fed-->
| {{#switch: {{SUBJECTSPACE}}
| {{ns:0}}
| {{ns:File}}
| {{ns:MediaWiki}}
| {{ns:Category}} = {{TALKSPACE}}
| #default = {{SUBJECTSPACE}}
}}:{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}/doc
}}
| yes
}}
| docname fed =
{{#if: {{{1|}}}
| yes
}}

| sandbox =
{{#switch: {{SUBJECTSPACE}}
| {{ns:0}}
| {{ns:File}}
| {{ns:MediaWiki}}
| {{ns:Category}} = {{TALKSPACE}}
| #default = {{SUBJECTSPACE}}
}}:{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}/sandbox
| testcases =
{{#switch: {{SUBJECTSPACE}}
| {{ns:0}}
| {{ns:File}}
| {{ns:MediaWiki}}
| {{ns:Category}} = {{TALKSPACE}}
| #default = {{SUBJECTSPACE}}
}}:{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}/testcases

| template page =
{{NAMESPACE}}:{{#switch: {{SUBPAGENAME}}
| sandbox
| testcases = {{BASEPAGENAME}}
| #default = {{PAGENAME}}
}}

}}<!--End of green doc box--><noinclude>

<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>

Latest revision as of 14:15, 29 February 2020

Template documentation follows
Note: the template above may sometimes be partially or fully invisible.
Visit Template:Documentation/doc to edit this documentation. (How does this work?)

Description

This template is used to insert descriptions on template pages.

Syntax

Add <noinclude>{{documentation}}</noinclude> at the end of the template page.

Usage

On the Template page

This is the normal format when used:

TEMPLATE CODE<includeonly>Any categories to be inserted into articles by the template</includeonly><noinclude>
{{documentation}}</noinclude>

If your template is not a completed div or table, you may need to close the tags just before {{documentation}} is inserted (within the noinclude tags).

A line break right before {{documentation}} can also be useful as it helps prevent the documentation template "running into" previous code.

On the Template/doc page

Normally, you will want to write something like the following on the documentation page:

==Description==
This template is used to do something.

==Syntax==
Type <code>{{t|templatename}}</code> somewhere.

==Samples==
<code><nowiki>{{templatename|input}}</nowiki></code> 

results in...

{{templatename|input}}

<includeonly>Any categories for the template itself</includeonly><noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

Use any or all of the above description/syntax/sample output sections. You may also want to add "see also" or other sections.

Note that the above example also uses the Template:T and Template:T/piece templates.