iredadmin-ose / docs / HOWTO.i18n

i18n support HOWTO
==================

*) Install necessary packages before we go further:
    - Debian/Ubuntu:
        # apt-get install python-babel gettext
    - RHEL/CentOS:
        # easy_install Babel

*) Extract strings from templates:

    # cd /path/to/iredadmin-x.y.z/i18n/
    # bash translation.sh extract

*) Translate '/path/to/iredadmin-x.y.z/i18n/iredadmin.po'.

*) Convert po file to mo format:

    # cd /path/to/iredadmin-x.y.z/i18n/
    # python msgfmt.py iredadmin.po

   You will get 'iredadmin.mo' under current directory.

*) Create directory under 'i18n/' and copy 'iredadmin.mo' greneated
   above into it. e.g. for French language(fr_FR):

    # cd /path/to/iredadmin-x.y.z/i18n/
    # mkdir -p fr_FR/LC_MESSAGES/
    # cp iredadmin.mo fr_FR/LC_MESSAGES/

   Directory format is '{LANGUAGE}/LC_MESSAGES/'.

*) Configure iRedAdmin to use your translation in config/iredconf.py:

    LANG = 'fr_FR'      # The name of directory name created above.

*) Visit your iredadmin in web browser, it should work now.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.