Help:Translation switching

Translation switching is used on many templates and other message boxes across the wiki. The template lang detects the name of the language page and switches the text. Its main purpose is to keep all localized versions of text centralized into one template.

In the past, translators would create pages like Template:Cleanup/ru, which would lead to a lot of misplaced and inconsistent localized templates. Now all translators have to do is simply add a few lines of code to the existing Template:Cleanup page and whenever that template is used on a Russian page, the template will automatically switch to show the Russian text.

What should use translation switching?
In general, all templates should use it. This includes infoboxes to maintenance messages, among others.

How to add localized strings

 * 1) Select a template from the list of templates that use translation switching.
 * 2) Edit the template and add your strings (please use alphabetical ordering for convenience).
 * 3) Update the template translation switching or ts towards the bottom of the page and add your language code to the list.

Example
Let's say you're adding Italian strings to a template. The template might already look like this:

...

So add your lines, copying the style of the ones above and below, so it looks like this:

...

Make sure to add the language to the translation switching template towards the bottom of the page, also.


 * Remember to add language strings in alphabetical order.

Templates without translation switching
If you come across a particular template that requires translation switching and you want to add it, then feel free to make a start. The instructions below detail how to add lang to templates.

You may also wish to take a look at the list of other templates that have localized strings to try and copy the layout. Be aware of more intricate templates such as infobox templates as their uses of lang can be appear to be quite complex.

If you need help with a particular template, simply post on the talk page of it or contact one of the moderators or admins, as they'd be happy to help you.

Parts of templates
Let's say a template contains the text:

 Lorem ipsum dolor Welcome lorem ipsum.

Now after modifying it for translation switching:

 Lorem ipsum dolor  lorem ipsum.

Notice there are no extra line breaks or spaces, like there are in this example:

 Lorem ipsum dolor '''[[

]]''' lorem ipsum.

You can have as many line breaks as you want inside lang's &#123;&#123; brackets &#125;&#125;, but outside there must be no spaces, line breaks or gaps at all.

Language links
Sometimes you may need to switch a link based on the language. A template may look like this:

 Welcome

But you want the link to go to Welcome/fr instead of Welcome. This does the job:

 Welcome

if lang tests whether the page is a language page, and if it is, it'll output the language code (in this case, it's /fr). So the link in this example will go to Welcome/fr, and the text displayed on the link will be French, as well.

It's important to not put a space in front of if lang (for example Hats) This is because, when used in a link, it will produce Chell/fr instead of Chell/fr.

Language categories
lang cat can be particularly handy for placing some templates in categories based on their language. For example, will place German pages in Category:Characters/de, and French pages in Category:Characters/fr.

Related language templates
For more advanced uses of translation switching we have the following templates:


 * lang cat – places a page in a particular category based on their language subpage name.
 * if lang – can produce two outputs based on whether the page is a language subpage or not (as opposed to lang which can define outputs on specific languages).
 * This is handy to avoid the use of lang like this: