This file contains instructions for translators to translate Speech Dispatcher interface to their languages. Speech Dispatcher uses gettext[1] for its internationalization support. 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 gettext package 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 .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: $ make -C po speech-dispatcher.pot-update 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 where is the locale's name. This will create a .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 .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 .po and run make. If you found errors reported by msgfmt about your .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 .po file. To update an existing po file with new messages please run $ make -C po .po-update Where 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-discuss@nongnu.org == References == [1] Gettext: https://www.gnu.org/software/gettext/ [2] Gettext Manual: https://www.gnu.org/software/gettext/manual/gettext.html Copyright (C) 2010 Rui Batista Copyright (C) 2012 Brailcom, o.p.s Copyright (C) 2017 Jan Tojnar This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details (file COPYING in the root directory). You should have received a copy of the GNU General Public License along with this program. If not, see .