Help:Translating

This page contains changes which are not marked for translation.

Wiki Help pages
Contributor's guide — Guidelines — Fixing errors howto
Editing pages — Talk pages — Formatting
Code of conduct — Wiki project page — About Gentoo wiki — Wiki FAQ
Help improve the documentation! — Contributing to Gentoo

Anyone who writes both English and a foreign language can help the community out by translating documentation on the wiki.

Note that all articles must be written in English before being translated into other languages.

MediaWiki's Translate extension is used to help with translating pages on the Gentoo Wiki into other languages. It uses a gettext-style message system that breaks up an article into small chunks of text that are easily translatable.

Note
There are specific instructions for translating the handbook.

Becoming a translator

Anyone willing and able to help out with translating the documentation is welcome to do so. Start out by requesting a translator account - this is relatively straightforward: for languages that are already translated, simply add an entry on the translator accounts requests page, using a standard wiki account, and wait for a response.

To translate articles for a new language, please start by translating this help page in user space. Go to the user page for the account requesting to become a translator, and in the URL bar, add a slash and the name of the new page, as such: "/User:Larry/Translating_Esperanto". Click the "create this page" link, and publish the new translation there. When requesting a translator account, link to the new translation.

There are currently translators for the following languages:

Catalan‎ (català)
Chinese (中文)
Croatian (hrvatski)
Czech (Český jazyk)
Dutch (Nederlands)
French (Français)
German (deutsch)
Greek (ελληνικά)
Italian (italiano)
Korean (한국어)
Indonesian (Bahasa Indonesia)
Japanese (日本語)
Persian (فارسی)
Polish (polski)
Portuguese (português)
Portuguese (português do Brasil)
Russian (русский)
Spanish (español)
Serbian (српски)
Ukranian (українська)
Turkish (Türkçe)

For all editors

Translation tags

"Translation tags" are snippets of text that automatically get added to appropriate elements of a page by the Translate extension, each time a page is marked for translation. These tags take the form <--T: 15--> and pertain to the internal workings of the extension. They are not for use by editors.

Do not create or edit these tags. If a paragraph is to be modified, just modify the content and leave the tags in place. When completely deleting a paragraph, delete its translation tag at the same time. When moving the paragraph within the page, keep the tag with the content.

When adding new paragraphs to a page, do not "hand craft" translation tags, just add the content without translation tags. Modifications to the article will have it show up in the Page translation list, and from there changes be reviewed and the page can be marked for translation again, which will add translation tags to the new sections.

Tip
For long sections of output in block level layout elements, such as FileBoxes or CodeBoxes, whitespace may be added to any empty lines so that the entire output will be treated as a unique translatable section. Otherwise each section separated by an empty line would be split into separate paragraphs, each with an individual translation tag.

Tagging translatable sections

Before a page can be translated, tag the translatable sections. In most cases, that is the whole article.

To tag a section as translatable, put it into <translate> XML tags, like this:

CODE Tagging an article to be translated

&lt;translate&gt;
We are using the [https://translatewiki.net/wiki/Translating:Page_translation_feature TranslateWiki Page translation] features to help translating pages on the Gentoo Wiki into other languages.
It uses a gettext-style message system that breaks up an article into small chunks of text that are easily translatable.
&lt;/translate&gt;

Also, add the language selection bar at the top of the article, using the <languages /> tag:

CODE Adding the language selection bar

&lt;languages /&gt;
&lt;translate&gt;
We are using the [https://translatewiki.net/wiki/Translating:Page_translation_feature TranslateWiki Page translation] features to help translating pages on the Gentoo Wiki into other languages.
It uses a gettext-style message system that breaks up an article into small chunks of text that are easily translatable.
&lt;/translate&gt;