Difference between revisions of "Help:Templates"

From Nookipedia, the Animal Crossing wiki
m (Text replacement - "{{NLa" to "{{NLWa")
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
{{Help}}
 
{{Help}}
This article is all about using templates on Nookipedia. It will teach you how to add and use templates in articles.  
+
This article is all about using '''templates on Nookipedia'''. It will teach you how to add and use templates in articles.  
  
 
==What is a template?==
 
==What is a template?==
 +
A template allows information stored on one page of the wiki to be displayed on another page. This process is called transclusion and is signaled by a template tag – a string surrounded by two braces on either side (e.g. {{t|roundy}}).
  
A template is a CSS/HTML code which has been saved in a manner so that you don't have to type it out every time you want to add it to an article. Take the Help Navigation Box. It is a custom modified navigation box template. Although the natural template has a red color, the help box has been changed to blue. Some templates also add articles to categories so you don't need to write the code for that.
+
====Why do we use templates?====
Adding and Using Templates
+
Templates function as a sort of shorthand so that long or frequently used strings of text, HTML and/or CSS code do not need to be typed repeatedly. They are often used when information needs to be organized consistently across multiple pages, usually in the form of tables, lists, or other containers of information. They can also be used to more quickly apply formatting to text (e.g. {{t|PG}} produces {{PG}}), or to automatically add articles to categories.
  
Most site/high traffic related templates are protected for admin editing so that they don't get vandalised, but all userboxes are not protected so anyone can add them to their profile. To add a template you can just add <nowiki>{{ and }}</nowiki> around a template name such as the roundy template. The template will automatically show up (to the latest incarnation of it anyway) to the users.
+
====How do I use templates?====
 +
To use a template it must be correctly called using the template tag. First, determine the template to be called. To search for a template, type "Template:" in the search bar, check the list of [https://nookipedia.com/wiki/Special:PrefixIndex?prefix=&namespace=10 all Nookipedia templates], or search for a [[:Category:Templates|template by category]]. All templates contain the "Template:" identifier, and it is an optional component of a template tag (e.g. both {{[[Template:roundy]]}} and {{t|roundy}} are valid template calls).
  
==Userboxes?==
+
Once you've determined which template to use, place brackets <code>{{ }}</code> on either side of the template name. If the template is not transcluded onto the page, and instead you receive something like this – {{test}}, a link to a template that doesn't exist, then the template name you used is incorrect (check caps and spaces). A major advantage to using templates is that they can be updated, and these changes will take effect immediately on any page the template appears on. (If it doesn't, try purging the page's cache by clicking edit on the page and then replacing "&action=edit" at the end of the URL with "&action=purge" and pressing enter.)
  
Userboxes are boxes that have been made by modifying the userbox template. You can create your own and add it to your profile and then to category for others to do the same.
+
==Creating templates==
 +
Template pages are created the same way any other page is created. Begin by typing in your desired template name into the search bar preceded by the word "Template:". All templates must start with this identifier in order to function as a template instead of an article page. If the template does not already exist, click the link provided to create the new page.
  
 +
The template's code should be typed into the wikitext editor. Remember that anything you type here will be "cut and pasted" into another page whenever this template is called. For example, if you create a template with the name <nowiki>{{test}}</nowiki> and put "This is a test." on the template page, whenever someone calls <nowiki>{{test}}</nowiki> it will produce "This is a test." on the page. Just like any other page on the wiki, templates can take advantage of HTML and CSS code allowing them to perform complex functions.
 +
 +
Extensive information on template creation can be found in the [[Help:Templates#Resources|Resources]] section at the bottom of the page.
 +
 +
==Template documentation==
 +
Whenever a new template is created, documentation on how to use it should also be provided. This documentation should explain its main features, give example use-cases, and note any parameters required for the template to function correctly. Each template author may choose their own documentation style, whether that is creating a [[Template:Calendar/doc|separate documentation page]], or placing the documentation [[Template:A-card|directly into the template page]].
 +
 +
To make sure only the template code is transcluded when the template is called (and not the associated documentation), you can use <code><nowiki><noinclude></nowiki></code> or <code><nowiki><onlyinclude></nowiki></code> to perform a partial transclusion. More information is available at [[wikipedia:Wikipedia:Transclusion|Wikipedia:Transclusion]]. The HTML <code><nowiki><pre></nowiki></code> tag may be helpful to generate template usage examples, or you can selectively control wikicode function using <code><nowiki><nowiki></nowiki></code> around code you don't want to function (and therefore remain visible to readers). The [[Template:T|<nowiki>{{t}}</nowiki> template]] is helpful when linking to other templates that may be related to the template you've created.
 +
 +
==Types of templates==
 +
===Navigation templates===
 +
:''See all [[:Category:Navbox_templates|navigation templates]]''
 +
Also known as navbox templates, these simple templates group links of related pages together and facilitate navigation. They are placed on pages which share a similar theme or feature similar content, as is the case with the {{t|Animal Crossing}} or {{t|Dog}} templates. Navbox templates do not generally accept parameters.
 +
 +
===Infobox templates===
 +
:''See all [[:Category:Infobox templates|infobox templates]]''
 +
Infobox templates generate information containers with fields relevant to a particular topic, such as [[Template:Infobox Species]]. These templates contain modifiable parameters in order to display the necessary information.
 +
 +
===Notice templates===
 +
:''See all [[:Category:Notice Templates|notice templates]]
 +
Notice templates are placed in articles to provide users information about a page's condition. Some contain parameters for users to fill in to customize the information displayed..
 +
 +
===Userbox templates===
 +
:''See all [[:Nookipedia:Userboxes|userboxes]]''
 +
Userboxes are fun profile templates for your userpage. They are quick and attractive ways to tell others about yourself.
 +
 +
==Common Nookipedia templates==
 +
The following lists give examples of some of the more commonly used templates on the wiki.
 +
 +
===Linking to game pages===
 +
:''See also: [[:Category:Link templates]]''
 +
 +
We have templates that create properly formatted links to each Animal Crossing game (spinoffs included).
 +
 +
{|
 +
! colspan=3, style="text-align:center" | Main series titles
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{SER}}</nowiki></tt>
 +
| →
 +
| {{SER}}
 +
|-
 +
|
 +
|-
 +
|
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{DnM}}</nowiki></tt>
 +
| →
 +
| {{DnM}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{PG}}</nowiki></tt>
 +
| →
 +
| {{PG}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{DnMe+}}</nowiki></tt>
 +
| →
 +
| {{DnMe+}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{CF}}</nowiki></tt>
 +
| →
 +
| {{CF}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{WW}}</nowiki></tt>
 +
| →
 +
| {{WW}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{NL}}</nowiki></tt>
 +
| →
 +
| {{NL}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{NLWa}}</nowiki></tt>
 +
| →
 +
| {{NLWa}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{NH}}</nowiki></tt>
 +
| →
 +
| {{NH}}
 +
|-
 +
! colspan=3, style="text-align:center" | <br>Spinoff titles
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{SD}}</nowiki></tt>
 +
| →
 +
| {{SD}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{HHD}}</nowiki></tt>
 +
| →
 +
| {{HHD}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{AMF}}</nowiki></tt>
 +
| →
 +
| {{AMF}}
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{PC}}</nowiki></tt>
 +
| →
 +
| {{PC}}
 +
|-
 +
! colspan=3, style="text-align:center" | <br>Other media
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{Film}}</nowiki></tt>
 +
| →
 +
| {{Film}}
 +
|-
 +
|
 +
|}
 +
 +
===Page formatting===
 +
These templates are used to format text or change the way elements on the page are arranged.
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{main|Help:Contents}}</nowiki></tt>
 +
| →
 +
| {{main|Help:Contents}}
 +
|}
 +
*Used in article subsections to link to a subject's main article that contains more detailed information.
 +
{|
 +
|-
 +
|
 +
|-
 +
|
 +
|}
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{wrongpage|Templates|any other kind of plate|Tom Nook's store}}</nowiki></tt>
 +
| →
 +
| {{wrongpage|Templates|any other kind of plate|Tom Nook's store}}
 +
|}
 +
*Used at the top of an article to direct readers to pages with a similar title.
 +
{|
 +
|-
 +
|
 +
|-
 +
|
 +
|}
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{clear}}</nowiki></tt>
 +
| →
 +
| No visual manifestation.
 +
|}
 +
*This template makes sure that different elements on the page don't get in each other's way. If an image or other block-level element would overlap one another, this template will preserve the space in between them.
 +
{|
 +
|-
 +
|
 +
|-
 +
|
 +
|}
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{quote|Promises are like pie crusts - they're made to be broken.|Pecan|{{NL}}}}</nowiki></tt>
 +
| →
 +
| {{quote|Promises are like pie crusts - they're made to be broken.|Pecan|{{NL}}}}
 +
|}
 +
*Used to quote characters. Quote comes first, then who said it, finally the game they said it in.
 +
{|
 +
|-
 +
|
 +
|-
 +
|
 +
|}
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{roundy}}</nowiki></tt>
 +
| →
 +
|
 +
{| style="background-color:#ccc; {{roundy}}"
 +
|
 +
!Example
 +
|
 +
|}
 +
|}
 +
*Inserted as a CSS style to make elements rounded. Almost all the elements that have rounded corners on [[Nookipedia]] are created using this template. Can also be applied to one side (e.g. [[template:roundyright|roundyright]]) or one corner (e.g. [[template:roundybr|roundybr]]).
 +
 +
===Other notable templates===
 +
{|
 +
|-
 +
|
 +
|-
 +
|
 +
|}
 +
{|
 +
| style="text-align:right" | <tt><nowiki>{{(!}}</nowiki></tt>
 +
| →
 +
| <nowiki>{|</nowiki>
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{!)}}</nowiki></tt>
 +
| →
 +
| <nowiki>|}</nowiki>
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{!}}</nowiki></tt>
 +
| →
 +
| <nowiki>|</nowiki>
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{!-}}</nowiki></tt>
 +
| →
 +
| <nowiki>|-</nowiki>
 +
|-
 +
| style="text-align:right" | <tt><nowiki>{{=}}</nowiki></tt>
 +
| →
 +
| =
 +
|}
 +
*Used in templates when trying to insert tables or CSS formatting into parser functions.
 +
 +
==Resources==
 +
* [[wikipedia:Wikipedia:Transclusion|Wikipedia:Transclusion]]
 +
* [http://meta.wikimedia.org/wiki/Help:Template Help:Template] - General help for template creation.
 +
* [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions Help:Extension:ParserFunctions] - Help for Parser Functions, a wiki extension that allows for more complex coding functions.
 +
<br clear=all>
 +
{{nookipedia}}
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 01:20, January 7, 2021

This article is all about using templates on Nookipedia. It will teach you how to add and use templates in articles.

What is a template?

A template allows information stored on one page of the wiki to be displayed on another page. This process is called transclusion and is signaled by a template tag – a string surrounded by two braces on either side (e.g. {{roundy}}).

Why do we use templates?

Templates function as a sort of shorthand so that long or frequently used strings of text, HTML and/or CSS code do not need to be typed repeatedly. They are often used when information needs to be organized consistently across multiple pages, usually in the form of tables, lists, or other containers of information. They can also be used to more quickly apply formatting to text (e.g. {{PG}} produces Animal Crossing), or to automatically add articles to categories.

How do I use templates?

To use a template it must be correctly called using the template tag. First, determine the template to be called. To search for a template, type "Template:" in the search bar, check the list of all Nookipedia templates, or search for a template by category. All templates contain the "Template:" identifier, and it is an optional component of a template tag (e.g. both {{Template:roundy}} and {{roundy}} are valid template calls).

Once you've determined which template to use, place brackets {{ }} on either side of the template name. If the template is not transcluded onto the page, and instead you receive something like this – Template:Test, a link to a template that doesn't exist, then the template name you used is incorrect (check caps and spaces). A major advantage to using templates is that they can be updated, and these changes will take effect immediately on any page the template appears on. (If it doesn't, try purging the page's cache by clicking edit on the page and then replacing "&action=edit" at the end of the URL with "&action=purge" and pressing enter.)

Creating templates

Template pages are created the same way any other page is created. Begin by typing in your desired template name into the search bar preceded by the word "Template:". All templates must start with this identifier in order to function as a template instead of an article page. If the template does not already exist, click the link provided to create the new page.

The template's code should be typed into the wikitext editor. Remember that anything you type here will be "cut and pasted" into another page whenever this template is called. For example, if you create a template with the name {{test}} and put "This is a test." on the template page, whenever someone calls {{test}} it will produce "This is a test." on the page. Just like any other page on the wiki, templates can take advantage of HTML and CSS code allowing them to perform complex functions.

Extensive information on template creation can be found in the Resources section at the bottom of the page.

Template documentation

Whenever a new template is created, documentation on how to use it should also be provided. This documentation should explain its main features, give example use-cases, and note any parameters required for the template to function correctly. Each template author may choose their own documentation style, whether that is creating a separate documentation page, or placing the documentation directly into the template page.

To make sure only the template code is transcluded when the template is called (and not the associated documentation), you can use <noinclude> or <onlyinclude> to perform a partial transclusion. More information is available at Wikipedia:Transclusion. The HTML <pre> tag may be helpful to generate template usage examples, or you can selectively control wikicode function using <nowiki> around code you don't want to function (and therefore remain visible to readers). The {{t}} template is helpful when linking to other templates that may be related to the template you've created.

Types of templates

Navigation templates

See all navigation templates

Also known as navbox templates, these simple templates group links of related pages together and facilitate navigation. They are placed on pages which share a similar theme or feature similar content, as is the case with the {{Animal Crossing}} or {{Dog}} templates. Navbox templates do not generally accept parameters.

Infobox templates

See all infobox templates

Infobox templates generate information containers with fields relevant to a particular topic, such as Template:Infobox Species. These templates contain modifiable parameters in order to display the necessary information.

Notice templates

See all notice templates

Notice templates are placed in articles to provide users information about a page's condition. Some contain parameters for users to fill in to customize the information displayed..

Userbox templates

See all userboxes

Userboxes are fun profile templates for your userpage. They are quick and attractive ways to tell others about yourself.

Common Nookipedia templates

The following lists give examples of some of the more commonly used templates on the wiki.

Linking to game pages

See also: Category:Link templates

We have templates that create properly formatted links to each Animal Crossing game (spinoffs included).

Main series titles
{{SER}} Animal Crossing series
{{DnM}} Doubutsu no Mori
{{PG}} Animal Crossing
{{DnMe+}} Doubutsu no Mori e+
{{CF}} Animal Crossing: City Folk
{{WW}} Animal Crossing: Wild World
{{NL}} Animal Crossing: New Leaf
{{NLWa}} Animal Crossing: New Leaf - Welcome amiibo
{{NH}} Animal Crossing: New Horizons

Spinoff titles
{{SD}} Animal Crossing: Sweet Day
{{HHD}} Animal Crossing: Happy Home Designer
{{AMF}} Animal Crossing: amiibo Festival
{{PC}} Animal Crossing: Pocket Camp

Other media
{{Film}} 🎬 Gekijōban Doubutsu no Mori

Page formatting

These templates are used to format text or change the way elements on the page are arranged.

{{main|Help:Contents}}
Main article: Help:Contents
  • Used in article subsections to link to a subject's main article that contains more detailed information.
{{wrongpage|Templates|any other kind of plate|Tom Nook's store}}
This article is about Templates. For any other kind of plate, see Tom Nook's store.
  • Used at the top of an article to direct readers to pages with a similar title.
{{clear}} No visual manifestation.
  • This template makes sure that different elements on the page don't get in each other's way. If an image or other block-level element would overlap one another, this template will preserve the space in between them.
{{quote|Promises are like pie crusts - they're made to be broken.|Pecan|{{NL}}}}
"Promises are like pie crusts - they're made to be broken."
— Pecan, Animal Crossing: New Leaf
  • Used to quote characters. Quote comes first, then who said it, finally the game they said it in.
{{roundy}}
Example
  • Inserted as a CSS style to make elements rounded. Almost all the elements that have rounded corners on Nookipedia are created using this template. Can also be applied to one side (e.g. roundyright) or one corner (e.g. roundybr).

Other notable templates

{{(!}} {|
{{!)}} |}
{{!}} |
{{!-}} |-
{{=}} =
  • Used in templates when trying to insert tables or CSS formatting into parser functions.

Resources