Difference between revisions of "Template:Template Overview"

m
m (Turns out the Clear was dumb, but the NOEDITSECTION was important.)
 
(12 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
|display=
 
|display=
 
|parameters=
 
|parameters=
 +
|category=
 
}}</nowiki>
 
}}</nowiki>
|display=no
+
|category=Information
|parameters=yes
+
 
}}
 
}}
 
{{Template Parameter
 
{{Template Parameter
Line 50: Line 50:
 
|denotes=whether an example of the template should be displayed
 
|denotes=whether an example of the template should be displayed
 
|generates=the "Display" section
 
|generates=the "Display" section
|validvalues="yes" or "no"
+
|validvalues="yes" to automatically display the template in its entirety, or any string or strings making up the display of the template.
 
}}
 
}}
 
{{Template Parameter
 
{{Template Parameter
Line 57: Line 57:
 
|takes=a string
 
|takes=a string
 
|denotes=whether the template has parameters or not
 
|denotes=whether the template has parameters or not
|generates=either a blank space beneath the "Parameters" section if a "yes" is supplied, or a boilerplate message indicating that there are no parameters if a "no" is supplied
+
|generates=either a blank space beneath the "Parameters" section if the parameter is left out or left blank, or a boilerplate message indicating that there are no parameters if a "none" is supplied
|validvalues="yes" or "no"
+
|validvalues="none" or blank
 
}}
 
}}
[[Category:Information Templates|{{PAGENAME}}]]</noinclude><includeonly>__NOEDITSECTION__
+
{{Template Parameter
 +
|name=category
 +
|usage=mandatory
 +
|takes=a string
 +
|denotes=the template-related category in which to place the template
 +
|generates=the template page's category
 +
|validvalues=Any string or strings.
 +
}}
 +
</noinclude><includeonly>__NOEDITSECTION__
 
{{tocright}}
 
{{tocright}}
 
[[{{NAMESPACE}}:{{PAGENAME}}]] is designed for use on {{{usedon}}} pages to {{{purpose}}}. {{#if: {{{othernotes|}}} | {{{othernotes}}} | }}
 
[[{{NAMESPACE}}:{{PAGENAME}}]] is designed for use on {{{usedon}}} pages to {{{purpose}}}. {{#if: {{{othernotes|}}} | {{{othernotes}}} | }}
 
 
==Template==
 
==Template==
 
{{Pre | {{{template}}} }}
 
{{Pre | {{{template}}} }}
{{#switch: {{{display}}}
+
{{#if: {{{display|}}}
| yes = ==Display==
+
| {{#ifeq: {{{display}}} | yes
{{{{PAGENAME}}}}
+
  | ==Display==
| no
+
{{ {{PAGENAME}} }}
| #default =
+
  | ==Display==
 +
{{{display}}}
 +
  }}
 
}}
 
}}
 
==Parameters==
 
==Parameters==
 
{{#switch: {{{parameters}}}
 
{{#switch: {{{parameters}}}
| no = This template has no parameters.
+
| none = This template has no parameters.
| yes
+
|  
 
| #default =  
 
| #default =  
}}</includeonly>
+
}}
 +
{{Categorize|{{{category}}} Templates}}</includeonly>

Latest revision as of 22:14, 2 January 2012

Template:Template Overview is designed for use on template pages to display the general template information and the required template text for copying, pasting, and using in pages.

Template

{{Template Overview
|usedon=
|purpose=
|othernotes=
|template=
|display=
|parameters=
|category=
}}

Parameters

usedon

  • Usage: Mandatory
  • Description: The usedon parameter takes a string or strings denoting the type or types of pages this template is designed for use on. This is used to generate the middle of the template description's introductory sentence.
  • Valid Value(s): Any string or strings.

purpose

  • Usage: Mandatory
  • Description: The purpose parameter takes a string or strings denoting what the template was designed to do or display. This is used to generate the end of the template description's introductory sentence.
  • Valid Value(s): Any string or strings.

othernotes

  • Usage: Optional
  • Description: The othernotes parameter takes a string or strings denoting any further relevant information about the usage or functionality of the template. This is used to generate a sentence or sentences after the template description's introductory sentence.
  • Valid Value(s): Any string or strings.

template

  • Usage: Mandatory
  • Description: The template parameter takes a string or strings denoting the actual text of the template that a user must copy and paste onto a page in order to use the template. This is used to generate the "Template" section. When entered into the Template Explanation template, the template's transclusion code must be enclosed in <nowiki></nowiki> tags, or else the template itself will be transcluded into the <pre></pre> block.
  • Valid Value(s): The text of the template for transclusion enclosed by <nowiki></nowiki> tags.

display

  • Usage: Optional
  • Description: The display parameter takes a string denoting whether an example of the template should be displayed. This is used to generate the "Display" section.
  • Valid Value(s): "yes" to automatically display the template in its entirety, or any string or strings making up the display of the template.

parameters

  • Usage: Mandatory
  • Description: The parameters parameter takes a string denoting whether the template has parameters or not. This is used to generate either a blank space beneath the "Parameters" section if the parameter is left out or left blank, or a boilerplate message indicating that there are no parameters if a "none" is supplied.
  • Valid Value(s): "none" or blank

category

  • Usage: Mandatory
  • Description: The category parameter takes a string denoting the template-related category in which to place the template. This is used to generate the template page's category.
  • Valid Value(s): Any string or strings.