Translation

Enabling Language Translation on Your System

In order to properly manage translations, openDCIM utilizes the standard open source utility called Gettext.

To ensure that you have GetText installed on your system correctly, run the following command: $ echo "" | php | grep "GetText"

You want a response of: GetText Support => enabled

If not, you'll need to search your particular distribution's documentation for how to install GetText both at the system level and to enable it within PHP.

Important note! If you wish to interact with the template repository, you must install en_US.utf8 locale on your system, as all templates are in that format.

== Locales ==

A dependency of Gettext is that the locale for the language that you wish to support must be installed on your server. This is basically a mapping of the character sets so that extended characters may be displayed properly.

See what locales are currently installed on your system:

  $ locale -a
  C
  C.UTF-8
  en_AG
  en_AG.utf8
  en_AU.utf8
  en_BW.utf8
  en_CA.utf8
  en_DK.utf8
  en_GB.utf8
  en_HK.utf8
  en_IE.utf8
  en_IN
  en_IN.utf8
  en_NG
  en_NG.utf8
  en_NZ.utf8
  en_PH.utf8
  en_SG.utf8
  en_US.utf8
  en_ZA.utf8
  en_ZM
  en_ZM.utf8
  en_ZW.utf8
  POSIX

Above is the output on an Ubuntu system installed for English. You'll noticed that other than POSIX and C, only en_ prefix locales are present.

If you wish to install another locale, such as Traditional Spanish (es_ES), you would do the following:

  $ sudo locale-gen es_ES.utf8

The postfix of .utf8 is important as that is the character encoding we use for internationalization. If you simply installed the es_ES locale then some characters may not display correctly.