Manutenzione delle traduzioni

Ora che l'estensione è stata resa traducibile, come è possibile tradurla effettivamente? In generale, è necessario preoccuparsi solo di questo quando si sviluppa un'estensione esterna. Per le estensioni nel deposito principale di RKWard, tutto è già pronto. Ecco il flusso di lavoro di base. Notare che è necessario che gli strumenti «gettext» siano installati:

  • Contrassegna tutte le stringhe, fornendo contesto e commenti in base alle esigenze

  • Eseguire python3 scripts/update_plugin_messages.py --extract-only /percorso/a/mia.pluginmap. scripts/update_plugin_messages.py non fa attualmente parte dei sorgenti rilasciati, ma può essere trovato in un checkout del deposito dei sorgenti.

  • Distribuire il file rkward__POID.pot risultante ai propri traduttori. Per le estensioni esterne, si consiglia di inserirlo in una sottocartella «po» in inst/rkward.

  • Il traduttore apre il file in uno strumento di traduzione come lokalize. In realtà, anche se non si ha intenzione di preparare alcuna traduzione, si dovrebbe provare questo passaggio per se stessi. Sfogliare le stringhe estratte alla ricerca di problemi / ambiguità.

  • Il traduttore salva la traduzione come rkward__POID.xx.po (dove xx è il codice della lingua) e te lo restituisce.

  • Copia rkward__POID.xx.po nelle tue fonti, accanto a rkward__POID.pot. Esegui python3 scripts/update_plugin_messages.py /path/to/my.pluginmap (Nota: senza --extract-only, questa volta). Questo unirà la traduzione con eventuali modifiche provvisorie alla stringa, compilerà la traduzione e la installerà in DIR_OF_PLUGINMAP/po/xx/LC_MESSAGES/rkward__POID.mo (dove xx è ancora il codice della lingua).

  • Si dovrebbe includere anche la traduzione non compilata (cioè rkward__POID.xx.po) nella propria distribuzione, nella sottocartella «po».

  • Per qualsiasi aggiornamento della propria estensione, eseguire python3 scripts/update_plugin_messages.py /percorso/a/mia.pluginmap per aggiornare il file .pot, ma anche i file .po esistenti e i cataloghi dei messaggi compilati.