Badge time.png   The Paragon Wiki Archive documents the state of City of Heroes/Villains as it existed on December 1, 2012.

Difference between revisions of "Help:Templates"

From Paragon Wiki Archive
Jump to: navigation, search
(update section on template documentation)
m (Simple Template documentation: tweaks)
Line 67: Line 67:
 
  {{green|''[--last line of your template code--]''}}<nowiki><noinclude>
 
  {{green|''[--last line of your template code--]''}}<nowiki><noinclude>
 
<!-- PLEASE ADD EXPLANATORY TEXT AND CATEGORIES HERE, THANKS -->
 
<!-- PLEASE ADD EXPLANATORY TEXT AND CATEGORIES HERE, THANKS -->
=== Usage ===
+
== Usage ==
  
=== Examples ===
+
== Examples ==
  
 +
[[Category:Category Name]]
 
</noinclude></nowiki>
 
</noinclude></nowiki>
  
 
Note that the ''noinclude'' tag must follow the last character of the Template coding so that extraneous carriage returns or spaces are not called by the Template command.
 
Note that the ''noinclude'' tag must follow the last character of the Template coding so that extraneous carriage returns or spaces are not called by the Template command.
  
This explanatory text will then appear on the Template page but will not be included on the target page in which the Template is used. In these cases, the author should add Category tags in between the ''noinclude'' tags also, for example, [[:Category: Mission Templates]].
+
This explanatory text will then appear on the Template page but will not be included on the target page in which the Template is used. In these cases, the author should add Category tags in between the ''noinclude'' tags also; for example, [[[[:Category: Mission Templates]]]].
 
+
  
 
=== Separate Template documentation page ===
 
=== Separate Template documentation page ===

Revision as of 22:42, 19 February 2010

Overview

Standardized formatting across Paragon Wiki is maintained by the use of sample markup language and templates.

Main article: Help:Contents


Sample markup language

Sample markup language is the use of a simple cut-and-paste of formatting code from one page into another and then adding or changing the content to fit the article. This can be done from a blank sample form or by cutting-and-pasting from an existing article.

An example of a blank form is that used for creating a new page for a contact which can be found here: Sample contact form.


Templates

Templates are specialized pages that define a specific type of formatting style. Templates are created in the Template: namespace. Editors can then call that template into a page and apply it to their text to make that text take on that pre-defined formatting. Templates are called with the double curly brackets {{ }} .

For example, on Paragon Wiki there are templates for colored fonts. The template for making text red is {{red|SampleText}} which would appear on a page as SampleText.

Templates also allow information that is duplicated in several pages to be located and edited in one place. For example, the mission Talk to David Wincott can come from just about any contact, and rather than type that information over and over, it has been created in one place, Template:Mission Hollows, and can then be inserted into any contact with the text, {{Mission Hollows}}.

Templates can also accept parameters, details which change from use to use. An example of this is the Power Template. This simple template takes four parameters, and formats the information into the power entry which is used on most of the enemy pages. Since the format is kept in one place, if, in the future, and new format is decided upon, rather than go through all the enemy pages and redoing their powers, one change to the power template will make those changes in the entire wiki.


Available templates and sample markup language

Samples

Templates

  • Useful Templates can help formatting various articles.
  • Mission Templates are templates covering common missions, such as story arcs, zone contact intros (such as David Wincott), and security chief intros. These missions can apply to multiple contacts. They have been templated for easy insertion and to avoid errors in duplication.
  • Contact Templates are templates that can be used to duplicate new contact introductions among contacts.
  • Userboxes are templates that can be placed on your userpage to indicate your interests.


Creating and Editing Templates

Since a change in a Template can possibly affect hundreds of pages, this means that Templates should be edited with great care. Templates are usually created with a mixture of html and wikipedia markup language. Editors who are unsure how to create a template or need help editing one should consult with other editors and administrators on the forums in the Formatting and Standardization Forum.

Editors can see how a Template is formatted by going to the Template:TemplateName page. The creator of the Template may have created an explanation of how the Template is coded; if not, then click on the edit tab to see the formatting language.

Categorizing Templates

Templates used on Paragon Wiki are categorized in a hierarchy tree beginning at Category: Templates

Template documentation

See Wikipedia article: Template documentation

Simple Template documentation

A Template can simply be the code or text that is called by its corresponding Template command. In such cases, when a Template page is viewed, it may appear to be blank or have some unprocessed parts of the coding appear on the page. Thus, in order to see what the code is, how it's constructed, and what parameters it takes; it must be viewed from the edit page of that Template.

The Template author can help other editors by including some documentation, that is, an explanation of the Template and how it's meant to be used and what parameters it takes. In order for such explanations to appear on the Template page without being called when the Template is used in target pages, the author will put the documentation between the <noinclude> </noinclude> tags. Here's an example of the code to be appended to the Template coding:

[--last line of your template code--]<noinclude>
<!-- PLEASE ADD EXPLANATORY TEXT AND CATEGORIES HERE, THANKS -->
== Usage ==

== Examples ==

[[Category:Category Name]]
</noinclude>

Note that the noinclude tag must follow the last character of the Template coding so that extraneous carriage returns or spaces are not called by the Template command.

This explanatory text will then appear on the Template page but will not be included on the target page in which the Template is used. In these cases, the author should add Category tags in between the noinclude tags also; for example, [[Category: Mission Templates]].

Separate Template documentation page

However, if the documentation for a Template is lengthy, complicated, used for several templates, or expected to be edited by others, then it is recommended that a separated documentation page be created for that Template in the /doc subpage of that Template. So, for example, the Template Template:MeritAward has the documentation subpage Template:MeritAward/doc.

In the Template page itself, this code is dropped in to automatically point to and transclude the contents of the document page:

[--last line of your template code--]<noinclude>
{{Documentation}}
<!-- PLEASE ADD THIS TEMPLATE'S CATEGORIES AND INTERWIKIS TO THE /doc SUBPAGE, THANKS -->
</noinclude>

Note that the noinclude tag must follow the last character of the Template coding so that extraneous carriage returns or spaces are not called by the Template command.

Then in the Template/doc page, this code is dropped in.

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

== Usage ==

== Examples ==

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->

</includeonly>

Category links that are placed between the includeonly tags on the documentation page become attached to the main Template page.

Since this can be a source of confusion, note that if a Category is placed on the Template page itself, it goes inside noinclude tags; and if the Category is being placed in the /doc subpage, then it goes inside includeonly tags. And for an advanced usage, Templates can automatically add categories into the page into which they are called, in such cases, the Category tag is part of the coding on the Template page (not the /doc page) and is surrounded by includeonly tags. For an example of the latter see {{Bug}} which puts a notice on a page that there is a bug, and also tags that page with the Bug Category.

See also: Documentation creation templates at Paragon Wiki