i18n/l10n and Mixxx

Required tools to update translations are:

• lupdate and lrelease, part of qt development toolkit
• po2ts and ts2po, part of Translate Toolkit

This procedure extracts translatable strings from Mixxx's code into template files (Qt/POT) so that Launchpad's interface can present the most current strings to translators.

• Make a clean checkout of the Mixxx code branch you are in. NO EXCEPTIONS
• lupdate src -recursive -extensions cpp,h,ui -ts res/translations/mixxx.ts
• ts2po -P -i res/translations/mixxx.ts -o res/translations/mixxx/mixxx.pot
• Commit, push.

Launchpad will pick up the changes to the template automatically.

TODO: make the sconscript do this as part of a normal build so code changes that change or add strings automatically update the templates.

This procedure updates Mixxx with translations (PO files) that have been contributed by Launchpad users.

• For every PO file in res/translations/mixxx/, po2ts res/translations/mixxx/xx.po res/translations/mixxx_xx.ts
  • In ZSH: for XX in res/translations/mixxx/*.po; do po2ts -i $XX -o res/translations/mixxx_${$(basename $XX)%.*}.ts; done
• For every mixxx_xx.ts file in res/translations/, lrelease res/translations/mixxx_xx.ts -qm res/translations/mixxx_xx.qm
  • In ZSH: for XX in res/translations/mixxx_*.ts; do lrelease -nountranslated $XX -qm res/translations/${$(basename $XX)%.*}.qm; done
  • If you are testing a translation and would like untranslated strings to show up as blank, do not give the 'nountranslated' argument to lrelease.
• Add all new translation translation TS and QM files to Bazaar
  • In ZSH: bzr add res/translations/mixxx_*.(ts|qm)
• Update res/mixxx.qrc file to add any new languages that were not previously present.
• Commit, push.

TODO: make the sconscript do this as part of a normal build so Mixxx contains the latest translations.