Template:Translation2/doc
This is a documentation subpage for Template:Translation2. It contains usage information, categories, and other content that is not part of the original template page. |
Usage
Add translations
To add a new translation, copy a line for your new translation in the template. This should be in the form |langcode |status
, where "langcode" is the ISO 639-3 language code (search), and "status" is the status of the translation (either "missing", "progress", "proofreading", "needs proofreading", "updating", "needs updating", "ready" ("done"), or "published").
For example, if you wanted to add the English translation, you'd add "|en |missing
".
Create a new template
Create a new page called "Template:Translation/Page name" (where Page name is the name of the page with translations). Place the following example code:
{{translation2 |en |progress |fr |published |za |proofreading |page ={{subst:SUBPAGENAME}} |source={{subst:SUBPAGENAME}}/en <!--optional--> |destination = |source update = |source revid = {{{1|}}} |align = {{{align|right}}}<!-- for rtl translations --> }}
Every first parameter is a language code (search); every second parameter is that translation's status (missing, progress, proofreading, updating, or published). You can add new translations simply by adding new lines (up to 200 translations).
Special parameters:
- "page" is the base name of the page being translated (the above code will fill it automatically if the template is named correctly).
- "source" is the original page being translated; the edit links will place the code of that page when adding a new translation.
- Optional parameters (first two are primarily given by the translation requester, usually translation subcommittee and the last one may be given by the initiator of each translation):
- "destination" is a link to the final page in the original (when translating for protected wikis or namespaces).
- "source update" is the date the source page was significantly updated (requiring updates to translations). Any standard date format will be recognized.
- "source revid" is the revision ID used to make the translation. This should be left as shown above, and filled in on individual pages as shown below.
Place the template
{{translation/Page name}}
Once the above template is created, simply place the example above on translation pages. Replace Page name with the correct name, as created above.
If you know what the source revision ID is, fill it in as a parameter:
{{translation/Page name|855544}}
This will create a link to compare the translated revision of the source text to the updated version.
For live pages where the help messages are in the way, add the 'small=yes' parameter on the template page.
Create the translation request
This template is placed in the page to be translated (Page name) to show that translations are needed, and in translations of the page to show their status; to ask Meta translator to help, you need to create a translation request and to add it to the Translation requests page. In order to do so, use the template {{Request for translation2}}: you can place it in the source page if it's self-explanatory, or in a separate page which may contain guidelines for translations and request the translation of multiple pages. Translation requests are usually subpages of Translation requests or Translation requests/WMF.
Coding
Categories
The template adds the page to subcategories of Translations by status and Translations by language as appropriate.