Ŝablono:Autotranslate/doc

El Komunejo

(Malsamoj inter versioj)
Iri al: navigado, serĉi
(Create a layout template: change)
(that list is very incomplete and wrong (it was taken from MediaWiki.org and is outdated) I'll make new list if we need one.)
Linio 13: Linio 13:
=== Create a layout template ===
=== Create a layout template ===
&mdash;See for example [[Template:Cc-by-1.0/layout]].<br />
&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 />
+
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.
This template should not add any categories when transcluded.
=== Convert existing language versions ===
=== Convert existing language versions ===
&mdash;See for example [[Template:Cc-by-1.0/en]].<br />
&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;. Posibilities are listed [[Template:Autotranslate/Languages/doc#Supported_languages|here]]. 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.
+
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.
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.
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.
Linio 24: Linio 24:
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.
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 sintaxis you must use for <code>[[Template:Template name/en|Template:<var>Template name</var>/&lt;<var>prefix</var>&gt;]]</code>, where <code>&lt;<var>prefix</var>&gt;</code> is [[Template:Autotranslate/Languages/doc#Supported_languages|one of this]].
+
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|Template:<var>Template name</var>/layout]]</code>
+
  <nowiki>{{</nowiki><code>[[Template:Template name/layout|<var>Template name</var>/layout]]</code>
  |text=&lt;''translated text of the template''&gt;
  |text=&lt;''translated text of the template''&gt;
  |lang=&lt;''prefix''&gt;
  |lang=&lt;''prefix''&gt;
Linio 46: Linio 46:
== Code snippet ==
== Code snippet ==
To use this template, include the following code:
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|}}}
+
<pre>{{Autotranslate|1={{{1|}}}|2={{{2|}}}|3={{{3|}}}|4={{{4|}}}|5={{{5|}}}|6={{{6|}}}|7={{{7|}}}|8={{{8|}}}|9={{{9|}}}
|base={{subst:PAGENAME}}
|base={{subst:PAGENAME}}
-
}}</PRE>
+
}}</pre>

Kiel registrite je 06:16, 12. Aŭg 2009

Ŝablono:Documentation subpage This template is used to show a template in the users 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}}
<noinclude>{{documentation}}</noinclude>

Protect templates

The main template page is probably already protected. You should probably also protect /layout and /en.

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