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
Here is the same thing for JavaScript. By default the API returns all aids, but you can request specific ones with the  param. In the example we are using jsonp to work around cross site request limitations. Be aware that you cannot execute any write actions with jsonp, so if you are using this API from JavaScript you will need: to have a proxy; to run the script on the same host; or to load a little helper (not yet implemented) from the target site. 

Naamconventies en returnwaarden
Each translation aid has a unique string identifier. Identifiers should avoid special characters, especially those which are not valid in JavaScript identifiers, like  and.

The array that is returned by each translation aid is up to the developer, but should follow some general recommendations.

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.