Difference between revisions of "Template:Documentation"

From Northumberland Climbing
Jump to navigation Jump to search
Template>ShakespeareFan00
 
m (1 revision imported)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div style="clear:both;margin:1em 0;border:1px solid #aaa;background:#ecfcf4;padding:.5em" class="template-documentation"><!--
+
<noinclude>
 +
</noinclude><includeonly>{{#switch:
 +
| =
 +
{{#invoke:documentation|main|_content={{ {{#invoke:documentation|contentTitle}}}}}}
 +
| #default=
 +
  {{#invoke:template=Template:Documentation|noshift=1}}
 +
}}</includeonly><noinclude>
 +
{{documentation|content=
  
These are the literal class definitions in common.css:
+
{{Lua|Module:Documentation}}
 
/* For template documentation */
 
.template-documentation {
 
    clear: both;
 
    margin: 1em 0 0 0;
 
    border: 1px solid #aaa;
 
    background: #ecfcf4;
 
    padding: .5em;
 
}
 
  
-->{{#ifeq:{{{heading|μ}}}|<!--**DEFINED BUT EMPTY**-->
+
<!--T:12-->
  |<!--**NOTHING**-->
+
This template automatically displays a documentation box like the one you are seeing now, of which the content is sometimes transcluded from another page.
  |<div style="padding-bottom:3px;border-bottom:1px solid #aaa;margin-bottom:1ex">{{#ifeq:{{{content|μ}}}|μ
 
    |<span class="mw-editsection plainlinks" id="doc_editlinks" style="float:right; margin-right:0.50em;">{{#ifexist:{{{1|{{Documentation/docname}}}}}
 
    |<!--**    /doc EXISTE**  -->[[{{fullurl:{{{1|{{Documentation/docname}}}}}}} view]] [[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit}} edit]] [[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=history}} history]] [{{purge|purge}}]
 
    |<!--**/doc NÃO EXISTE**-->[[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit&preload=Template:Documentation/preload}} create]]
 
    }}</span>
 
  }} <span style="{{#if:{{{heading-style|}}}|{{{heading-style}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|font-weight:bold;font-size:125%|font-size:150%}}}}">{{#if:{{{heading|}}}|{{{heading}}}|{{#ifeq:{{NAMESPACE}}|{{ns:template}}|[[Image:Template-info.svg|50px]] Template documentation|Documentation}}}}</span></div>
 
}}<!--
 
  
--><div id="template_doc_page_transcluded" class="dablink plainlinks"><!--
+
<!--T:13-->
 +
It is intended for pages which are [[<tvar|1>Special:MyLanguage/Help:Transclusion</>|transcluded]] in other pages, i.e. templates, whether in the template namespace or not.
  
  -->{{#ifexist:{{{1|{{Documentation/docname}}}}}
+
==Usage== <!--T:2-->
  |<!--**/doc EXISTS**-->This documentation is transcluded from [[{{{1|{{Documentation/docname}}}}}]]. <small style="font-style: normal">([{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit}} edit] &#124; [{{fullurl:{{{1|{{Documentation/docname}}}}}|action=history}} history])<br />'''''Note to editors:''' Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.''</small><br /><!--
 
  -->}}<!--
 
  
  -->{{#switch:{{SUBPAGENAME}}
+
===Customizing display=== <!--T:3-->
  |sandbox|testcases=<!--**DO NOT SHOW THESE LINKS ON THE SANDBOX/TESTCASES PAGES**-->
+
 
  |#default=
+
<!--T:4-->
    {{#switch:{{SUBJECTSPACE}}
+
Overrides exist to customize the output in special cases:
    |{{ns:template}}
+
 
    |{{ns:user}}=
+
* <nowiki>{{</nowiki>documentation{{!}}'''heading'''=<nowiki>}}</nowiki> - <!--T:5--> change the text of the "documentation" heading. <!--T:10--> If this is set to blank, the entire heading line (including the first [edit] link) will also disappear.
      {{#ifexist:{{FULLPAGENAME}}/sandbox
+
 
      |This template has a [[/sandbox|sandbox]] <small style="font-style:normal">([{{fullurl:{{#rel2abs:/sandbox}}|action=edit}} edit])</small> <!--
+
 
        -->{{#ifexist:{{FULLPAGENAME}}/testcases
+
==Rationale== <!--T:6-->
        |and [[/testcases|testcases]] <small style="font-style:normal">([{{fullurl:{{#rel2abs:/testcases}}|action=edit}} edit])</small>}} for editors to experiment.
+
 
      |{{#ifexist: {{FULLPAGENAME}}/testcases
+
<!--T:7-->
        |This template has [[/testcases|testcases]] <small style="font-style:normal">([{{fullurl:{{#rel2abs:/testcases}}|action=edit}} edit])</small> for editors to experiment.}}
+
This template allows any page to use any documentation page, and makes it possible to protect templates while allowing anyone to edit the template's documentation, categories, and interwiki links.
  }}}}}}
+
 
</div>
+
<!--T:8-->
{{#if:{{{content|}}}|{{{content|}}}|{{#ifexist:{{{1|{{Documentation/docname}}}}}|{{ {{{1|{{Documentation/docname}}}}}}}}}}}
+
It also reduces server resources by circumventing a [[w:Wikipedia:Template limits|technical limitation of templates]] (see a [[<tvar|1>:en:Special:Diff/69888944</>|developer's explanation]]).
<div style="clear:both;"></div>
+
 
</div><noinclude>
+
==See also== <!--T:9-->
<!-- Add categories and interwikis to the /doc subpage, not here! -->
+
 
</noinclude>
+
* <!--T:14--> [[w:Template:Documentation subpage]]
 +
* {{tim|Documentation}}
 +
* <!--T:11--> [[w:Wikipedia:Template documentation]]
 +
 
 +
}}
 +
[[Category:Formatting templates|Template documentation]]
 +
[[Category:Template documentation| ]]
 +
</noinclude><includeonly>{{#if:{{{content|}}}|
 +
[[Category:Template documentation pages]]
 +
}}</includeonly>

Latest revision as of 11:47, 13 August 2020


Template documentation

This template automatically displays a documentation box like the one you are seeing now, of which the content is sometimes transcluded from another page.

It is intended for pages which are [[<tvar|1>Special:MyLanguage/Help:Transclusion</>|transcluded]] in other pages, i.e. templates, whether in the template namespace or not.

Usage[edit]

Customizing display[edit]

Overrides exist to customize the output in special cases:

  • {{documentation|heading=}} - change the text of the "documentation" heading. If this is set to blank, the entire heading line (including the first [edit] link) will also disappear.


Rationale[edit]

This template allows any page to use any documentation page, and makes it possible to protect templates while allowing anyone to edit the template's documentation, categories, and interwiki links.

It also reduces server resources by circumventing a technical limitation of templates (see a [[<tvar|1>:en:Special:Diff/69888944</>|developer's explanation]]).

See also[edit]