Ŝablono:Autotranslate/doc

El Komunejo

< Ŝablono:Autotranslate(Malsamoj inter versioj)
Iri al: navigado, serĉi
E (update)
E (41 versioj: Helpaj ŝablonoj)
 
(35 mezaj versioj ne montrata.)
Linio 1: Linio 1:
{{Documentation subpage}}
{{Documentation subpage}}
-
'''Most uses of this template should be substituted in the final product.'''
+
This template is used to show a template in the user's interface language.
-
You probably want to call ''this'' template like
+
== How to convert a template ==
-
<pre><nowiki>{{<includeonly>{{{s|subst:}}}</includeonly>Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|base={{subst:PAGENAME}}}}</nowiki></pre>
+
Before you apply this template, first you have to prepare the template.
 +
=== Pick a template ===
 +
&mdash;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].<br />
 +
First you have to pick a template to autotranslate.<br />
 +
''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.
-
If you ''don't'' want it to be substituted, then you can use
+
=== Create a layout template ===
-
<pre><nowiki>{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|base={{subst:PAGENAME}}}}</nowiki></pre>
+
&mdash;See for example [[Template:Cc-by-1.0/layout]].<br />
 +
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.<br />
 +
This template should not add any categories when transcluded.
 +
=== Convert existing language versions ===
 +
&mdash;See for example [[Template:Cc-by-1.0/en]].<br />
 +
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 &ndash;ISO 639 language code&ndash;. For example, Spanish subpage must be named <code>[[Template:Template name/es|Template:<var>Template name</var>/es]]</code><br />Usually the English language link to the main template &ndash;<code>Template:<var>Template name</var></code>&ndash;. That is incorrect, point it to the <code>[[Template:Template name/en|Template:<var>Template name</var>/en]]</code> subpage.
-
Note that you can and should pass the parameter <code>|s=subst:</code> if the next level of substitution requires that or <code>|s=</code> if the next level ''shouldn't'' be substituted. Normally the default should be set correctly using the includeonly trick. &nbsp;'''&mdash;&nbsp;[[User:Mike.lifeguard|<b style="color:#309;">Mike</b>]].[[User talk:Mike.lifeguard|<b style="color:#309;">lifeguard</b>]]'''&nbsp;&#124;&nbsp;<sup>[[b:User talk:Mike.lifeguard|<span style="color:#309;">@en.wb</span>]]</sup> 18:11, 27 November 2008 (UTC)
+
Each language version of the template should be checked and converted to use the layout template &ndash;<code>[[Template:Template name/layout|Template:<var>Template name</var>/layout]]</code>&ndash;. 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>&lt;noinclude&gt;</code> tag.
 +
 
 +
Here is the syntax you must use for <code>[[Template:Template name/en|Template:<var>Template name</var>/&lt;<var>prefix</var>&gt;]]</code>.
 +
<nowiki>{{</nowiki><code>[[Template:Template name/layout|<var>Template name</var>/layout]]</code>
 +
|text=&lt;''translated text of the template''&gt;
 +
|lang=&lt;''prefix''&gt;
 +
<nowiki>}}&lt;noinclude>
 +
{{translated tag|license}}
 +
&lt;/noinclude></nowiki>
 +
 
 +
=== Create a documentation page ===
 +
&mdash;See for example [[Template:Cc-by-1.0/doc]].<br />
 +
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 ===
 +
&mdash;See for example [[Template:Cc-by-1.0]].<br />
 +
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 &ndash;<code>[[Template:Template name|Template:<var>Template name</var>]]</code>&ndash;.
 +
<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>

Nuna versio ekde 21:01, 11. Jan 2010

Ŝablono:Documentation subpage This template is used to show a template in the user's interface language.

Enhavo

How to convert a template

Before you apply this template, first you have to prepare the template.

Pick a template

—See for example 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: Template:Template name

Create a layout template

—See for example Template:Cc-by-1.0/layout.
You must create a layout template, named Template:Template name/layout, 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 Template:Template name, and his name must use the appropriate prefix, as used on Wikipedia when adding a new language –ISO 639 language code–. For example, Spanish subpage must be named Template:Template name/es
Usually the English language link to the main template –Template:Template name–. That is incorrect, point it to the Template:Template name/en subpage.

Each language version of the template should be checked and converted to use the layout template –Template:Template name/layout–. 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 {{translated tag|cleanup}} or {{documentation}}, must be inside a <noinclude> tag.

Here is the syntax you must use for Template:Template name/<prefix>.

{{Template name/layout
|text=<translated text of the template>
|lang=<prefix>
}}<noinclude>
{{translated tag|license}}
</noinclude>

Create a documentation page

—See for example Template:Cc-by-1.0/doc.
Create a documentation page at Template:Template name/doc. 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 –Template:Template name–.

{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|base=template name}}

Code snippet

To use this template, include the following code:

{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|7={{{7|}}}|8={{{8|}}}|9={{{9|}}}|base={{subst:PAGENAME}}}}
Personaj iloj