Ŝablono:Autotranslate/doc

2010-01-07T16:59:05Z

Eusebius: Reverted edits by Progiftnet (talk) to last revision by Multichill

{{Documentation subpage}}
This template is used to show a template in the users interface language.

== How to convert a template ==
Before you apply this template, first you have to prepare the template.

=== Pick a template ===
—See for example [http://commons.wikimedia.org/w/index.php?title=Template:Cc-by-1.0&oldid=12667239 Template:Cc-by-1.0 before changes]. 
First you have to pick a template to autotranslate. 
''In this documentation, we will name our "selected template" as:'' <code>[[Template:Template name|Template:<var>Template name</var>]]</code>
*See [[Commons:Template i18n]] for a list of templates needing translation or translated.

=== Create a layout template ===
—See for example [[Template:Cc-by-1.0/layout]]. 
You must create a layout template, named <code>[[Template:Template name/layout|Template:<var>Template name</var>/layout]]</code>, to contain the layout of all language versions of the template. The easiest way to do this is to copy a layout template of a similar template. 
This template should not add any categories when transcluded.

=== Convert existing language versions ===
—See for example [[Template:Cc-by-1.0/en]]. 
All versions must be subpages of <code>[[Template:Template name|Template:<var>Template name</var>]]</code>, and his name must use the appropriate prefix, [[m:List_of_Wikipedias|as used on Wikipedia]] when adding a new language –ISO 639 language code–. For example, Spanish subpage must be named <code>[[Template:Template name/es|Template:<var>Template name</var>/es]]</code> Usually the English language link to the main template –<code>Template:<var>Template name</var></code>–. That is incorrect, point it to the <code>[[Template:Template name/en|Template:<var>Template name</var>/en]]</code> subpage.

Each language version of the template should be checked and converted to use the layout template –<code>[[Template:Template name/layout|Template:<var>Template name</var>/layout]]</code>–. Start with the English language version and compare it to the current template.

Note that everything that is not supposed to be included together with the template, like <code><nowiki>{{translated tag|cleanup}}</nowiki></code> or <code><nowiki>{{documentation}}</nowiki></code>, must be inside a <code><noinclude></code> tag.

Here is the syntax you must use for <code>[[Template:Template name/en|Template:<var>Template name</var>/<<var>prefix</var>>]]</code>.
<nowiki>{{</nowiki><code>[[Template:Template name/layout|<var>Template name</var>/layout]]</code>
|text=<''translated text of the template''>
|lang=<''prefix''>
<nowiki>}}<noinclude>
{{translated tag|license}}
</noinclude></nowiki>

=== Create a documentation page ===
—See for example [[Template:Cc-by-1.0/doc]]. 
Create a documentation page at <code>[[Template:Template name/doc|Template:<var>Template name</var>/doc]]</code>. This documentation page should include some code for creating language versions of the template.

=== Convert the main template ===
—See for example [[Template:Cc-by-1.0]]. 
The last step is to enable the template. Be sure to check everything before you enable the template. You can cause a really big mess!
To enable the template, put this code in the template –<code>[[Template:Template name|Template:<var>Template name</var>]]</code>–.
<nowiki>{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|</nowiki>base=<var>template name</var>}}

== Code snippet ==
To use this template, include the following code:
<pre style="overflow:auto">
{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|7={{{7|}}}|8={{{8|}}}|9={{{9|}}}|base={{subst:PAGENAME}}}}
</pre>

Ŝablono:Autotranslate/doc

2009-01-28T13:25:26Z

Eusebius: /* Pick a template */ new location

{{Documentation subpage}}
This template is used to show a template in the users interface language.

== How to convert a template ==
Before you apply this template, first you have to prepare the template.

=== Pick a template ===
First you have to pick a template to autotranslate. See [[Commons:Template i18n]] for a list.

=== Create a layout template ===
If the template is not too difficult you should create a layout template to contain the layout of all language versions of the template. See for example [[Template:Cc-by-1.0/layout]].
This template should not add any categories when transcluded.

=== Modify the en language link ===
Usually the English link points to the main template, point it to the /en subpage. See for example [[Template:Cc-by-1.0/en]]

=== Create a documentation page ===
Create a documentation page at ''template name''/doc. This documentation page should include some code for creating language versions of the template. See for example [[Template:Cc-by-1.0/doc]]. Include this documentation in the main template by adding <nowiki>{{documentation}}</nowiki>

=== Convert existing language versions ===
Each language version of the template should be checked and converted to use the layout template. Start with the English language version and compare it to the current template.

Note that everything that is not supposed to be included together with the template, like “<nowiki>{{translated tag|cleanup}}</nowiki>” and documentation, must be inside a “<tt><noinclude></tt>” tag.

=== Convert the main template ===
The last step is to enable the template. Be sure to check everything before you enable the template. You can cause a really big mess!
To enable the template, put this code in the template for the layout part:
<nowiki>{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|base=</nowiki>''template name''<nowiki>}}</nowiki>
See for example [[Template:Cc-by-1.0]]

=== Protect templates ===
The main template page is probably already protected. You should probably also protect /layout, /lang & /en.

== Code snippet ==
To use this template, include the following code:

<PRE>
{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|7={{{7|}}}|8={{{8|}}}|9={{{9|}}}|base={{subst:PAGENAME}}}}
</PRE>

Komunejo - Kontribuoj de uzanto [eo]

Ŝablono:Autotranslate/doc

Ŝablono:Autotranslate/doc