Help:Extension:Translate/Translation aids/nl

Vertaal hulpmiddelen zijn modules die bruikbare en nodige informatie geven aan een vertaler bij het vertalen. Verschillende hulpmiddelen kunnen suggesties geven uit het vertaalgeheugen, machine vertaling, documentatie over het bericht of zelfs uit zoiets eenvoudigs als de definitie van het bericht, de tekst die vertaald moet worden.

Er is wat overlap tussen de gegevens die berichtengroep en de hulpmiddelen aanleveren, maar de regel is dat de berichtengroep alleen de informatie geeft om aan te geven in de lijst met welke berichten vertaald moeten worden: definitie, status van de vertaling, laatste vertaler (men kan alleen vertalingen beoordelen als men die niet zelf heeft vertaald) enz.

De extensie Translate heeft veel classes om het vertalen te ondersteunen. Elke class die de class TranslationAid uitbreidt hoef alleen een methode  te maken. Die moet dan de gegevens in een genest array gestructureerd teruggeven. Deze modules kunnen direct via PHP worden aangeroepen of via de WebAPI.



Hoe vertaalhulpmiddelen te gebruiken
Een voorbeeld om de documentatie van een bericht op te halen, indien beschikbaar. 

Hoe de vertaal API te gebruiken
Zoals hierboven al genoemd, vertaalhulpmiddelen zijn beschikbaar via een WebAPI, die het MediaWiki WebAPI framework gebruikt. Met een simpele HTTP GET met de URL http://translatewiki.net/w/api.php?action=translationaids&title=MediaWiki%3AJan%2Fde. Er zijn verschillende formaten mogelijk, maar JSON en XML zijn de populairste. Bij deze API is er geen authenticatie, maar andere hulpmiddelen als "inotherlanguages" gebruiken de gebruikersvoorkeur om te bepalen welke talen er gebruikt moeten worden. Dan is het wel nodig om eerst in te loggen, zoals aangegeven in de MediaWiki WebAPI documentatie.

Het antwoord ziet er ongeveer als volg uit (dit is in json formaat): Elk verzocht hulpmiddel heeft hier een key (als het verzoek niet stukloopt), maar met exceptions aan de PHP-kant, aan de JavaScript kant kan elk hulpmiddel een "error" gezet hebben met een fouttekst als waarde. Hierboven staat een voorbeeld met de. Het geeft aan dat het het verschil niet kan weergeven, de definitie is na de laatste vertaling niet gewijzigd (dat zal hopelijk de normale situatie zijn).



JavaScript voorbeeld
Dit speelt ook bij JavaScript. Standaard geeft de API alle hulpmiddelen, maar u kunt aangeven welke u wilt hebben met de parameter. In het voorbeeld gebruiken we jsonp om langs de beperking cross-site te werken. In jsonp kunnen geen schrijfacties worden gedaan, dus bij gebruik van deze API in JavaScript dient u te hebben: een proxy (voor het uitvoeren van het script op dezelfde host) of een 'helper' (nog niet geïmplementeerd) van de doel website. 

Naamconventies en returnwaarden
Elk vertaalhulpmiddel heeft een identifier, hierin zouden speciale tekens voorkomen moeten worden. Speciale tekens zijn dan ook de  en de.

Het array dat elke vertaling wordt teruggegeven wordt door de ontwikkelaar bepaald, maar wij geven de volgende algemene aanbevelingen.

If only one text value is returned, it should use  as the key of the field. Language should be provided in field. Users of this data should ensure that in HTML and elsewhere the text is tagged properly with the provided language and directionality (not provided here). If there is HTML output, it should be available with key. Examples of this are message documentation and diffs.

Various kinds of translation suggestions like machine translation and translation memories should use these keys when they make sense:


 * ,  en   (target taal is impliciet hetzelfde als de taal van de vertaling)
 * : geeft de gebruikte service aan
 * : value in range [0,1], higher value means that the quality of the suggestions is very good.

List of standard aids
[field] Means that the return value is a list. In PHP that means array with numerical indexes + one with key ; see above why this is needed.