Help:Extension:Translate/nl



De extensie Translate verrijkt MediaWiki met essentiële functies voor het vertalen. Het kan worden gebruikt om inhoudspagina's te vertalen, de interface van de wiki en zelfs andere software producten, als het wordt gebruikt op translatewiki.net. De extensie Translate heeft een eenvoudig te gebruiken interface en kan de structuur van de inhoud scheiden van de te vertalen tekst, het toont alleen de te vertalen tekst aan de vertalers door die teksten per keer in een te verwerken eenheid aan te bieden. Elke eenheid wordt automatisch gevolgd voor wijzigingen, de vertalers zien dan automatisch welke eenheden van een bepaalde pagina op de wiki vertaald of beoordeeld moeten worden.

De extensie wordt elke maand door honderden vertalers gebruikt voor het vertalen van de gebruikersinterface van de MediaWiki en andere software projecten op translatewiki. Op userbase.kde.org wordt het gebruikt om zo'n duizend pagina's met gebruikersdocumentatie te vertalen. Het is gemakkelijk om met deze extensie te gaan werken, maar u krijgt er wel geavanceerde rapportage, beoordelingen en workflow functies bij.

Functionaliteit


Interface: De belangrijkste functie van de extensie Translate is een eenvoudig maar functionele vertaalinterface. Naast essentiële informatie als definitie van de tekst en documentatie, kunt u ook vertalingen in ander talen bekijken. Als er een definitie is gewijzigd, dan ziet u de wijziging. De extensie voert standaard enkele controles uit, dat zorgt dat er enkele veel gemaakt fouten niet worden gemaakt, zoals fouten met de vierkante haakjes of het weglaten van variabelen. Afhankelijk van de configuratie zijn er ook suggesties uit het vertaalgeheugen en services voor machine vertaling zoals Google Translate, Microsoft's Bing Translator en Apertium.

Het gebruik van de vertaalinterface is verrijkt door gebruik van JavaScript en AJAX. Het backend heeft WebAPI's die in mobiele interfaces of maatwerk interfaces gebruikt kunnen worden voor specifieke inhoud. Het is ook mogelijk om teksten te exporteren voor vertaling in elk hulpmiddel dat het Gettext po bestandsformaat accepteert.

Berichten groepen en taken: Een groot deel van de functionaliteit zijn ontworpen rond twee basisconcepten: berichtgroepen en taken.

Een berichtengroep staat voor een verzameling berichten. Een pagina kan een berichtengroep zijn, elke alinea zou eventueel een bericht kunnen zijn in de groep. Berichten in een extensie zijn zelf een berichtengroep op translatewiki.net, een grote extensie kan meerdere berichtengroepen hebben. Een groep kan uit groepen bestaan, bijvoorbeeld All newsletters of All Translate extension messages. Veel statistieken en taken werken op basis van een berichtengroep.

De taken, ook wel de verschillende lijsten met berichten in een berichtengroep, faciliteren verschillende 'use cases'. Normaal krijgt een vertaler een lijst onvertaalde berichten in een gekozen berichtengroep, maar er zijn taken waar je berichten kunt beoordelen of alleen maar bekijken op de status van het bericht (alle, vertaald, onvertaald, verouderd).



Rapportage en statistieken: De extensie het uitgebreide functies voor rapportage gaande van een overzicht van onvertaalde berichten in alle berichtengroepen in een bepaalde taal tot lijsten van vertalers per taal en de mate van hun activiteit.

Inhoud vertaling: Als u ooit heeft geprobeerd om inhoud te vertalen in de MediaWiki zonder hulpmiddel dan weet u dat het niet schaalbaar is. De vertalingen verouderen en er is geen manier op de wijzigingen aan de originele Engelse pagina te volgen. Dan krijgt men dus half vertaalde en verouderde vertalingen zonder een helder overzicht van de status in het algemeen. Vertalers worden vaak ontmoedigd wanneer zij niet met kleine beheersbare stukjes tekst kunnen werken. Vertalers zien niet wat er nog te vertalen is of welke vertaling verouderd is. Ook de lezers/gebruikers moeten maar zien welke vertaalde informatie nog actueel is.

Dit wordt allemaal opgelost met de extensie Translate en de functie om pagina's te vertalen. Er hoeft alleen aan te geven welk deel van de pagina vertaling nodig heeft. De extensie splitst dit dan per alinea op in een berichtengroep. Daarna is het aan de vertalers. Als toevoeging kan er er een taalbalk worden toegevoegd met de tag tag of links hebben die automatisch naar de versie met de voorkeurstaal van de gebruiker gaan, als die bestaat, door gebruik van links met met vorm Special:MyLanguage/Pagename.

Meer informatie staat in de tutorial Hoe een pagina klaar maken voor vertaling en de detail documentatie van de functie voor paginavertaling.

Ontwikkelaars: De extensie bevat interne ondersteuning voor veel gebruikelijke bestandsformaten voor het vertalen, zoals Java properties en Gettext po-bestanden. Het bevat veel hulpmiddelen, zowel in wiki als op de commando-regel om efficiënt vertalingen te importeren en te exporteren.

Zoeken: Zonder een functie zoeken is het voor vertalers moeilijk om bepaalde berichten te vinden die ze willen vertalen. Het scannen van alle vertalingen of berichten van een project is niet efficiënt. Ook wil je als vertaler graag zien hoe een bepaalde term in die taal eerder is vertaald binnen dat project.

Hiervoor is een speciale pagina Special:SearchTranslations. Vertalers kunnen een bericht vinden met een bepaalde term in elke taal en daarbij verschillende filters gebruiken. Na het zoeken kunnen ze switchen naar de resultaten van de vertalingen van de berichten in kwestie, bijvoorbeeld om de bestaande, ontbrekende of verouderde vertalingen te vinden van een bepaalde term.



Gebruiksmogelijkheden
You can translate almost anything with the Translate extension. Naturally there are specialized tools for translation of certain kind of content like video subtitles, that are better done with those tools, but in general Translate performs very well with any kind of text that can be split into messages with length ranging from one word up to one large paragraph. Longer messages become unwieldy to translate and are just harder to work with.

The three primary use cases that the Translate extension supports are content translation, local interface translation and software translation. All of them are covered in the following sections, with links to tutorials and to reference documentation or in-depth topical help where available. Of the three use cases the interface translation has been utilized the least.



Vertalen van pagina's


De meeste wiki's hebben inhoud die ze beschikbaar willen stellen in meerdere talen. Of het nu over slechts enkele of honderden pagina's gaat, maakt daarbij niet uit. Om te voorkomen dat vertalers tijd verspillen, zouden pagina's slechts gemarkeerd mogen worden voor vertaling wanneer ze redelijk stabiel zijn. Elke wijziging die nadien gebeurt, kan tientallen of honderden vertalingen beïnvloeden en de tijd om die te vernieuwen, loopt snel op. U moet zich hiervan bewust zijn en onnodig werk vermijden, omdat vrijwillige vertalers tijd besteden aan het vertalen en updaten. Wanneer u de Translate-extensie gebruikt om pagina's te vertalen, bent u al op de goede weg om de vertaaltijd op een efficiënte en effectieve manier te benutten.

The way the Translate extension splits up a page into paragraph sized units does not leave too much freedom for translators to change the content. This is usually a good thing and is ideal where continuity and consistency of content across languages is desired. It can be worked around, but in principle this way of doing translations is not generally suitable, for example, for Wikipedia articles, which usually are totally independent of each other. Even if they originally start as a translation from a different language, they usually begin living their own independent life from the original version. With Translate, the original page is always the main version, and new content cannot be developed in translated versions.

With these limitations in mind there are still plenty of cases where this feature is a perfect match. Most, if not all, user documentation falls into this category as well as news-like content that does not change once written. If you have the Translate extension already installed and access rights configured, try creating a page and wrapping the whole text inside and follow the links, or follow the tutorial How to prepare a page for translation.

Groups of pages can be further aggregated together with the Special:AggregateGroups page.



Lokale interfacevertaling in meertalige wiki's
One thing almost every wiki has customized is the sidebar. It is possible to create a message group for the custom sidebar messages and also for other local interface customisations.

One interesting expansion is the multilingual pages or templates built with the magic word. The translatewiki.net main page and some Wikimedia Commons templates are good examples of this. The magic word is an alternative to the content translation feature and it is more suitable to mark-up heavy pages just like the translatewiki.net main page. Another nice feature is that the language of the page automatically follows the user interface language, so there is no need for a language bar, although you might want to have an interface language selector instead.

Setting this up is currently a bit more complicated than content translation and needs software configuration, but it is all covered in the tutorial How to make an interface message group.



Vertalen van software
The Translate extension is a good fit for translating software interface messages. At translatewiki.net, it is used to translate dozens of software products from games to web applications. The Translate extension supports reading and updating translations from and to common formats used in web development including Java properties, Gettext and Yaml files.

Change tracking is also available for externally tracked files, because internally the extension uses a cached derivative version of the localisation files where the source text and its translations are stored, instead of using them directly in their original format. Translation administrators can either use the web interface or a command line interface to check new message definitions and "fuzzy" (request update of) translations when they need updating. This works regardless of the underlying file format or version control system (if any).

With simple command line tools, translation administrators can easily import even a large set of existing translations and with just one command they can export all translations in the correct format and in the correct directory structure. You can export directly to your VCS repository checkout, where you can easily commit changes and new files.



Meer informatie en leerprogramma's


Voor vertalers en beheerders van vertalingen

 * [Tutorial]
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]



Voor beheerders van vertalingen

 * [Tutorial]
 * [Tutorial]
 * [In behandeling]
 * [Tutorial]
 * [Tutorial]
 * [Tutorial]



Referentiedocumentatie voor ontwikkelaars

 * - zou in de meeste gevallen genoeg moeten zijn.
 * [In behandeling]
 * [In behandeling]
 * [In behandeling]
 * [Ongeschreven]
 * - Beschrijft welke jobs betrokken zijn bij het markeren van een pagina voor vertaling of een sectie is vertaald
 * [In behandeling]
 * [Ongeschreven]
 * - Beschrijft welke jobs betrokken zijn bij het markeren van een pagina voor vertaling of een sectie is vertaald
 * - Beschrijft welke jobs betrokken zijn bij het markeren van een pagina voor vertaling of een sectie is vertaald
 * - Beschrijft welke jobs betrokken zijn bij het markeren van een pagina voor vertaling of een sectie is vertaald
 * - Beschrijft welke jobs betrokken zijn bij het markeren van een pagina voor vertaling of een sectie is vertaald

Gerelateerd

 * - Algemene lokalisatie tutorial voor ontwikkelaars, voor gebruik bij hackathons en trainingen
 * - Voegt ondersteuning toe voor het vertalen van SVG-bestanden
 * - Zorgt voor webfonts en invoermethodes
 * m:Translatability – aandachtspunten bij aanmaken pagina's of processen op meertalige wiki's
 * m:Tech/Translators/List - Voeg uzelf toe aan de lijst actieve vertalers
 * m:Tech/Translators/List - Voeg uzelf toe aan de lijst actieve vertalers