Template:Documentation subpage: Difference between revisions

From Gearhead Wiki
Jump to navigation Jump to search
(New page: {{#if:{{{Original-recipe|}}}{{{Orig|}}} |<!-- reconstruction of original Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-No...)
 
m (1 revision imported)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{#if:{{{Original-recipe|}}}{{{Orig|}}}
<includeonly><!--
|<!-- reconstruction of original  Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-November 2007 -->
-->{{#ifeq:{{lc:{{SUBPAGENAME}}}} |{{{override|doc}}}
<table  class="messagebox" style="line-height:1.1em;" style=" background:#f9f9b7;">
    | <!--(this template has been transcluded on a /doc or /{{{override}}} page)-->
<tr> <td rowspan="3" style="width:60px;text-align:center;" > [[Image:Edit-paste.svg|40px]]</td>
</includeonly><!--
<td> This is the [[Wikipedia:Template documentation|template documentation]]<!--
--> page for [[{{NAMESPACE}}:{{{1|{{BASEPAGENAME}}}}}]].</td></tr>
<tr><td><small>This page may not be intended to be viewed directly. <br/
>Links using [[Help:Variable|variable]]s may appear broken; do not replace these with [[hardcoded]] page names or URLs.</small></td></tr>
</table>{{#if:{{{inhib|x}}}{{{inhibit|}}}|<!-- skip --->|<includeonly>[[Category:Template documentation|{{PAGENAME}}]]</includeonly>
}}<!-- Please retain the above original template...


There are templates formulated to [[WP:DPP]] that need this.
      -->{{#ifeq:{{{doc-notice|show}}} |show
          | {{Mbox
            | type = notice
            | style = margin-bottom:1.0em;
            | image = [[File:Edit-copy green.svg|40px|alt=|link=]]
            | text =
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[:{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}'''.<br />It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{#if:{{{text2|}}} |{{{text2}}} |{{#if:{{{text1|}}} |{{{text1}}} |{{#ifeq:{{SUBJECTSPACE}} |{{ns:User}} |{{lc:{{SUBJECTSPACE}}}} template page |{{#if:{{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}.  
            }}
        }}<!--


Of course, if you all want to start updating all the interwiki exported templates, go on making things more incompatible... queries to User:Fabartus.
      -->{{DEFAULTSORT:{{{defaultsort|{{PAGENAME}}}}}}}<!--


--->
      -->{{#if:{{{inhibit|}}} |<!--(don't categorize)-->
|<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
          |  <includeonly><!--
  | <!-- doc page -->
              -->{{#ifexist:{{NAMESPACE}}:{{BASEPAGENAME}}
</includeonly>{{
                  | [[Category:{{#switch:{{SUBJECTSPACE}} |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
    #ifeq: {{{doc-notice|show}}} | show
                  | [[Category:Documentation subpages without corresponding pages]]
    | {{mbox
                  }}<!--
      | type = notice
          --></includeonly>
      | image = [[File:Edit-copy green.svg|40px]]
        }}<!--
      | text =
 
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}''' <small>(see that page for the {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template | {{ #if: {{SUBJECTSPACE}} | {{lc:{{SUBJECTSPACE}}}} | article }}}}}} itself)</small>.<br />It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{ #if: {{{text2|}}} | {{{text2}}} | {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template page | {{ #if: {{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}.
(completing initial #ifeq: at start of template:)
      }}
--><includeonly>
    }}{{DEFAULTSORT:{{{defaultsort|{{PAGENAME}}}}}}}{{
    | <!--(this template has not been transcluded on a /doc or /{{{override}}} page)-->
    #if: {{{inhibit|}}}
    }}<!--
    | <!-- skip -->
--></includeonly><noinclude>{{Documentation}}</noinclude>
    | [[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
  }}<includeonly>
| <!-- if not on a /doc subpage, do nothing -->
}}</includeonly><noinclude>
{{pp-template|small=yes}}
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>
}}

Latest revision as of 04:06, 2 November 2018

Template documentation[view] [edit] [history] [purge]

Usage[edit source]

{{documentation subpage}}

OR

{{documentation subpage|[[main page to link to]]}}

Userboxes[edit source]

When used to document usage of a userbox, it may be preferred to have this template state "userbox"/"userbox page" instead of "template"/"template page" or "user template"/"user template page". If this is preferred, use:

{{userbox documentation subpage}}

OR

{{userbox documentation subpage|[[main userbox page to link to]]}}

Customization of text[edit source]

To manually change the text of the template, the "text1=your text here" and/or "text2=your other text here" parameters can be specified. "text1=" changes the automatic text on the first line to your own word(s). "text2=" changes the automatic text on the second line to your own word(s). If "text1=" parameter is specified without the "text2=" parameter, both the first and second line of text will be custom based on the text given in the "text1=" parameter.

Example usage:

{{documentation subpage|text1=custom first and second line text}}
{{documentation subpage|text2=custom second line text only}}
{{documentation subpage|text1=custom first line text|text2=custom second line text}}

How it is displayed[edit source]

This template should be placed at the top of "/doc" pages. It changes output depending on where it is viewed:

  • On a "/doc" page, it displays a box explaining template documentation and links to the template page.
  • On other pages (ie, pages transcluding the "/doc" page), the template will not show. The template page itself (which contains {{Documentation}}) will automatically note that the documentation is transcluded from a subpage.

Functions[edit source]

In addition to the output message, the template categorizes pages to Category:Template documentation, Category:User documentation, or similar (named after the subject space), but only for documentation pages in namespaces with the subpage feature. It defaults the sort key to the page name without namespace (ie, "Foo" on "Template:Foo", so it would be sorted in categories under 'F').

See also[edit source]

General information about documentation for templates[edit source]

{{ Documentation }} family[edit source]

Template:Documentation subpage/doc (backlinks, edit)
Template:Documentation subpage/sandbox (backlinks, edit)
Template:Documentation subpage/testcases (backlinks, edit)

Meta Wiki {{ Documentation }} ancestor[edit source]