Enabling Translations: Difference between revisions

From IHRIS Wiki
No edit summary
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This article describes how to enable any existing translations of the iHRIS software on your site. 
Several languages are bundled with each iHRIS release.  In addition, you can create your own translations.  You may wish to see [[Creating Translations]] for some more technical information about adding translations to iHRIS.
==Main Languages==
==Main Languages==
As of version 4.0.6 translations for French, Swahili, Portuguese, and Italian are automatically available to the system.  These are called locales..
As of version 4.0.18 of iHRIS Manage and iHRIS Qualify, translations for Dutch, Estonian, French, Malian French, German, Italian, Portuguese, Brazilian Portuguese, Spanish, Swahili, and Tagalog are automatically available to the system. iHRIS handles translations of the software through the concept of "Locales," which mark the text that needs to be translated.
 
A '''locale''' is a pair of terms that identifies the language and country relevant to the translation. For instance, Portuguese translation for Portugal will differ from translation for Brazil. Example locales are:
*French: fr_FR
*Italian:  it_IT
*Portuguese: pt_PT
*Portuguese (Brazilian): pt_BR  
*Spanish: es_ES
*Swahili: sw_TZ
 
==Updating And Adding New Translations==
The actual translation is then handled by Launchpad, the site that hosts the iHRIS software. Volunteer translators can then go to Launchpad, click on a translations tab, and see what needs to be translated.


A '''locale''' is a language and country/location.  The main locales are:
*[[I2CE Translation List (Development) | I2CE Translation List ]]
*French fr_FR
*[[iHRIS Common Translation List (Development) | iHRIS Common Translation List ]]
*Italian it_IT
*[[iHRIS Manage Translation List (Development) | iHRIS Manage Translation List ]]
*Portuguese pt_PT
*[[iHRIS Qualify Translation List (Development) | iHRIS Qualify Translation List ]]
*Brazilian Portuguese pt_BR
*Swahili sw


==Enabling the Locale Selector Module==
==Enabling the Locale Selector Module==
Line 17: Line 30:


==Adding A Locale==
==Adding A Locale==
*Go to "Configure System"
*Go to "Manage Locales"
*"Add" the locale you want.  For example fr_FR or it_IT
==Other Languages==
Some other languages have only been partially translated and you will need to generate the translations of .html and .xml files.
For example, in order to add the locale pt_BR (Brazilian Portuguese)  to the system, you will need to open a terminal on the server and:
cd /var/lib/iHRIS/lib/4.0/6/I2CE '''path may be different depending on your installation'''
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-common
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-manage '''if you are using iHRIS Manage'''
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-qualify '''if you are using iHRIS Qualify'''
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
[[Category:Developer Resources]]

Latest revision as of 19:45, 1 March 2019

This article describes how to enable any existing translations of the iHRIS software on your site.

Several languages are bundled with each iHRIS release. In addition, you can create your own translations. You may wish to see Creating Translations for some more technical information about adding translations to iHRIS.

Main Languages

As of version 4.0.18 of iHRIS Manage and iHRIS Qualify, translations for Dutch, Estonian, French, Malian French, German, Italian, Portuguese, Brazilian Portuguese, Spanish, Swahili, and Tagalog are automatically available to the system. iHRIS handles translations of the software through the concept of "Locales," which mark the text that needs to be translated.

A locale is a pair of terms that identifies the language and country relevant to the translation. For instance, Portuguese translation for Portugal will differ from translation for Brazil. Example locales are:

  • French: fr_FR
  • Italian: it_IT
  • Portuguese: pt_PT
  • Portuguese (Brazilian): pt_BR
  • Spanish: es_ES
  • Swahili: sw_TZ

Updating And Adding New Translations

The actual translation is then handled by Launchpad, the site that hosts the iHRIS software. Volunteer translators can then go to Launchpad, click on a translations tab, and see what needs to be translated.

Enabling the Locale Selector Module

  • Go to "Configure System"
  • Go to "Configure Modules"
  • Scroll down to "Pages" and click the "Sub-Modules" link
  • Check the checkbox next to "Locale Selector"
  • Scroll to the bottom of the screen and click the "Enable" button

Adding A Locale

  • Go to "Configure System"
  • Go to "Manage Locales"
  • "Add" the locale you want. For example fr_FR or it_IT

Other Languages

Some other languages have only been partially translated and you will need to generate the translations of .html and .xml files. For example, in order to add the locale pt_BR (Brazilian Portuguese) to the system, you will need to open a terminal on the server and:

cd /var/lib/iHRIS/lib/4.0/6/I2CE path may be different depending on your installation
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-common
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-manage if you are using iHRIS Manage
php ../I2CE/tools/translate_templates.php  --locales=pt_BR
cd ../ihris-qualify if you are using iHRIS Qualify
php ../I2CE/tools/translate_templates.php  --locales=pt_BR