Difference between revisions of "Template:Documentation subpage"

From SVR Wiki
Jump to: navigation, search
(add id for people who do not need the message)
m (Changed protection level of Template:Documentation subpage: allow template editors ([Edit=Allow only template editors and admins] (indefinite) [Move=Allow only template editors and admins] (indefinite)))
(89 intermediate revisions by 40 users not shown)
Line 1: Line 1:
{{#ifeq:{{lc:{{SUBPAGENAME}}}}|{{{override|doc}}}|
+
<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
<!-- on documentation subpages -->
+
  | <!-- doc page -->
<table style="width:100%; border:1px solid #CCC;">
+
</includeonly>{{
  <tr style="vertical-align:top;">
+
    #ifeq: {{{doc-notice|show}}} | show
     <td style="width:30px;"> [[Image:Edit-paste.svg|30px]]</td>
+
     | {{mbox
    <td>This is a [[template:documentation|documentation subpage]], where instructions, categories, or other information are stored for [[Project:Template limits|technical reasons]]. To view the {{SUBJECTSPACE}} page itself, see {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}.</td>
+
      | type = notice
  </tr>
+
      | image = [[File:Edit-copy green.svg|40px]]
</table>{{#if: {{{inhib|{{{inhibit|}}}}}} |<!-- skip -->|[[category:Documentation subpages<noinclude>| {{PAGENAME}}</noinclude>]]}}
+
      | 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}}}}}}}}.
<!-- on template pages -->
+
      }}
<span id="template_doc_page_transcluded">''This [[Wikipedia:Template documentation|documentation]] is [[Wikipedia:Transclusion|transcluded]] from {{{2|[[{{FULLPAGENAME}}/doc]]}}}''.</span>{{#ifexist: {{#rel2abs: /sandbox }}| {{#ifexist: {{#rel2abs: /testcases}}| <br>''This template has a [[/sandbox|sandbox]]'' <small>([{{fullurl:{{FULLPAGENAME}}/sandbox|action=edit}} edit])</small> ''and [[/testcases|testcases]]'' for editors to experiment.}}<!-- else don't show when just 1 of /sandbox or /testcases exists -->}}
+
    }}{{DEFAULTSORT:{{{defaultsort|{{PAGENAME}}}}}}}{{
}}<noinclude>
+
    #if: {{{inhibit|}}}
{{pp-semi-template|small=yes}}
+
    | <!-- skip -->
 +
    | <includeonly>{{#ifexist:{{NAMESPACE}}:{{BASEPAGENAME}}|[[Category:{{
 +
      #switch: {{SUBJECTSPACE}}
 +
      | Template  = Template
 +
      | Module  = Module
 +
      | User      = User
 +
      | #default  = Wikipedia
 +
    }} documentation pages]]|[[Category:Documentation subpages without corresponding pages]]}}</includeonly>
 +
  }}<includeonly>
 +
| <!-- if not on a /doc subpage, do nothing -->
 +
}}</includeonly><noinclude>
 
{{documentation}}
 
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
+
<!-- Add categories to the /doc subpage, not here! -->
 
</noinclude>
 
</noinclude>

Revision as of 21:07, 14 May 2014

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.