speechd-discuss
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

No subject


From: bogus
Subject: No subject
Date: Mon, 28 Jun 2010 07:45:32 -0000

po/POTFILES.in.

Documentation for translators is in README.translators.

The INSTALL file is updated with intltool reference.
---
 INSTALL            |    2 +-
 Makefile.am        |    2 +-
 README.translators |   82 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 configure.in       |   18 +++++++++++-
 po/LINGUAS         |    1 +
 po/Makefile.in.in  |    1 +
 6 files changed, 103 insertions(+), 3 deletions(-)
 create mode 100644 README.translators
 create mode 100644 po/LINGUAS
 create mode 120000 po/Makefile.in.in
 create mode 100644 po/POTFILES.in

diff --git a/INSTALL b/INSTALL
index 83ff8f8..285e04d 100644
--- a/INSTALL
+++ b/INSTALL
@@ -17,6 +17,7 @@ We recommend to also install these packages:
  - PulseAudio (http://www.pulseaudio.org)
  - Festival (http://www.cstr.ed.ac.uk/projects/festival/)
  - Espeak (http://espeak.sourceforge.net/)
+ - Intltool 0.40.0+ (http://freedesktop.org/wiki/Software/intltool) for 
internationalization support.
 
 These packages are known to work with Speech Dispatcher:
  Software synthesizers:
@@ -238,4 +239,3 @@ Now the configure file should be created and you can 
proceed like with
 an ordinary instalation.
 
 
-    
diff --git a/Makefile.am b/Makefile.am
index 5353ce9..b7e507b 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,6 +1,6 @@
 ## Process this file with automake to produce Makefile.in
 
-SUBDIRS= src config doc
+SUBDIRS= src config doc po
 
 EXTRA_DIST= ChangeLog NEWS TODO AUTHORS COPYING INSTALL README intl/*.c 
intl/*.h build.sh version.sh
 
diff --git a/README.translators b/README.translators
new file mode 100644
index 0000000..f07afb5
--- /dev/null
+++ b/README.translators
@@ -0,0 +1,82 @@
+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 bellow. 
+
+== 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 at lists.freebsoft.org 
+
+== References == 
+
+[1] Intltool: http://freedesktop.org/wiki/Software/intltool
+[2] Gettext Manual: http://www.gnu.org/software/gettext/manual/gettext.html
diff --git a/configure.in b/configure.in
index ca6c49b..c4d1fa0 100644
--- a/configure.in
+++ b/configure.in
@@ -2,6 +2,8 @@
 dnl Process this file with autoconf to produce a configure script.
 AC_INIT(configure.in)
 
+
+
 AC_LANG(C)
 
 dnl progs
@@ -18,6 +20,16 @@ AC_ARG_ENABLE([python],
        [],
        [enable_python=check])
 
+#
+# Setup GETTEXT
+#
+GETTEXT_PACKAGE=speech-dispatcher
+AC_SUBST(GETTEXT_PACKAGE)
+AC_DEFINE_UNQUOTED(GETTEXT_PACKAGE, "$GETTEXT_PACKAGE", [Gettext package])
+AM_GLIB_GNU_GETTEXT
+IT_PROG_INTLTOOL([0.40.0])
+
+
 dnl Checks for header files.
 AC_HEADER_STDC
 AC_CHECK_HEADERS(limits.h sys/ioctl.h sys/time.h unistd.h)
@@ -399,5 +411,9 @@ AC_SUBST(ERROR_CFLAGS)
 AC_SUBST(RPATH)
 AC_SUBST(RDYNAMIC)
 
-AC_OUTPUT([Makefile src/Makefile src/server/Makefile src/modules/Makefile 
src/c/Makefile src/c/api/Makefile src/c/clients/Makefile 
src/c/clients/say/Makefile src/c/clients/spdsend/Makefile src/tests/Makefile 
src/audio/Makefile src/audio/static_plugins.c config/Makefile 
config/modules/Makefile config/clients/Makefile doc/Makefile 
src/python/Makefile src/python/speechd/Makefile 
src/python/speechd_config/Makefile])
+# Path of installed localization files:
+localedir=${datadir}/locale
+AC_SUBST(localedir)
+
+AC_OUTPUT([Makefile src/Makefile src/server/Makefile src/modules/Makefile 
src/c/Makefile src/c/api/Makefile src/c/clients/Makefile 
src/c/clients/say/Makefile src/c/clients/spdsend/Makefile src/tests/Makefile 
src/audio/Makefile src/audio/static_plugins.c config/Makefile 
config/modules/Makefile config/clients/Makefile doc/Makefile 
src/python/Makefile src/python/speechd/Makefile 
src/python/speechd_config/Makefile po/Makefile.in])
 
diff --git a/po/LINGUAS b/po/LINGUAS
new file mode 100644
index 0000000..6fa3550
--- /dev/null
+++ b/po/LINGUAS
@@ -0,0 +1 @@
+# leep this file sorted, one language per line.
diff --git a/po/Makefile.in.in b/po/Makefile.in.in
new file mode 120000
index 0000000..e4713cf
--- /dev/null
+++ b/po/Makefile.in.in
@@ -0,0 +1 @@
+/usr/share/intltool/Makefile.in.in
\ No newline at end of file
diff --git a/po/POTFILES.in b/po/POTFILES.in
new file mode 100644
index 0000000..e69de29
-- 
1.7.0.4




reply via email to

[Prev in Thread] Current Thread [Next in Thread]