mandriva
 

How to translate the MDS web interface

Informational / Draft

Cédric Delfosse

Revision History
Revision $Revision: 1339 $ $Date: 2008-03-14 14:11:58 +0100 (Fri, 14 Mar 2008) $ $Author: cdelfosse $

Abstract

This document explains how to help the MDS project to make the MMC support more languages


1. Introduction

You don't need to be a programmer to do some translation works.

Please subscribe to the MDS i18n mailing list, and tell us about the language you want to work on (somebody else may already translates this language).

2. How to translate the MDS (easy)

Connect to the MDS translation status page and download the .po file corresponding to your language and the module you want to translate. If your language is not listed, download the template file available at the beginning of the status page.

You can then start to translate the file with applications like poedit or kbabel.

Once finished, send the file to the MDS i18n or the MDS devel mailing list, and we will integrate your work.

3. How to translate the MDS (harder)

This section is for people with some development background. The translation process is harder, but it will allow you to display and test your translations in the MMC web interface.

The MMC web interface uses the PHP gettext library to provide a multilanguage experience.

Please note that gettext requires the locales you want to use to be installed on your system. For example, to have the french locale working, you must install the "fr_FR.UTF-8" locale.

If you want to do some translation works:

  • Tell us you want to do it ;

  • Export the SVN repository of the interface part you want to translate ;

  • Rebuild the template file that contains all the translation ;

  • Translate the po file with a dedicated application (kbabel, poedit ...) ;

  • Test it, and send us the translated file (.po file).

For example, you want to translate mmc-web-base into Spanish:

      $ cd /tmp
      $ svn export http://mds.mandriva.org/svn/mmc-web-base/trunk
      $ cd trunk
      $ make build_pot # Will build the translation template
      $ mkdir -p modules/base/locale/es_ES/LC_MESSAGES
      $ cp modules/base/locale/base.pot modules/base/locale/es_ES/LC_MESSAGES/base.po
      # use your favorite editor to translate modules/base/locale/es_ES/LC_MESSAGES/base.po
      $ kbabel modules/base/locale/es_ES/LC_MESSAGES/base.po
      # Compile the .mo file and copy it to your running MMC
      $ make build_mo
      $ cp -r modules/base/locale/es_ES /usr/share/mmc/modules/base/locale
      # Install the spanish es_ES.UTF-8 on your system
      # Your apache2 must be restarted to use the new .mo file
      $ /etc/init.d/apache2 restart
    

Now if you point your navigator to the MMC login page, your newly translated language should be available.