View source for Help:Template

Here are some nice templates, [https://wiki.archlinux.org/index.php/Help:Template borrowed from the Arch Wiki].

These templates cut down on ugly wikitext, reduce duplication of effort, and make the wiki look much nicer.

==Usage==

Templates are used by adding the following markup to an article:

{{bc|<nowiki>{{Template name}}</nowiki>}}

Most templates take additional arguments, such as [[Template:Note]]:

{{bc|<nowiki>{{Note|This text should be noted.}}</nowiki>}}

which produces:

{{Note|This text should be noted.}}

Some templates use named parameters, such as [[Template:hc]]:

{{bc|<nowiki>{{hc|head=/etc/rc.local|output=exit 0}}</nowiki>}}

which produces:

{{hc|head=/etc/rc.local|output=exit 0}}

The general format is:

{{bc|<nowiki>{{Template name|param1|param2|...|paramN}}</nowiki>}}

See each template's page for specific usage instructions.

===Style===
* Templates should be used with the capitalization shown in the examples in their pages, for example {{ic|&#123;{Pkg&#124;...}} and {{ic|&#123;{ic&#124;...}} are correct, while {{ic|&#123;{pkg&#124;...}} and {{ic|&#123;{Ic&#124;...}} are not.
* There should be no spaces around the template name: {{ic|&#123;{Template name&#124;...}} is correct, while for example {{ic|&#123;{ Template name &#124;...}} is not.
* Templates should not be categorized.

===Escape template-breaking characters===

There are some characters that, if used inside a template, will break its output: most frequently this happens with "=" (the equal sign) and "|" (the pipe sign). Solutions to this problem are described below.

==== Named parameters ====
If the problem is only with "=" signs, the recommended solution is to explicitly introduce template parameters with their names or positional numbers. This is very useful with query strings in URLs or variable definitions, but will not work for other offending characters, like "|". For example:

{{bc|<nowiki>{{Tip|1=https://www.archlinux.org/?foo=bar}}</nowiki>}}

{{Tip|1=https://www.archlinux.org/?foo=bar}}

Or, with multiple parameters:

{{bc|<nowiki>{{hc|1=$ echo "="|2==}}</nowiki>}}

{{bc|<nowiki>{{hc|head=$ echo "="|output==}}</nowiki>}}

{{hc|1=$ echo "="|2==}}

==== nowiki tags ====
If you are having problems with characters other than "=", e.g. "|", the recommended solution is to enclose the whole parameter in {{ic|<nowiki><nowiki></nowiki>}} tags. This method displays all kinds of characters, but completely prevents the wiki engine from processing text markup, such as links and other templates. For example:

{{bc|<nowiki>{{Tip|&lt;nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}&lt;/nowiki>}}</nowiki>}}

{{Tip|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}

Enclosing only specific parts (or even single characters) in {{ic|<nowiki><nowiki></nowiki>}} tags still works of course, but for readability it is recommended to use such method only if links or other templates have to be normally displayed. For example:

{{bc|<nowiki>{{Tip|&lt;nowiki>= | }}&lt;/nowiki> https://www.archlinux.org/ {{ic|foo}}}}</nowiki>}}

{{Tip|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}

==== HTML entities ====
Replacing the offending characters with their respective HTML entities always works, but since it reduces the readability of the source text, it is recommended only when the solutions above are not practicable. For example:

{{bc|<nowiki>{{Tip|&amp;#61; &amp;#124; &amp;#125;&amp;#125;}}</nowiki>}}

{{Tip|&#61; &#124; &#125;&#125;}}

==Creation==

{{Note|
*Only create relevant templates. If you are attempting to create a very specialized template that will likely only ever be used on a few articles, please do not bother, avoid cluttering up the templates namespace.
*Only create concise templates. Remember [[The Arch Way]]: Keep It Simple, Stupid!}}

The following template should be used when creating new templates to facilitate usage and editing:

{{bc|<nowiki><noinclude>{{Template}}

'''A brief description of the template'''

====Usage====

{{ic|&lt;nowiki&gt;{{Template name|param1|param2|...|paramN}}&lt;/nowiki&gt;}}

====Example====

{{Template name|param1|param2|...|paramN}}</noinclude><includeonly>Template code goes here...</includeonly></nowiki>}}

To begin the creation process, simply visit [[:Template:Template name]] (substituting {{ic|Template name}} with the desired name of the template), [[Help:Editing|edit, and add the relevant wikitext]].

== List of templates ==
The templates that users can use directly in articles on the ArchWiki are listed below. Click on the links to see their detailed usage. For a list that also includes localizations and meta templates see [[Special:AllPages/Template:]], [[Special:PrefixIndex/Template:]] or [[Special:MostLinkedTemplates]].

{{Warning|Please do not experiment with existing templates. If you want to edit a non-protected template, copy the text to [[Template:Sandbox]], edit and test it there, and copy it back when it works. It is strongly recommended (and necessary for protected templates) to suggest any modifications on discussion pages first.}}

=== Article status templates ===

* [[Template:Accuracy]]
* [[Template:Bad translation]]
* [[Template:Deletion]]
* [[Template:Expansion]]
* [[Template:Merge]]
* [[Template:Moveto]]
* [[Template:Out of date]]
* [[Template:Poor writing]]
* [[Template:Stub]]
* [[Template:Translateme]]

=== Code formatting templates ===

* [[Template:ic]]
* [[Template:bc]]
* [[Template:hc]]

=== Note templates ===

* [[Template:Note]]
* [[Template:Tip]]
* [[Template:Warning]]