Translatable modules/nl

 Hoe kunnen we de vertaling van Lua modules zo gemakkelijk maken als de vertaling van MediaWiki en extensies op translatewiki.net? Dit is een eerste consultatie over het implementeren van Vertaalbare modules. De geplande consultatie voor opmerkingen loopt tot eind september 2020. Het doel van deze documenten is het begrijpen van de zaken die ontwikkelaars en gebruikers nodig hebben bij Lua modules op een manier die de software-omtwikkelaars kunnen gebruiken om verbeteringen aan te brengen.

Introductie
Translatable modules is een project om de definiëren, implementeren, documenteren en toepassen van een framework voor het verbeteren van de mogelijkheid om modules te vertalen en te delen. Het doel is om de berichten in de gebruikersinterface in de Scribunto modules op wiki websites als Wikidata en Commons, eenvoudig te kunnen vertalen, net zoals dat bij de core van MediaWiki, de extensies en de vertaalbare pagina's kan.

Onze vragen aan de gemeenschap:


 * 1) Er zijn  voor het organiseren van code en vertaalberichten voorgesteld. Wat zou de beste manier zijn om de module code te organiseren?
 * 2) Als dat framework ontwikkelt is en toegepast wordt, is het dan gemakkelijk om nieuwe methodes te ontwikkelen met gebruik van dit framework en misschien wel bestaande modules aan te passen zodat ze het ook gebruiken?
 * 3) Welke bestaande modules dienen volgens u voorrang te krijgen bij de vertaling?

Als u meestal artikelen en ander wiki-pagina's bewerkt, dan wordt uw gebruikerservaring niet echt gewijzigd, maar uw feedback is welkom.

Als u betrokken bent bij het onderhouden van sjablonen of Scribunto modules of bij het beheren van vertaalbare pagina's, dan kunnen deze wijzigingen uw gebruikerservaringen bij deze taken sterk beïnvloeden, uw feedback is dan zeer belangrijk.

Achtergrond
Alle Wikimedia projecten hebben hun belangrijkste functionaliteit geïmplementeerd als wikitext sjablonen en/of Lua modules: hatnotes, infoboxen, welkomstberichten, links en referenties, afbeeldingsbeschrijvingen en licentie informatie, ...

Deze sjablonen en modules zijn code. Deze code is ontwikkelt door getrainde en ervaren leden van de gemeenschap die de bewerkingen doet. Het zorgt voor de functionaliteit die de gemeenschap wil, nodig heeft en nu regelmatig gebruikt. Hoewel de meeste per stuk eenvoudig zijn, kan het tezamen vergelijkbaar zijn met de complexiteit, het kritiek zijn en wijdverspreid met de code van MediaWiki extensies. Anders dan extensies hebben sjablonen en modules geen robuust, stabiel en consistent framework voor internationalisatie en lokalisatie, ook al worden veel van hen in meerdere talen gebruikt.

Alle MediaWiki extensies en MediaWiki core worden vertaald (lokalisatie) op translatewiki.net, waar vrijwilligers gemakkelijk vertaalberichten (teksten) van de te vertalen componenten, kunnen vertalen naar hun eigen taal. Hierbij hebben ze niets te maken met wikitext. Om translatewiki.net te kunnen gebruiken hoeven ze maar een basiskennis van de syntaxis van de wiki te kennen. De translatewiki.net software controleert de vertaling op het technisch valide zijn en heeft hulpmiddelen voor het vertalen van verouderde tekstberichten, geeft statistieken over de vertaling, het zoeken, het fileren, ...

Dat zijn zaken die sjablonen en modules niet hebben. If they are translatable at all, this is done by editing wiki pages with complex wiki syntax or Lua code. This process is error-prone, less discoverable, and considerably more difficult. Some templates are translatable as pages using the Translate extensions, which makes their localization experience similar for translators to the experience of localizing extensions, but the framework for doing this is not consistent for the template and module developers.

It is therefore desirable to make it possible to translate the human-readable user interface messages of modules and templates using a process that is comparable to the process of translating MediaWiki core and extensions.

Doel
The scope of this project only includes the translation of user interface messages used in modules, and only within a single wiki. This particularly pertains to Wikimedia sites that are already multilingual: Commons, Wikidata, Meta, mediawiki.org, Wikispecies, and others.

This current proposal does not deal with the following things:


 * Localization of templates. As mentioned above, this is closely related and probably desirable as well, but it is left for a later stage. The modules’ technology (Scribunto) is more autonomous, unlike templates, which are tightly integrated with core MediaWiki, and they have somewhat different localization requirements. However, the work on translatable modules should try to be forward compatible, so that whatever is done here will also be reusable for templates.
 * Localization of module titles and function identifiers. Templates and their parameters usually have names in the content language of the wiki. Unlike templates, modules are usually invoked from templates and only rarely directly from content pages or discussion pages. It is therefore not necessary to allow their translation. This project only deals with the internationalization and localization of the messages that the modules show to the readers.
 * Localization of gadgets. Similarly to templates, gadgets should be conveniently localizable, but their technology is significantly different. It may be good to make it reusable, but it’s not the highest priority for this project.
 * Using templates and modules across wikis (“Global templates”). This is desirable as well, and making modules robustly translatable will make the implementation of Global templates and modules much easier. This is not in the scope of the project described in this document, however. It makes sense to make modules translatable as one of the first steps towards global modules and templates, and the project should certainly try to be forward-compatible with global templates and modules, but it nevertheless stands on its own.
 * Data conversion. The conversion of digits (123 / ١٢٣ / १२३ / ၁၂၃), units (km / miles), script variants (Latin / Cyrillic Serbian, Simplified / Traditional Chinese, etc.), and so on are not a part of this project. These things are already handled by MediaWiki internationalization functions or by the code of modules and templates. This project is only about the user interface messages.



Meer informatie

 * Discussie over Translatable modules.
 * - het deel waar de meeste discussie over en beoordeling van nodig is
 * - het deel waar de meeste discussie over en beoordeling van nodig is
 * - het deel waar de meeste discussie over en beoordeling van nodig is
 * - het deel waar de meeste discussie over en beoordeling van nodig is