[commits] [Wiki] changed: Doc/Dev/TranslationH4

[Wiki Guest]

guest [213.197.150.2]  Thu, 19 May 2011 10:28:00 +0000

Modified page: http://wiki.horde.org/Doc/Dev/TranslationH4
New Revision:  1.1
Change log:  H4 updates

@@ -3,18 +3,18 @@
  [[toc]]

  ----

-This document is intended to help developers translate Horde 4  
modules using the **/horde/bin/translation.php** script.
+This document is intended to help developers translate Horde 4  
modules using the **/horde/bin/horde-translation** script.

  See also {{horde/docs/TRANSLATIONS}}.

  + The Translation Script
  <code type="php">
-$ php horde/bin/translation
+$ php horde/bin/horde-translation

-Usage: translation.php [options] command [command-options]
-       translation.php [help|-h|--help] [command]
+Usage: horde-translation [options] command [command-options]
+       horde-translation [help|-h|--help] [command]

  Helper application to create and maintain translations for the Horde
  framework and its applications.
  For further information, see horde/docs/TRANSLATIONS.
@@ -48,60 +48,60 @@

  Please report any bugs to i18n at lists.horde.org.
  </code>

-Any commands can be called with {{translation.php COMMAND help}} for  
further information.
+Any commands can be called with {{horde-translation COMMAND help}}  
for further information.

  +++ Making a Translation

  ++ Intialize/Merge the Translation

  If this is the first time, run:

  <code type="php">
-php translation.php init --module=MODULE --locale=xx_XX
+php horde-translation init --module=MODULE --locale=xx_XX
  </code>

  where MODULE is the module folder and xx_XX is the locale (country  
and language code), e.g. en_GB or es_ES

  If you didn't create one before, build the compendium with all  
existing translations for the locale from other Horde applications:

  <code type="php">
-php translation.php compendium --locale=xx_XX
+php horde-translation compendium --locale=xx_XX
  </code>

  Finally, try to get as many translations as possible from the  
compendium into the new translation:

  <code type="php">
-php translation.php merge --module=MODULE --locale=xx_XX
+php horde-translation merge --module=MODULE --locale=xx_XX
  </code>

  ++ Edit and Update the Translation

  Create the compendium file (do this one time only):

  <code type="php">
-php translation.php compendium --locale=xx_XX
+php horde-translation compendium --locale=xx_XX
  </code>

  Clean up obsolete entries:

  <code type="php">
-php translation.php cleanup
+php horde-translation cleanup
  </code>

  Prepare the file to edit:

  <code type="php">
-php translation.php update --module=MODULE --locale=xx_XX
+php horde-translation update --module=MODULE --locale=xx_XX
  </code>

-Edit the translation file //horde/MODULE/po/xx_XX// using a suitable  
gettext editing program, such as KBabel or poedit and save the file.
+Edit the translation file  
{{horde/MODULE/locale/xx_XX/LC_MESSAGES/module.po}} using a suitable  
gettext editing program, such as KBabel or poedit and save the file.

  Compile the translation:

  <code type="php">
-php translation.php make
+php horde-translation make
  </code>

  If you want to see the changes right away, restart the http server  
(i.e. //service httpd restart// in Fedora, CentOS and similar OSes).

@@ -109,21 +109,21 @@

  First extract all new and changed entries from the English XML help  
file and merge them with the existing ones:

  <code type="php">
-php translation.php update-help --module=MODULE --locale=xx_XX
+php horde-translation update-help --module=MODULE --locale=xx_XX
  </code>

  Then edit the help file for the necessary language using a text editor or vi:

  <code type="php">
-$ vi horde/easyacdc/locale/xx_XX/help.xml
+$ vi horde/MODULE/locale/xx_XX/help.xml
  </code>

  Finally:

  <code type="php">
-php translation.php make-help --module=MODULE --locale=xx_XX
+php horde-translation make-help --module=MODULE --locale=xx_XX
  </code>

  ++ Translating framework modules