Wikia

GTA Wiki

Help:Templates

Talk0
9,770pages on
this wiki
Revision as of 10:03, June 12, 2011 by GTANiKo (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Templates are used on GTA Wiki as easy ways to instantly insert a particular set of instructions. Common usages are the messages at the top of the page (including this page), or Userboxes.

Templates are used by putting their tag at the top of the page, or wherever they are needed. A template's tag is its name in curly braces.

Templates are made simply by creating a page called Template:Name - and whatever is on that page will show up in every instance of the {{Name}} tag on GTA Wiki.

{{help}} shows up the banner at the top of this page. It is defined at Template:help, and automatically assigns any page it is used on to a category, which is Category:Help. Not all templates do this.

Whenever the template is edited, each page that uses that template will change too. If you do not wish to link back to the template page, you can use {{subst templatename}}. Subst simply includes the contents of templatename once.

Any page can be used as a template, by putting a colon (:) at the start of the tag. {{:User:Xenon}} would show the contents of the User:Xenon page. Also, subpages can be linked to directly with a slash (/) at the start of the tag. Grand Theft Auto IV quickly includes Grand Theft Auto IV/infobox with the tag {{/infobox}}.


View all templates

A template is a special type of page that has been designed so its content can be included in other pages. Since a given template can be included in many pages, it can help reduce duplication and promote a uniform style between pages.

Templates can be useful for...

  • Creating content that should appear on many pages.
  • Formatting content (such as infoboxes) in a way that should be consistent across many pages.
  • Creating a shortcut for writing things that you repeat often when communicating with others.
  • Replacing long, complicated code so that a page is easier for other users to edit.
  • Protecting parts of a page from editing while leaving other sections open for edits.

Templates are usually located in the Template namespace. This includes any page with a name beginning with Template:, such as Template:Name.

Video overview

If you're new to templates, this video will help you get started.

Introduction to Templates03:40

Introduction to Templates

How to create a basic template

Templates can be very powerful, but also sometimes very complicated. It often helps to start by creating the simplest possible kind of template, and then experimenting from there.

  • On your wikia, go to Template:Example and click "Create".
  • Type "Hello, World" in the editor.
  • Click "Publish". You have just created a template with some sample content.
  • On your wikia, create a new article called "Template test".
  • In the editor, go to source mode and enter the following code:
{{Example}}
  • Click Publish. Your "Testing Templates" page should display the text you added to your template.

You've successfully created and used a template! Now you can change the content of your template and add it to more pages to make it more useful for your community.

Adding pre-existing templates

Templates-rightrail

Wikias come with pre-loaded default templates. You can view a complete list of templates available on your wikia by going to Special:AllPages and selecting "Template" from the namespace dropdown menu. Click "Go" and all available templates will appear in a list.

  • In the editor's visual mode, you can select from the list of all templates available on your wikia by clicking "Add other templates".
  • In source mode, you can use the code {{Template name}} to add any template to your page.
  • Advanced users can edit the page MediaWiki:Editor-template-list to change the list of templates available by default in the "Templates" section of the editor. Up to four templates can be in this list.

Advanced templates

Template parameters

Templates can have parameters - these allow you to alter the way the template is displayed, such as including specific text or altering the design.

To take Template:Wikipedia as an example, adding just {{Wikipedia}} assumes that the page on Wikipedia is the same name as the page of the current page the template is used on. However, a parameter can be added, e.g. {{Wikipedia|Microsoft}}, to tell the template that the page on Wikipedia was Microsoft.

To learn more about how to change the output of the template based on what the user inputs, see Help:Template parameters and Help:Parser functions.

Substituting templates

A different way to use a template is to substitute its content into a page. This is done by inserting subst: immediately after the opening braces: {{subst:templatename}}. Once the page is saved, the link to the template is removed and the template output is substituted in its place and can be further edited. Any updates to the template will not affect the content that was substituted into the page.

To learn more, visit Help:Substituting templates.

Updating and adding standard templates

The official Starter Wiki and semi-official Templates Wiki occasionally improve some of their documentation as well as adding new templates specifically designed for Wikia sites, and are therefore worth checking from time to time.

Copying templates from other wikis

Contributors throughout Wikia have made all different kinds of templates. It is often simpler to copy an existing template and modify it for your needs, rather than creating one from scratch. The Templates Wiki is a good place to start looking for a template that fits your needs. In most cases, you are free to copy templates based on the shared CC-by-SA license, but make sure the wikia you want to copy from does not have an alternative licensing scheme that may place restrictions on what you can copy.

Here are some basic steps to copy most templates:

  1. Find the template you want to copy (usually http://wikiname.wikia.com/wiki/Template:templatename).
  2. Click the Edit button, select all of the wikitext and copy it.
  3. Create a new template page on your wikia (http://yourwiki.wikia.com/wiki/Template:templatename?action=edit).
  4. Paste the wikitext code you copied and press the Publish button.

Many templates have a separate subpage for documentation about the template. Fortunately, the location is often standardized, so it is easy to copy the documentation as well. If you notice the template page you copied above does not look like the original, it is likely the documentation is on a separate subpage:

  1. Find the template documentation you want to copy (usually http://wikiname.wikia.com/wiki/Template:templatename/doc).
  2. Click the Edit button, select all the wikitext and copy it.
  3. Create a new template documentation subpage page on your wikia (http://yourwiki.wikia.com/wiki/Template:templatename/doc?action=edit).
  4. Paste the wikitext code you copied and press the Publish button.

Template Webinar

Looking for further video instruction? This webinar recording overviews the basics of adding and customizing templates for your wikia.

Templates Overview25:30

Templates Overview

See also

Further help and feedback

Around Wikia's network

Random Wiki