Difference between revisions of "Meta:Templates"

From Synfig Studio :: Documentation
Jump to: navigation, search
(Document warning templates)
m
Line 5: Line 5:
 
= User Templates =
 
= User Templates =
 
Those templates can (and often should) be used in page body.
 
Those templates can (and often should) be used in page body.
 +
 +
== C ==
 +
* '''Location''': {{l|Template:C}}
 +
* '''Description''': This template should always be used to ‘wrap’ items from the context menu GUI.
 +
* '''Examples''': <nowiki>{{c|File|Open File}}</nowiki> is interpreted as {{c|File|Open File}}
  
 
== Category ==
 
== Category ==
Line 20: Line 25:
 
* '''Description''': Creates link to another page, providing proper localization support.
 
* '''Description''': Creates link to another page, providing proper localization support.
 
* '''Examples''': See {{l|Meta:LinksTest/ru|Meta:LinksTest/ru}}.
 
* '''Examples''': See {{l|Meta:LinksTest/ru|Meta:LinksTest/ru}}.
 +
 +
== Literal ==
 +
* '''Location''': {{l|Template:Literal}}
 +
* '''Description''': This template should always be used to ‘wrap’ all reference to GUI items (control name, menu item, …).
 +
* '''Examples''': <nowiki>{{Literal|Open File|New}}</nowiki> is interpreted as {{Literal|Open File}}
  
 
== Navigation ==
 
== Navigation ==
 
* '''Location''': {{l|Template:Navigation}}
 
* '''Location''': {{l|Template:Navigation}}
 
* '''Description''': Defines navigation for sequence of pages and displays navigation bar. You need only to specify parent (index) page and next page (optional). There's no need to specify previous page, because it's determined automatically. Works only within the range of namespace though.
 
* '''Description''': Defines navigation for sequence of pages and displays navigation bar. You need only to specify parent (index) page and next page (optional). There's no need to specify previous page, because it's determined automatically. Works only within the range of namespace though.
* '''Examples''': {{Navigation|Top Page|Next Page}}.
+
* '''Examples''': <nowiki>{{Navigation|Top Page|Next Page}}</nowiki> or the header from those page
 +
 
 +
== Note ==
 +
* '''Location''': {{l|Template:Note}}
 +
* '''Description''': This template gives a box of fixed width. First argument is header for note and second a main content of note.
 +
* '''Examples''': <nowiki>{{Note|Note title|Short note text}}</nowiki>  See in ex. {{l|Doc:Getting_Started}} or note from example: {{Note|Note title|Short note text}}
 +
 
 +
== Shorcut ==
 +
* '''Location''': {{l|Template:Shortcut}}
 +
* '''Description''': Put a sequence of up to 5 keys to show a shortcut.
 +
* '''Examples''': <nowiki>{{Shortcut|Alt|Shift|t}}</nowiki> is interpreted as {{Shortcut|Alt|Shift|t}}
  
 
== Stub ==
 
== Stub ==

Revision as of 23:52, 23 February 2017

Navigation Navigation:  <<Writer Documentation


Here's a list of templates used to improve this wiki functionality.

User Templates

Those templates can (and often should) be used in page body.

C

  • Location: Template:C
  • Description: This template should always be used to ‘wrap’ items from the context menu GUI.
  • Examples: {{c|File|Open File}} is interpreted as "File → Open File"

Category

  • Location: Template:Category
  • Description: Specifies category page belongs to.
  • Examples: {{Category|MyCategory}}.

CategoryContents

  • Location: Template:CategoryContents
  • Description: Lists all pages in the specified category. Output is localized, so if you use {{CategoryContents|Example}} on Spanish page, you will automatically get content of Example/es category and the page titles will be replaced with their Spanish translations.
  • Examples: {{CategoryContents|MyCategory}}.

L

  • Location: Template:L
  • Description: Creates link to another page, providing proper localization support.
  • Examples: See Meta:LinksTest/ru.

Literal

  • Location: Template:Literal
  • Description: This template should always be used to ‘wrap’ all reference to GUI items (control name, menu item, …).
  • Examples: {{Literal|Open File|New}} is interpreted as "Open File"

Navigation

  • Location: Template:Navigation
  • Description: Defines navigation for sequence of pages and displays navigation bar. You need only to specify parent (index) page and next page (optional). There's no need to specify previous page, because it's determined automatically. Works only within the range of namespace though.
  • Examples: {{Navigation|Top Page|Next Page}} or the header from those page

Note

  • Location: Template:Note
  • Description: This template gives a box of fixed width. First argument is header for note and second a main content of note.
  • Examples: {{Note|Note title|Short note text}} See in ex. Getting Started or note from example:

    Note title

    Short note text
    note end


    Shorcut

    • Location: Template:Shortcut
    • Description: Put a sequence of up to 5 keys to show a shortcut.
    • Examples: {{Shortcut|Alt|Shift|t}} is interpreted as Alt⇧ ShiftT

    Stub

    • Location: Template:Stub
    • Description: Mark page as a stub.
    • Examples: {{Stub}}.

    Title

    Internal Templates

    Templates below are not intended for direct use in page body. They are usually invoked by high-level templates listed above.

    !

    • Location: Template:!
    • Description: This is an auxiliary template allowing one to encode "|"

    within template and parser function parameters. More...

    • Examples:
    Code: Result: Comments:
    {{!}} |

    GetTitle

    • Location: Template:GetTitle
    • Description: Returns custom title of a page set with {{Title}} template in the page body.
    • Examples:
    Code: Result: Comments:
    {{GetTitle|Doc:Getting_Started/ru}} Первые шаги Look at the source of Doc:Getting_Started/ru page.

    Languages

    • Location: Template:Languages
    • Description: Displays bar listing available translations for current page. More...
    • Examples: {{{Languages}}}

    Languages/Lang

    • Location: Template:Languages/Lang
    • Description: Utility template for language bar. Generates link to specified translation of current page if it's exists.
    • Examples:
    Code: Result: Comments:
    {{Languages/Lang|en}} English Result is "English", but without a link, because current page is in English
    {{Languages/Lang|es}} Result is empty, because this page have no Spanish translation. If it does, then the result would be: " • Español"
    {{Languages/Lang|ru}} Result is empty, because this page have no Russian translation. If it does, then the result would be: " • Русский"

    Languages/ThisPageTranslatedIn

    Code: Result: Comments:
    {{Languages/ThisPageTranslatedIn|en}} Meta:Templates If this template invoked from Meta:Templates/es, then result is the same ("/es" suffix automatically dropped)
    {{Languages/ThisPageTranslatedIn|ru}} Meta:Templates/ru If this template invoked from Meta:Templates/es, then result is the same ("/es" suffix automatically dropped and "/ru" suffix added)

    Navigation/PreviousPage

    PagenameFromLink

    Code: Result: Comments:
    {{PagenameFromLink|Doc:Getting_Started#Introduction}} Doc:Getting_Started
    {{PagenameFromLink|layers}} Layers
    {{PagenameFromLink|:Category:Manual}} Category:Manual

    Title.dpl


    Title.dpl.default

    Warning banners

    Warnings

    • Location: Template:Warnings
    • Description: Contains list of displayed warning banners and conditions for them

    OldTerminologyTranslation