Jutoh Translations

Contributing a translation

If you would like to contribute to a translation of Jutoh, please download the latest .po file in the Download page, translate the strings, and then compile a .mo file, for example using poEdit. The .mo file should be called jutoh.mo and should be placed in a suitably-named directory in the Jutoh installation (next to the executable). For example, a French translation would go in the fr_FR directory. You should also copy the file wxstd.mo from a directory under locale in the wxWidgets 2.8.12 distribution.

Then when you restart Jutoh, that language should be available in the General Settings dialog; change to this language, and restart Jutoh once more.

If you email me your translation, I can bundle it with the next version of Jutoh.

Thank you in advance for your translations!

Resources and help files

If a resource file exists in the translation directory, it will be used, otherwise the default file (in the en_GB folder or in the application folder) will be used. The following is a list of the resources that should be translated. Please note that these files should be saved in Unicode UTF-8 format. You can use an editor such as Programmer's Notepad to do this, or even Windows Notepad.

• jutoh.htb: the Jutoh Manual
• TechTips.htb: the Technical Tips
• jutoh.bin: resources file in zip format, containing images and HTML files under the Resources folder name, including:
  • about.htm: About text
  • register.htm: Registration dialog text
  • dictionary.htm: Dictionary import dialog text

If you wish to translate the HTB files, I can supply free registration for Anthemion HelpBlocks to do this and can send the Jutoh manual sources on request.

More on working with .po files

When starting a translation, take a copy of the .po file downloaded from this site, renamed to jutoh.po. For each msgid string there should be an equivalent msgstr, the translation.

When a new version of Jutoh is released, you will probably find that some strings have been changed. Download the latest .po again, and merge it with your original .po file like this:

  msgmerge --quiet --no-fuzzy-matching jutoh.po jutoh1.00.po > jutoh_new.po
  mv jutoh_new.po jutoh.po

Redundant translations (where the original string has been changed or removed) are commented out and added to the end of the file. Open the file in poEdit to find the untranslated strings.

If you wish to compile the .po into a .mo for testing purposes, you can use poEdit or you can run the command manually:

  msgfmt -o jutoh.mo jutoh.po

Windows binaries of the gettext tools, including msgmerge.exe and msgfmt.exe, are available here.

Other tips:

• It is not necessary to preserve the same menu command mnemonics as the original English mnemonics.
• Ask us if you have questions about the meaning of any of the strings.

More on working with help files

The files jutoh.htb and TechTips.htb are all wxWidgets HTML Help files that must be edited using HelpBlocks.

Here are some guidelines for translating these files:

• Please request the source files from us, and copy to a new location. When you have finished, please submit all files back to us.
• The structure must remain identical to the original in all translations. In particular, the name of the topic identifier (shown in the page properties dialog) should not be changed and it should be in the same relative position. Otherwise, the identifiers associated with each topic name will not be the same, and the wrong pages will be displayed when Help is pressed in the application.
• The What's New? page does not need to be translated, though you can add a note at the start in the native language.

Table of languages and their canonical (directory) names