Difference between revisions of "Template:Documentation"

From JRiverWiki
Jump to: navigation, search
m (1 revision)
m (1 revision: Importing archive template to tidy up community portal page.)
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div style="clear: both; border: 1px solid black; margin: 1em;">
+
<!--
   <div style="background: #ddd; color: #111; padding: 1em; margin: 0;">'''Template documentation''' <span style="font-size: 85%;">(for the above template, sometimes hidden or invisible)</span><span class="editsection plainlinks" id="doc_editlinks">[[{{fullurl:{{FULLPAGENAME}}/doc|action=edit}} Edit]] [[{{fullurl:{{FULLPAGENAME}}|action=purge}} <span title="Refresh this page">Refresh</span>]]</span></div>
+
   Automatically add {{template sandbox notice}} when on a /sandbox page.
  <div style="padding: 1em; padding-bottom: 0; margin: 0;">{{
+
-->{{#ifeq: {{SUBPAGENAME}} | sandbox
    #if: {{{content|}}}
+
| <div style="clear: both;"></div>{{template sandbox notice|{{{livepage|}}}}}
    | <nowiki/>
+
}}<!--
{{{content}}}
+
  Automatically add {{pp-template}} to protected templates.
    | {{
+
-->{{template other
      #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}
+
| {{#ifeq: {{PROTECTIONLEVEL:move}} | sysop
      | {{tocright}}{{{{
+
  | {{pp-template|docusage=yes}}
        #ifeq: {{NAMESPACE}} | {{ns:Template}}
+
  | {{#if: {{PROTECTIONLEVEL:edit}}
        || :{{NAMESPACE:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}} }}}}:
+
    | {{pp-template|docusage=yes}}
      }}{{ #if: {{{1|}}} | {{PAGENAME:{{{1}}}}} | {{PAGENAME}}/doc}} }}
+
    | <!--Not protected, or only semi-move-protected-->
      | :<strong class="error">This template doesn't have any documentation yet!</strong> Help out by [{{fullurl:{{ #if: {{{1|}}} | {{ urlencode: {{{1}}} }} | {{FULLPAGENAMEE}}/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.
 
      }}[[Category:Templates without documentation|{{PAGENAME}}]]
 
 
     }}
 
     }}
 
   }}
 
   }}
   </div>
+
}}<!--
   <div style="clear: both; background: #ddd; color: #111; padding: 0.5em; margin: 0; font-size: 85%; text-align: right;">{{
+
  Start of green doc box.
    #if: {{{content|}}}
+
-->{{documentation/start box2
     | [{{fullurl:{{FULLPAGENAMEE}}|action=edit}} Edit this page]
+
| preload = {{{preload|}}}   <!--Allow custom preloads-->
    | Visit {{
+
| heading = {{{heading|¬}}}   <!--Empty but defined means no header-->
      #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}
+
| heading-style = {{{heading-style|}}}
      | [[{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]]
+
| content = {{{content|}}}
      | [{{fullurl:{{ #if: {{{1|}}} | {{ urlencode: {{{1}}} }} | {{FULLPAGENAMEE}}/doc }}|action=edit&preload=Template:Documentation/preload}} {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]
+
 
     }}
+
<!--Some namespaces must have the /doc, /sandbox and /testcases
  }} to change this text! ([[Template:Documentation|How does this work]]?)<br />Done making changes? [{{fullurl:{{FULLPAGENAME}}|action=purge}} Refresh] this text! ([[Help:Purge|Why?]])</div>
+
     in talk space-->
</div>
+
| docspace = {{documentation/docspace}}
 +
 
 +
| 1 = {{{1|}}}   <!--Other docname, if fed-->
 +
 
 +
<!--The namespace is added in /start box2-->
 +
| template page = {{documentation/template page}}
 +
 
 +
}}<!-- Start content --><!--
 +
  Start load the /doc content:
 +
  Note: The line breaks between this comment and the next line are necessary
 +
  so  "=== Headings ===" at the start and end of docs are interpreted.
 +
-->
 +
{{#switch: {{#if:{{{content|}}}|1|0}}{{#if:{{{1|}}}|1|0}}{{#ifexist:{{{1|}}}|1|0}}{{#ifexist:{{documentation/docspace}}:{{documentation/template page}}/doc|1|0}}
 +
| 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110
 +
| 1111 = {{{content|}}}
 +
| 0110 | 0111 = {{ {{{1}}} }}
 +
| 0001 | 0011 = {{ {{documentation/docspace}}:{{documentation/template page}}/doc }}
 +
| 0000 | 0100 | 0010 | 0101 =  
 +
}}
 +
<!--
 +
  End load the /doc content:
 +
  Note: The line breaks between this comment and the previous line are necessary
 +
  so  "=== Headings ===" at the start and end of docs are interpreted.
 +
-->{{documentation/end box2
 +
| preload = {{{preload|}}}   <!--Allow custom preloads-->
 +
| content = {{{content|}}}
 +
| link box = {{{link box|}}}   <!--So "link box=off" works-->
 +
 
 +
<!--Some namespaces must have the /doc, /sandbox and /testcases
 +
     in talk space-->
 +
| docspace = {{documentation/docspace}}
 +
 
 +
| 1 = {{{1|}}}   <!--Other docname, if fed-->
 +
 
 +
<!--The namespace is added in /end box2-->
 +
| template page = {{documentation/template page}}
 +
 
 +
}}<!--
 +
  End of green doc box
 +
--><noinclude>
 +
 
 +
<!-- Add categories and interwikis to the /doc subpage, not here! -->
 +
</noinclude>

Revision as of 12:40, 2 February 2013

[view] [edit] [history] [purge] 50px Template documentation
Description
This template is used to insert documentation on template pages.
Syntax
Type <noinclude>{{documentation}}</noinclude> at the end of the template page.

General usage

On the Template page

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

On the Template/doc page

See also Template:Documentation/preload
{{SPW|name={{subst:BASEPAGENAME}}}}
;Description
:This template is used to do something.
;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|{{PAGENAME}}]]</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}}.

The above documentation is transcluded from Template:Documentation/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Please add categories and interwikis to the /doc subpage. Subpages of this template.