This file contains instructions for translators to translate Speech Dispatcher interface to their languages. Speech Dispatcher uses intltool[1] for its internationalization support. Intltool is a superset of gettext[2] so any translator used to gettext .po files can translate Speech Dispatcher the same way. If you're not familiar with gettext po files we recommend that you read the Gettext manual[2] before continuing. == Requirements == To translate Speech Dispatcher you need a git clone of speech dispatcher. If you are not reading this file from a git checkout please check the `INSTALL` file for detailed instructions. You will also need intltool and gettext packages installed, as recommended on the `INSTALL` file. == Adding a new Language == If your locale is not already supported by Speech Dispatcher you must create a new <locale>.po file and translate all contained messages. The following steps explain the process. 1. ON your Speech Dispatcher source directory change to the po directory. 2. Create a pot template for Speech Dispatcher running: $ intltool-update -p This will create a file called Speech Dispatcher.pot with all translatable Speech Dispatcher messages. 3. Create the po template for the current system locale from Speech Dispatcher.pot running $ msginit And follow the prompts. If you want to create a translation for a different locale please run $ msginit -l <locale> where <locale> is the locale's name. This will create a <locale>.po file. msginit will fill in the po template header for you from your environment but we recommend to double-check that information. You may also copy the Speech Dispatcher.pot file to <locale>.po and fill in the header information yourself. At this stage you can remove the Speech-Dispatcher.pot file since it is not needed anymore. 4. Open the file `LINGUAS` and add your locale name there. Please put one locale on each line and keep the file alphabetically sorted. 5. Translate all messages in <locale>.po and run make. If you found errors reported by msgfmt about your <locale>.po file please correct them before continuing. 6. When you're done see the section about testing below. == Updating an existing Translation == When there are new Speech Dispatcher messages for translation or some messages are changed, you need to update your <locale.>.po file. To update an existing po file wit new messages please run $ intltool-update <locale> Where <locale> is the locale po file to update. Then you can translate new messages and, if needed, update the ones gettext guessed wrong when updating the po file. == Testing your Translation == To confirm that your translation works, please install Speech Dispatcher with your translation included and test it with your system configured for your locale. We recommend you test with spd-say and spd-conf, since those are the tools with more translatable content. == Sending your Translation to Speech Dispatcher == When you think your translation is ready to be included in Speech Dispatcher send the po file to our development mailling-list at speechd@lists.freebsoft.org == References == [1] Intltool: http://freedesktop.org/wiki/Software/intltool [2] Gettext Manual: http://www.gnu.org/software/gettext/manual/gettext.html