Translatable modules/Principles/nl

Dit zijn de principes volgens welk het Vertaalbare modules framework zal worden ontworpen, gemaakt en ter beschikking komt.

Het ervaren van het vertalen moet gelijk zijn aan dat bij van de core, de extensies en pagina's

De gebruikerservaring van vertalers moet vergelijkbaar zijn aan die bij het vertalen van core MediaWiki en extensies op translatewiki.net, het vertalen van pagina's op meta, mediawiki.org, enz. Er zijn wel wat aanpassingen noodzakelijk.

Alle meertalige wiki's

In deze fase moet het project de zaken in kaart brengen die nodig zijn voor meertalige Wikimedia wiki's: Wikidata, Commons, Meta, mediawiki.org, en mogelijk ook Outreach, Incubator, Multi-Wikisource, Beta Wikiversity, Wikimania en Wikispecies. Elke wiki die de extensie Translate gebruikt komt in aanmerking. (Alle Wikimedia inhoud wiki's gebruiken Scribunto.)

Het zou ook bruikbaar kunnen zijn voor elke wiki buiten de Wikimedia wereld die Scribunto modules gebruikt.

Doel

Nadat het framework is ontwikkelt en uitgerold, kunnen de ontwikkelaars van module aangemoedigd kunnen worden om nieuwe modules aan te maken die vertaalberichten hebben in het nieuwe framework en bestaande modules kunnen converteren naar dit framework.

Om deze omschakeling gemakkelijker te maken voor de ontwikkelaars van modules en sjablonen, is het mogelijk goed om scripts te ontwikkelen die bronteksten en vertalingen converteren uit bestaande modules naar het nieuwe framework.

Standaardisatie

Hetzelfde framework kan gebruikt worden op alle meertalige websites van Wikimedia. Alle Scribunto functies voor het laden en verwerken van vertaalberichten zullen toegevoegd worden aan de extensie, die overal beschikbaar gemaakt zal worden. Er dienen geen lokale modules nodig te moeten zijn om het framework te gebruiken.

Wiki principes

De bronteksten moeten gemakkelijk te wijzigen zijn door de wiki-editors, vergelijkbaar met nu de modules en de sjablonen. Er kunnen enkele beveiligd tegen bewerking door iedereen moeten worden vanwege vandalisme, dus dat het beperkt is tot leden van groepen als “interface editors” of “sysops”, afhankelijk van het beleid van die wiki gemeenschap.

Het moet redelijk eenvoudig zijn om te zien wie een vertaling heeft gedaan, dat kan bijvoorbeeld via de geschiedenis of de logs.

Vertaalberichten vinden

Het moet eenvoudig te zien zijn in welke modules er nog te vertaalwerk nodig is. Ook hier weer vergelijkbaar als op translatewiki.net. Het beginpunt moet de selectie van de vertaalgroep in Translate zijn. De groepering moet door de wiki gemeenschap worden gedaan. Er is groepering nodig omdat een wiki wel duizenden vertaalbare modules kan hebben. Het opzoeken in een vertaalberichtengroep is dan niet te doen.

Het dient ook gemakkelijk te zijn om berichten te vinden die van de module documentatie-pagina's vertaald moeten worden, en op de pagina's waardoor die worden aangeroepen en het gebruiken van ?uselang=qqx in de URL op de berichten keys te vinden.

Het moet mogelijk zijn om enkele vertaalberichten als optioneel te markeren. Dit als in translatewiki.net.

Performance en updaten

Het nieuwe framework moet niet al te zeer een belasting zijn voor de performance van de wiki. Geen extra pagina opslaan, meer laden of langere opbouw van de pagina.

Na het bijwerken van een brontekst moet het onmiddellijk te zien zijn op de pagina's waar de module wordt gebruikt. De bestaande vertaalberichten moeten als verouderd in de vertaalinterface worden getoond. Dat verouderd zijn moet ook in de weergave van de normale lezer te zien zijn.

Ruwe berichten bewerken

De bronberichten worden bewerkt in de opslag die wordt geselecteerd. Een wiki pagina met JSON, een vertaalbare wikitext pagina of iets anders (nog te bepalen). Een bronbericht moet context documentatie hebben, net als voor “qqq” in core MediaWiki en extensies, ze zullen met een normale editor bewerkt worden of met het bijbehorende Translate onderdeel.

Het met een gewone editor bewerken van vertalingen zou niet nodig moeten zijn. Vertalingen behoren via een interface bewerkt te worden. Al heeft de gemeenschap daarover het laatste woord.

Lokaal aanpassen van berichten

Wiki's moeten van andere wiki's overgenomen vertalingen kunnen bewerken. Dit is niet direct relevant voor enkele wiki's (tenzij wij de vertalingen voor alle site op Commons zetten), maar het wordt van belang als modules globaal worden.

Berichten syntaxis en parameters

In core MediaWiki en extensies hebben vertaalberichten vaak parameters, ook wel bekend als “placeholders”. Ze heten $1, $2, enz., deze worden in run-time vervangen door een waarde. Een parameter maakt een vertaalbericht robuust omdat de woordvolgorde per taal kan verschillen.

De magische woorden PLURAL, GENDER en GRAMMAR worden in module berichten ondersteund, net zoals in MediaWiki berichten.

Vertaalgeheugen

In de interface van Translate moet weer het vertaalgeheugen worden gebruikt.

Berichten delen tussen modules

De vraag of vertalingen gedeeld moeten worden over verschillende modules staat nog open. Het wordt meestal ontraden om dat te doen (Hergebruik vertalingen voorkomen), echter mogelijk dat module ontwikkelaars daar anders over denken.

Dit wordt voorgelegd aan de gemeenschap.

Importeren en exporteren

Het moet mogelijk zijn om berichten te importeren en te exporteren met Special:Import en Special:Export. Dit is vergelijkbaar met de sjabloonstijlen, Als een sjabloon die gebruikt dat wordt bij het importeren ook automatisch de benodigde CSS pagina's in hetzelfde XML package meegenomen.

Meer informatie

• Discussie over vertaalbare modules.
• Belanghebbenden in het project
• Huidige oplossingen
• Voorgestelde oplossingen - het deel waar de meeste discussie over en beoordeling van nodig is
• Engineering overwegingen