Difference between revisions of "Template:Kbl10n"
m (adding mode variable to documentation again since it's still needed *cough* off for concerts now) |
(Old Knowledge Base) |
||
(9 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
<onlyinclude><includeonly>{{Kbl10n/{{#if:{{{mode|}}}|{{{mode|}}}|ml}} | <onlyinclude><includeonly>{{Kbl10n/{{#if:{{{mode|}}}|{{{mode|}}}|ml}} | ||
|en={{{en|}}} | |en={{{en|}}} | ||
|en_parature={{{en_parature|}}} | |||
|blog={{{blog|}}} | |||
|en_title={{{en_title|}}} | |en_title={{{en_title|}}} | ||
|en_note={{{en_note|}}} | |en_note={{{en_note|}}} | ||
|en_up={{{en_up|}}} | |en_up={{{en_up|}}} | ||
|de={{{de|}}} | |de={{{de|}}} | ||
|de_temp={{{de_temp|}}} | |||
|de_nobox={{{de_nobox|}}} | |||
|de_title={{{de_title|}}} | |de_title={{{de_title|}}} | ||
|de_jira={{{de_jira|}}} | |de_jira={{{de_jira|}}} | ||
Line 19: | Line 23: | ||
}}</includeonly></onlyinclude> | }}</includeonly></onlyinclude> | ||
This template is supposed to provide a language bar for [[Knowledge Base]] translations via [[Template:Kbl10n/ml]], as well as an easy method to document already translated pages via [[Template:Kbl10n/table]]. | This template is supposed to provide a language bar for [[Old Knowledge Base]] translations via [[Template:Kbl10n/ml]], as well as an easy method to document already translated pages via [[Template:Kbl10n/table]]. | ||
== Setup == | == Setup == | ||
Please create subpages | Please create subpages of this template with the name scheme: Template:Kbl10n/ENGLISH_KB_ID for each new localized KB article. | ||
E.g.: [[Template:Kbl10n/5816]] | E.g.: [[Template:Kbl10n/5816]] | ||
Line 35: | Line 39: | ||
|en_note= | |en_note= | ||
|en_up= | |en_up= | ||
|de=<font color="blue">GERMAN- | |de=<font color="blue">GERMAN-WIKI-LINK</font> | ||
|de_jira= | |de_jira= | ||
|de_note= | |de_note= | ||
Line 48: | Line 51: | ||
|ja_note= | |ja_note= | ||
|ja_up= | |ja_up= | ||
|mode=<nowiki>{{{mode| | |mode=<nowiki>{{{mode|view}}}</nowiki> | ||
}} | }} | ||
</div> | </div> | ||
The | The _jira variables can store the related [[Issue Tracker|Jira]] issue ID. | ||
The _up variables can store the date when the last update of the article occured. | The _up variables can store the date when the last update of the article occured. | ||
Line 60: | Line 63: | ||
It is not required to add info to all variables. | It is not required to add info to all variables. | ||
Please don't touch the <code>|mode=<nowiki>{{{mode| | Please don't touch the <code>|mode=<nowiki>{{{mode|view}}}</nowiki></code> variable. | ||
== Example == | == Example == | ||
Line 69: | Line 72: | ||
|en_title=Xstreet Merchants and Shoppers FAQs | |en_title=Xstreet Merchants and Shoppers FAQs | ||
|en_up=20/1/2009 | |en_up=20/1/2009 | ||
|de | |de=Häufig gestellte Fragen von Xstreet-Händlern und Kunden (KB) | ||
|de_jira=CT-146 | |de_jira=CT-146 | ||
|de_up=23/1/2009 | |de_up=23/1/2009 | ||
Line 77: | Line 79: | ||
|ja=Xstreetで商品を販売購入するためのFAQ (KB) | |ja=Xstreetで商品を販売購入するためのFAQ (KB) | ||
|ja_jira=CT-160 | |ja_jira=CT-160 | ||
|mode=<nowiki>{{{mode| | |mode=<nowiki>{{{mode|view}}}</nowiki> | ||
}} | }} | ||
</div> | </div> | ||
Line 85: | Line 87: | ||
The subtemplates of this template can be included with <code><nowiki>{{kbl10n/KB-ID}}</nowiki></code> to add the language bar to the connected KB article. E.g. <nowiki>{{</nowiki>[[Template:Kbl10n/5816|kbl10n/5816]]}} to [[FAQ Vendeurs Acheteurs Xstreet (KB)]] and [[Xstreetで商品を販売購入するためのFAQ (KB)]]. | The subtemplates of this template can be included with <code><nowiki>{{kbl10n/KB-ID}}</nowiki></code> to add the language bar to the connected KB article. E.g. <nowiki>{{</nowiki>[[Template:Kbl10n/5816|kbl10n/5816]]}} to [[FAQ Vendeurs Acheteurs Xstreet (KB)]] and [[Xstreetで商品を販売購入するためのFAQ (KB)]]. | ||
This will create a language | This will create a box in the sidebar, containing language links. Using mode=legacyml will result in a languagebar like this: | ||
{{kbl10n/5816}} | {{kbl10n/5816|mode=legacyml}} | ||
Line 96: | Line 98: | ||
{{kbl10n/5816|mode=table}} | {{kbl10n/5816|mode=table}} | ||
== Linking == | |||
There are two problems with links in KB articles and this template is trying to solve them. These are: | |||
*finding translated versions of the articles where the KB article is linking to | |||
*finding translated articles which are linking to an english root rather than to a recently created translation | |||
With [[Template:Kbl10n/Links]], it can be specified to which KB articles an KB article is linking to. The template then provides the tables of all linked to articles and the link to the translated version can easily be picked from these tables. Furthermore - because of the fact that the tables contain links -, the "[http://meta.wikimedia.org/wiki/Help:What_links_here "what links here"-feature] can be used to track which KB articles are linking to the new article. | |||
== Usage == | |||
Say, you'd like to translate an article with the Knowledge Base ID XXXX. | |||
*Create a new page at [[Template:Kbl10n/XXXX]]. | |||
*Write <font color="black"><nowiki>{{subst:kbl10n/subst}}</nowiki></font> as only content of the page and save it afterwards. | |||
*Edit the newly created page again. You'll notice that the content changed and that it now contains the standart setup of the templates described above. | |||
*Fill in the blanks (English issue ID, English article name, Jira IDs, ...) | |||
*In case the article contains links to other KB articles, specify them at the <font><nowiki>{{kbl10n/Links}}</nowiki></font> template as described in [[Template:Kbl10n/Links]]. | |||
*Save your edit. | |||
Contact [[User:Zai Lynch|Zai Lynch]] when you run into any problems or got questions. | |||
== Related Articles == | |||
*[[CT Project Overview]] | |||
*[[Special:Prefixindex/Template:Kbl10n|All subpages of this one]] |
Latest revision as of 04:46, 28 July 2012
This template is supposed to provide a language bar for Old Knowledge Base translations via Template:Kbl10n/ml, as well as an easy method to document already translated pages via Template:Kbl10n/table.
Setup
Please create subpages of this template with the name scheme: Template:Kbl10n/ENGLISH_KB_ID for each new localized KB article.
E.g.: Template:Kbl10n/5816
Syntax:
{{kbl10n |en=ENGLISH-KB-ID |en_title=ENGLISH-KB-TITLE (optional, for hovertext) |en_note= |en_up= |de=GERMAN-WIKI-LINK |de_jira= |de_note= |de_up= |fr=FRENCH-WIKI-LINK |fr_jira= |fr_note= |fr_up= |ja=JAPANESE WIKI LINK |ja_jira= |ja_note= |ja_up= |mode={{{mode|view}}} }}
The _jira variables can store the related Jira issue ID.
The _up variables can store the date when the last update of the article occured.
The _note variables can store additional notes.
It is not required to add info to all variables.
Please don't touch the |mode={{{mode|view}}}
variable.
Example
{{kbl10n |en=5816 |en_title=Xstreet Merchants and Shoppers FAQs |en_up=20/1/2009 |de=Häufig gestellte Fragen von Xstreet-Händlern und Kunden (KB) |de_jira=CT-146 |de_up=23/1/2009 |fr=FAQ Vendeurs Acheteurs Xstreet (KB) |fr_jira=CT-159 |ja=Xstreetで商品を販売購入するためのFAQ (KB) |ja_jira=CT-160 |mode={{{mode|view}}} }}
Inclusion
The subtemplates of this template can be included with {{kbl10n/KB-ID}}
to add the language bar to the connected KB article. E.g. {{kbl10n/5816}} to FAQ Vendeurs Acheteurs Xstreet (KB) and Xstreetで商品を販売購入するためのFAQ (KB).
This will create a box in the sidebar, containing language links. Using mode=legacyml will result in a languagebar like this:
Community Translation Project: | |
This article is a Old Knowledge Base translation. Only CT Project members may provide these. Join us! |
Furthermore, they can be included in documentation pages in order to keep track of all currently published articles and their translations/roots. To use the template in a documentation page, enter {{kbl10n/KB-ID|mode=table}}
. E.g. {{kbl10n/5816|mode=table}}.
This will create a table, looking like this:
5816: Xstreet Merchants and Shoppers FAQs
Language | Title | Jira | Last Update | Note |
---|---|---|---|---|
English | Xstreet Merchants and Shoppers FAQs | 20/1/2009 | ||
German | Häufig gestellte Fragen von Xstreet-Händlern und Kunden | CT-146 | 23/1/2009 | |
French | FAQ Vendeurs Acheteurs Xstreet | CT-159 | 27/1/2009 | |
Japanese | Xstreetで商品を販売購入するためのFAQ | CT-160 | 18/3/2009 |
Linking
There are two problems with links in KB articles and this template is trying to solve them. These are:
- finding translated versions of the articles where the KB article is linking to
- finding translated articles which are linking to an english root rather than to a recently created translation
With Template:Kbl10n/Links, it can be specified to which KB articles an KB article is linking to. The template then provides the tables of all linked to articles and the link to the translated version can easily be picked from these tables. Furthermore - because of the fact that the tables contain links -, the ""what links here"-feature can be used to track which KB articles are linking to the new article.
Usage
Say, you'd like to translate an article with the Knowledge Base ID XXXX.
- Create a new page at Template:Kbl10n/XXXX.
- Write {{subst:kbl10n/subst}} as only content of the page and save it afterwards.
- Edit the newly created page again. You'll notice that the content changed and that it now contains the standart setup of the templates described above.
- Fill in the blanks (English issue ID, English article name, Jira IDs, ...)
- In case the article contains links to other KB articles, specify them at the {{kbl10n/Links}} template as described in Template:Kbl10n/Links.
- Save your edit.
Contact Zai Lynch when you run into any problems or got questions.