.. _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 = :_(\":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_

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 :

 * [http://www.poedit.net/ poedit]
 * [http://translate.sourceforge.net/wiki/virtaal/index virtaal]
 * [https://www.transifex.net/projects/p/grass6/c/grass64/ transifex]
 
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.