source: branches/PublicaMundi_David-devel/docs/contribute/translate.rst @ 697

.. _contribute_trans:



Contribute translation

===============



Anybody can take part to the `ZOO-Project <http://zoo-project.org>`__ translation and is welcome to:



 * Translate ZOO-Services configuration files

   

 * Translate documentation

   



ZCFG translation

--------------------------



First of all, use the following commands from your Services Provider directory in order to extract all the messages to translate from the ZCFG files :



  ::

  

      #!/bin/bash

      for j in cgi-env/*zcfg ; 

        do 

          for i in Title Abstract; 

           do

            grep $i $j | sed "s:$i = :_ss(\":g;s:$:\"):g" ;

           done;

       done > locale/.cache/my_service_string_to_translate.c

   



Then generate the 'messages.po' file based on the Services Provider source code using the following command :



  ::

  

      #!/bin/bash

      xgettext service.c locale/.cache/my_service_string_to_translate.c -o message.po -p locale/po/ -k_ss



Once 'messages.po' is created, use the following command to create the po file for the targeted language for translation. We will use the French language here as an example :



  ::

  

      #!/bin/bash

      cd locale/po/

      msginit -i messages.po -o zoo_fr_FR.po -l fr



Edit the zoo_fr_FR.po file with your favorite text editor or using one of the following tools :



 * `poedit <http://www.poedit.net/>`__

 * `virtaal <http://translate.sourceforge.net/wiki/virtaal/index>`__

 * `transifex <https://www.transifex.net/>`__

 

Once the zoo_fr_FR.po file is completed, you can generate and install the corresponding *mo* file using the following command : 



  ::

  

      #!/bin/bash

      msgfmt locale/po/zoo_fr_FR.po -o /usr/share/locale/fr/LC_MESSAGES/zoo-services.mo





In order to test the Services Provider ZCFG and internal messages

translation, please add the language argument to you request. As an

example, such a request:



http://youserver/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS



would become the following:



http://youserver/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS&language=fr-FR



The following command may also be useful in order to pull all the translations already available for a specific language.



  ::

  

      #!sh

      msgcat -o compilation.po $(find ../../ -name fr_FR.utf8.po)

      msgfmt compilation.po -o /usr/share/locale/fr/LC_MESSAGES/zoo-services.mo





Documentation translation

--------------------------



Translate the `ZOO-Project <http://zoo-project.org>`__ documentation in your language !



Please refer to the :ref:`<contribute_doc>` section to learn more.