Onderhoud van vertalingen

Nu uw plugin vertaalbaar is gemaakt, hoe kunt u het werkelijk laten vertalen? In het algemeen hoeft u zich daar alleen zorgen over te maken bij het ontwikkelen van een externe plugin. Voor plugins in de hoofd-repository van RKWard wordt al deze magie voor u gedaan. Hier is in principe hoe dit werkt voor externe plug-ins. Merk op dat u de hulpmiddelen "gettext" moet hebben geïnstalleerd:

  • Merk alle strings aan, en geef context op en commentaar waar nodig

  • Laat python3 scripts/update_plugin_messages.py --extract-only /pad/naar/mijn.pluginmap werken. scripts/update_plugin_messages.py is thans niet aanwezig in de bronuitgaven (source releases), maar kan worden gevonden in de repository voor bronbestanden.

  • Geef het resulterende rkward__POID.pot-bestand uit aan uw vertalers. Voor externe plugins wordt aangeraden ze te plaatsen in een submap "po" in inst/rkward.

  • De vertaler opent het bestand in een vertaalhulpmiddel zoals lokalize. Eigenlijk zou u, ook als u niet van plan bent een vertaling voor te bereiden, deze stap zelf eens moeten doen. Bekijk de strings en zoek naar mogelijke problemen / dubbelzinnigheden.

  • De vertaler slaat de vertaling op als rkward__POID.xx.po (waarin xx de taalcode is, Nederlands is nl), en stuurt het aan u terug.

  • Kopieer rkward__POID.xx.po naar uw bronbestanden, naast rkward__POID.pot. Laat python3 scripts/update_plugin_messages.py /pad/naar/mijn.pluginmap werken. (Merk op: nu zonder --extract-only). Hierdoor wordt de vertaling samengevoegd (merge) met alle tussentijdse veranderingen in de strings, de vertaling gecompileerd, en geïnstalleerd in DIR_OF_PLUGINMAP/po/xx/LC_MESSAGES/rkward__POID.mo (waarin xx weer de taalcode (Nederlands: nl) is).

  • U moet ook de niet-gecompileerde vertaling (bijv. rkward__POID.xx.po) bijsluiten in uw distributie, in de "po" subdirectory.

  • Voor elke update van uw plugin, laat u python3 scripts/update_plugin_messages.py /pad/naar/mijn.pluginmap werken, zodat het .pot-bestand wordt bijgewerkt, maar ook de bestaande .po-files, en de catalogus van gecompileerde messages (berichten).