Difference between revisions of "Template:Documentation subpage"

From SVR Wiki
Jump to: navigation, search
m (3 revisions imported: Template as of)
m (Protected Template:Documentation subpage: Highly visible template ([edit=sysop] (indefinite) [move=sysop] (indefinite)))
(27 intermediate revisions by 18 users not shown)
Line 1: Line 1:
<includeonly><!--
+
<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
-->{{#ifeq:{{lc:{{SUBPAGENAME}}}} |{{{override|doc}}}
+
  | <!-- doc page -->
    | <!--(this template has been transcluded on a /doc or /{{{override}}} page)-->
+
</includeonly>{{
</includeonly><!--
+
    #ifeq: {{{doc-notice|show}}} | show
 
+
    | {{mbox
      -->{{#ifeq:{{{doc-notice|show}}} |show
+
      | type = notice
          | {{Mbox
+
      | image = [[File:Edit-copy green.svg|40px]]
            | type = notice
+
      | text =  
            | style = margin-bottom:1.0em;
+
'''This is a documentation 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, [[Help:Categories|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}}}}}}}}.  
            | image = [[File:Edit-copy green.svg|40px|alt=|link=]]
+
      }}
            | text =
+
    }}{{DEFAULTSORT:{{{defaultsort|{{PAGENAME}}}}}}}{{
'''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}}}}}}}}.  
+
    #if: {{{inhibit|}}}
            }}
+
    | <!-- skip -->
        }}<!--
+
    | [[Category:{{
 
+
      #if: {{SUBJECTSPACE}}
      -->{{DEFAULTSORT:{{{defaultsort|{{PAGENAME}}}}}}}<!--
+
      | {{SUBJECTSPACE}}
 
+
      | Article
      -->{{#if:{{{inhibit|}}} |<!--(don't categorize)-->
+
    }} documentation<noinclude>| </noinclude>]]
          |   <includeonly><!--
+
  }}<includeonly>
              -->{{#ifexist:{{NAMESPACE}}:{{BASEPAGENAME}}
+
| <!-- if not on a /doc subpage, do nothing -->
                  | [[Category:{{#switch:{{SUBJECTSPACE}} |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
+
}}</includeonly><noinclude>
                  | [[Category:Documentation subpages without corresponding pages]]
+
{{documentation}}
                  }}<!--
+
<!-- Add categories to the /doc subpage, not here! -->
          --></includeonly>
+
</noinclude>
        }}<!--
 
 
 
(completing initial #ifeq: at start of template:)
 
--><includeonly>
 
    | <!--(this template has not been transcluded on a /doc or /{{{override}}} page)-->
 
    }}<!--
 
--></includeonly><noinclude>{{Documentation}}</noinclude>
 

Revision as of 16:04, 4 August 2010

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

Usage

{{documentation subpage}}

OR

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

Customization of text

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

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.