Template:Documentation: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Dinoguy1000 don't categorize preload template |
m →top: clean up |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<!--------- |
|||
| ⚫ | |||
| ⚫ | |||
<div class="color1" style="padding: 1em; margin: 0;">'''Template documentation''' <span style="font-size: 85%;">(for the above template, sometimes hidden or invisible)</span>{{ #if: {{{content|}}} || <span id="doc_editlinks" class="editsection plainlinks" style="font-size: 85%;">{{ #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }} |
|||
Note: the reason why a table is not used for the whole box is because sometimes the templates used as examples in the documentation page will enter in conflict with it. |
|||
| [[[{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|view]]] [[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=edit}} edit]] [[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=history}} history]] [[{{fullurl:{{FULLPAGENAME}}|action=purge}} refresh]] |
|||
---------> |
|||
| ⚫ | |||
| ⚫ | |||
}}</span> }}</div> |
|||
<!----------- |
|||
<div style="padding: 1em; padding-bottom: 0; margin: 0;">{{ #if: {{{content|}}} |
|||
Header |
|||
-----------> |
|||
{{{content}}} |
|||
{| style="width:100%; border-collapse:collapse; background:#ff98ba; color:#000; border-bottom:1px solid #000;" |
|||
| ⚫ | |||
| style="width:140px; text-align:center; padding:1em;" | |
|||
| {{tocright}}{{{{ #ifeq: {{NAMESPACE}} | {{ns:Template}} |
|||
| style="padding:1em;" | <span style="font-size:20px;">'''Template Documentation'''</span> <sup style="font-size:12px; font-style:italic;">(sometimes hidden or invisible)</sup> |
|||
|| :{{NAMESPACE:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}} }}}}: |
|||
<span style="font-size:12px;">'''Template tools:''' [{{fullurl:{{FULLPAGENAME}}|action=purge}} purge] • [[Special:WhatLinksHere/{{FULLPAGENAME}}|what links here]] • [{{fullurl:Special:WhatLinksHere/{{FULLPAGENAME}}|hideredirs=1&hidelinks=1}} what transclude this] • [[Special:PrefixIndex/{{FULLPAGENAME}}/|subpages]]</span> |
|||
| ⚫ | |||
|} |
|||
| :<strong class="error">This template doesn't have any documentation yet!</strong> Help out by [{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=edit&preload=Template:Documentation/preload}} writing some]. {{ #ifeq: {{NAMESPACE}} | {{ns:10}} |
|||
<!------------------------------ |
|||
| There may also be documentation on [[w:c:templates:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|Wikia Templates]] which can be copied. |
|||
View Documentation |
|||
}}{{ #ifeq: {{FULLPAGENAME}} | {{ns:Template}}:Documentation/preload || [[Category:Templates without documentation]] }} |
|||
------------------------------> |
|||
| ⚫ | |||
<div class="volume" style="padding:10px 5px; background:#fff4f8; font-size: 85%;"> |
|||
{{#ifexist: {{FULLPAGENAME}}/doc |
|||
| ⚫ | |||
| <div style="margin:auto;"><strong class="error">This template currently doesn't have any documentation!</strong> |
|||
<br /> |
|||
| ⚫ | |||
<includeonly>[[Category:Templates Without Documentation]]</includeonly> |
|||
}} |
}} |
||
</div> |
</div> |
||
<!------------ |
|||
<div class="color1" style="clear: both; padding: 0.5em; margin: 0; font-size: 85%; text-align: right;">{{ #if: {{{content|}}} |
|||
Footer |
|||
| '''[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]''' to change the above text. ('''[[Template:Documentation|What is this?]]''') |
|||
------------> |
|||
| ⚫ | |||
<div style="clear:both; background:#ff98ba; color:#000; border-top:1px solid #000; padding:1em; font-size:12px;"> |
|||
| The above text is '''[[m:Transclusion|<span class="color1">transcluded</span>]]''' from '''[[{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]]'''; you can '''[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=edit}} change it]''' or '''[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=history}} view its history]'''. ('''[[Template:Documentation|How does this work?]]''') |
|||
| ⚫ | |||
| This template currently doesn't have any documentation; you can '''[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=edit&preload=Template:Documentation/preload}} create it]''' if you know how the template is used. ('''[[Template:Documentation|What is this?]]''') |
|||
| [[{{FULLPAGENAME}}/doc]] |
|||
}} |
|||
| [{{fullurl:{{FULLPAGENAME}}/doc|action=edit&preload=Template:Documentazione/preload}} {{FULLPAGENAME}}/doc] |
|||
}}<br />If you're done making changes, please '''[{{fullurl:{{FULLPAGENAME}}|action=purge}} refresh the text]'''. ('''[[Help:Purge|Why?]]''')<br />You can experiment in this template's {{ #ifexist: {{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }} | '''[[{{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }}|sandbox]]''' ('''[{{fullurl:{{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }}|action=edit}} edit]''' | '''[{{fullurl:Special:ComparePages|page1={{FULLPAGENAMEE}}&page2={{urlencode:{{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }}}}}} diff]''') | sandbox ('''[{{fullurl:{{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }}|action=edit&preload=Template:Documentation/preload-sandbox}} create]''' | '''[{{fullurl:{{ #if: {{{sandbox|}}} | {{{sandbox}}} | {{FULLPAGENAME}}/sandbox }}|action=edit&preload={{FULLPAGENAMEE}}&summary={{urlencode:Create sandbox version of [[{{FULLPAGENAME}}]]}}}} mirror]''') }} and {{ #ifexist: {{ #if: {{{testcases|}}} | {{{testcases}}} | {{FULLPAGENAME}}/testcases }} | '''[[{{ #if: {{{testcases|}}} | {{{testcases}}} | {{FULLPAGENAME}}/testcases }}|testcases]]''' ('''[{{fullurl:{{ #if: {{{testcases|}}} | {{{testcases}}} | {{FULLPAGENAME}}/testcases }}|action=edit}} edit]''') | testcases ('''[{{fullurl:{{ #if: {{{testcases|}}} | {{{testcases}}} | {{FULLPAGENAME}}/testcases }}|action=edit&preload=Template:Documentation/preload-testcases}} create]''') }} pages.{{ #if: {{{content|}}} || <br />Please add '''[[Help:Categories|categories]]''' and '''[[Help:Interwiki link|interwikis]]''' to {{ #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }} | '''[[{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]]''' | '''[{{fullurl:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|action=edit&preload=Template:Documentation/preload}} {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]''' }}. }} ('''[[Special:PrefixIndex/{{FULLPAGENAME}}/|View all subpages of this page]]'''.)</div> |
|||
}} to edit this text! ([[Template:Documentation|How does this work]]?) ([{{fullurl:{{FULLPAGENAME}}|action=purge}} Refresh] this text) |
|||
</div> |
|||
</div> |
</div> |
||
{{DEFAULTSORT:{{PAGENAME}}|noreplace}} |
|||
Latest revision as of 18:58, 23 June 2020
| Template Documentation (sometimes hidden or invisible)
Template tools: purge • what links here • what transclude this • subpages |
- Description
- This template is used to insert a documentation box on template pages. The box makes use of MediaWiki's Transclusion functionality to automatically load the contents of the /doc subpage.
- Syntax
- Type
<noinclude>{{documentation}}</noinclude>at the end of the template page. Make sure the opening <noinclude> starts directly after the template code and not on the line below. This would insert an unwanted newline to the template.
General usage
On the Template page
(Template code here)<noinclude>
{{documentation}}</noinclude>
You may additional add the notoc parameter if the table of contents is not desired.
On the Documentation subpage
On the documentation page you can provide all the needed info for people to know how to use the template.
Every documentation page should start with {{Documentation subpage}}. This will add the appropriate header and category to the page.
The format for the documentation page varies, but try to include at least the following:
- Description: A short description/introduction of what the template does and when/where it should be used.
- Syntax/Parameters: The syntax/parameters that the template uses. Make sure to explain individual parameters if needed.
- Examples: Brief examples demonstrating the template with the various parameters filled in.
Visit Template:Documentation/doc to edit this text! (How does this work?) (Refresh this text)
