Help:Use templates

From Tangowiki
User manual edit TOC
Short instruction
Find and read articles
Important terms
Search for an article
User account
Registration/New user account
Preferences: User settings
Create new article
Sandbox on subpage
Cite a source & quotes
Style guide
Use forms
Create TJ page
Create milonga
Create venue
Create festival article
Add a song recording
Edit an article
Text formatting
Links
Add categories to article
Watchlist
Move (rename) a page
Images
Use templates
Message boxes
Note boxes
Guidelines
Collaborate
Discussion page
Translate a page
Get help
Expert manual

Templates

For TangoWiki exist multiple templates, which can be embedded in articles and other pages. Templates allow the input of text with its display already being determined by the template behind it. Templates are especially useful for infoboxes, tables and other content with factual character.

Templates are also the basis for Category:TangoWiki forms (see help on how to use forms), the templates structure the output of the data input in the form.

Embedding of templates has many advantages:

  • uniformly display of information on comparable pages
  • simplification of creating new pages (less Wiki syntax, less code)
  • simpler adaption of more than one page at the same time, respectively, their display
  • simple storage of information for semantic browsing, creation of semantic templates (no change for embedding)

Useful templates in TangoWiki

All templates in TangoWiki are stored in the namespace "Template:" and are collected in the category "TangoWiki templates". There are main categories to be found:

  • Article template: Article templates can directly be used in articles. They include Noteboxes and other useful templates for good content creation.
  • Help template: Templates only used for the help area, the namespace "Help:" and its contents there.
  • Messagebox template: Messagebox templates should mainly be used by admins. They are meant for a page-wide basis and shall be included on top of the page. They consider deletion, moving and other general content information concerning the page.
  • Technical template: Technical templates are useful helper templates for making the wiki work. They need not to be used in article content, but are rather subtemplates for other templates, forms etc.
Distinction: What is the difference between "Message boxes" and "Note boxes"? Note boxes can be used within the content text of an article and highlight info, warnings and other useful hints. Message boxes are meant for a meta-basis, page-wise. They concern deletion, moving and general content information and are usually to be found on top of pages. Message boxes usually "do" something extra with a page, i.e. sort them into a maintenance category, while note boxes only inform on the page. – Note boxes on the other hand, can be used in any article, wherever they fit. They are all stored in the category "Article template". (This info is written in a note box, for example.)

Use templates

On the respective template page there is the code for embedding documented. This code can be copied and embedded into articles. Then the particular parameters are filled with right information. After saving the page the template will be shown pre-formatted on the page.

Generally, templates are embedded with the code {{Template name}} (template name within 2 curly brackets each). In more complex templates with variable parameters, the curly brackets still remain at the beginning and end of the code.

Parameters & values

In some templates there are defined parameters with variable values to be filled. These parameters should be shortly described on the template page, to simplify filling-in.

Some parameters are mandatory, which means, that the field will show even with empty values. Some parameters are optional, so the field can stay empty and the empty field won't show.

Tip: It is recommended to embed the entire code into the page, even if some parameters cannot be filled in right away. This makes it easier for other users to detect and complete missing values.

Article templates

There are a few article templates you can use during writing. They are usually in the syntax {{Templatename|Parameter value}}. Use the template of your choice ("template name") and change the "parameter value" for your desired text.

See more:

Help

For questions about using templates contact the creator or editor of the template page or of an article, in which the template has already been used. On which pages a template is used, you can view on the template page in the left sidebar under "Toolbox" > "What links here".

See also