Help:Translating
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. Do not translate {{Deprecated}} or {{Archived}} articles.
In order to avoid needless work translating outdated content, it's important to take heed of the note at the top of the translating section about articles that might have changes that are not yet marked for translation.
Translators are invited to join the #gentoo-wiki-translation (webchat ) channel on IRC to facilitate coordinating work for everyone - see the wiki IRC channels article.
Wij maken gebruik van de Vertalings extention van WikiMedia die ons helpt om pagina's van de Gentoo Wiki te vertalen. Deze maakt gebruik van een gettext-achtig berichtensysteem dat een artikel opdeelt in kleinere stukken tekst die eenvoudig te vertalen zijn.
There are specific instructions for translating the handbook.
All contributions must comply with the Gentoo wiki copyright policy and with the Gentoo AI policy. You must be sure to understand and accept those policies prior any contribution.
The wiki project aims to maintain a respectful, constructive environment - please be polite and considerate of other users, and be sure to follow the Gentoo code of conduct. All wiki edits should be made in the spirit of moving the project towards the common goals. Documentation and discourse should be objective and rooted in fact. The project is consensus-based - please listen to the admins, devs, and other editors.
For all editors: how to work with translated articles
Articles in English that are translated into other languages have some particularities that all editors must know about:
"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 - they should simply be ignored, and preserved along with the text they mark.
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 can be reviewed and the page can be marked for translation again, which will add translation tags to the new sections.
If copy-pasting text between articles, be sure to remove inappropriate translation tags from the pasted text.
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.
Voor Redacteurs: Secties aanduiden als vertalingsklaar
Alvorens een pagina kan vertaald worden moet je de vertaalbare delen aanduiden. In de meeste gevallen is dat het ganse artikel.
Articles should only be made translatable once they are reasonably complete and correct, and are not currently undergoing major changes. Before a page can be translated, tag the translatable sections with <translate> tags (in most cases, that is the whole article).
Voeg ook een talenbalk toe bovenaan het artikel door middel van de <languages/> tag:
Om een sectie als vertaalbaar te markeren plaats je deze binnen <translate> XML blokken, zoals deze:
<translate> Wij maken gebruik van de [https://translatewiki.net/wiki/Translating:Page_translation_feature TranslateWiki Pagina Vertaling] functionaliteit als ondersteuning bij het vertalen van de Gentoo Wiki. Het maakt gebruik van een gettext-stijl berichtensysteem dat een artikel opsplitst om het vertalen te vergemakkelijken. </translate> </pre>
Voor Redacteurs: Aanvragen van pagina vertaling
Nadat je de vorige stap (toevoegen van de talen en taal label) vervolledigd hebt kan je een link toevoegen aan de Page translation pagina. Een beheerder of hoofdvertaler zal de kwaliteit van het artikel beoordelen en dan de aanvraag goedkeuren of afkeuren. Zorg er voor dat je de discussie pagina volgt want dat zal gebruikt worden om te discussiëren waarom de aanvraag niet werd toegestaan.
When a page is marked for translation, a link with the text "Translate this page" will appear on the top of the page, to allow access to the translation interface.
When a translated article's content is changed, it will again need to be marked for translation, to allow the modified content to be translated. Pages that have pending changes will have the text "this page contains changes which are not marked for translation" at the top. It's important to avoid working on translating such pages, as this would often mean translating outdated content. For administrators, the text will read "this page has changes since it was last marked for translation" and the "marked for translation" part of that text will be a link that can be clicked to start the process of marking the page for translation.
If waiting for an article to be marked in order to translate it, it may be possible to contact an admin or lead-translator to request that an article be reviewed and marked for translation. The #gentoo-wiki-translation (webchat ) channel on IRC can be a good place to try to get attention for this.
Use the correct link style so that translations work
All internal links should be represented by {{Link}} template:
Old-style, obsolete links:
Visit the [[Main Page]]
How to make a correct link:
Visit the {{Link|Main Page}}
The link template may also accept a label to show as text in place of the actual page name. Original:
[[Help:Translating|help on translating]]
Modified:
{{Link|Help:Translating|help on translating}}
Links to sections, that used square bracket links should also use the link template instead. Sections must be passed to the template parameter section in order for the links to work on non-English pages:
Visit the [[Portage#Usage|using Portage]]
Visit the {{Link|Portage|section=#Usage|using Portage}}
This allows for direction to the translated page if it exists or the main article if it does not. This is dynamic as new pages are created with less work after translations are completed.
Additionally, sections should be tagged like {{Anchor|<section name in English>}} so any hash references are equal between languages. These are NOT to be translated on subsequent languages. An alternative name for the anchor may also be used in place of the section name, particularly in abnormally long or those with non-alpha characters. When using an alternative name, the Link section must point to this Anchor.
For translators - how to translate articles into other languages
Voor Iedereen: Word een vertaler
Wanneer je deze taak vervolledigd hebt, of je bent niet de eerste vertaler voor je taal, voeg jezelf dan toe aan de wordt een vertaler (en) pagina.
Als je taal hierboven niet wordt vermeld betekend dat dat je de eerste vertaler bent voor deze taal. Als je de eerste vertaler bent (en er dus geen vertaling van deze pagina is), vertaal deze help pagina voordat je je aanmeldt als vertaler. Dit doe je door een pagina aan te maken in je gebruikersruimte met een vertaling van deze pagina en daarnaar te linken wanneer je vertalers rechten aanvraagt.
The list of translated languages on the wiki should be the list of languages at the top of this page (as the first act of adding a new translated language should be to translate this page).
Voor Vertalers: Vertalen
{{{1}}}
Om een vertaling van een artikel te starten, klik op de Translate this page link die net onderaan de pagina titel verschijnt. Op de volgende pagina, selecteer je de taal waarvoor je zal vertalen op de rechterbovenhoek.
Je zal een tabel krijgen met allemaal vertaalbare paragrafen. Klik op de links in de linkerkolom om een schrijfbox te verkrijgen waarin je je vertaling kan plaatsen. Wanneer je klaar bent met een paragraaf, klik dan op Skip to next translation. Wanneer je klaar bent, klik Save translation.
Those who are promoted to a lead translator, also have access to translate messages for templates.
Advanced
Speciale templates
Deze templates zijn vertaald:
NIEUW! Templates moeten niet aangepast worden, ze tonen automatisch vertaalde tekst.
Als je taal mist of je wilt nieuwe Templates vertaalbaar maken, contacteer dan het wiki project.
Taal code uitzonderingen
Voor sommige talen, bestaat er geen bruikbare ISO 639-1 code. Deze uitzonderingen worden gebruikt:
For some scripts, there is no usable ISO 639-1 code. These exceptions are used instead:
| Replacement code | Language |
|---|---|
| zh-cn | Simplified Chinese (简体中文) |
Taal Statistieken
Je kunt een lijst van pagina ́s vinden door je taalcode in te geven op Special:LanguageStats, waar standaard wordt weergegeven welke pagina ́s nog niet vertaald zijn.