Internationalization
====================

Because Tuleap is used by a large community of users and developpers, it is internationalized. For now, available languages are:

- English
- French

Thus, there shouldn't be any words or sentences of natural language in source code.

The class that manages i18n is BaseLanguage (src/common/language/BaseLanguage.class.php). A typical use in PHP is

  .. code-block:: php

    $GLOBALS['Language']->getText('include_exit','error'));

Language is initialized by :code:`pre.php`, and language is set according to the user preferences. This php code will be replaced by a string defined in language files.

Language files are available in the :code:`site-content/` directory. For instance, the file used in this example is located at :code:`site-content/en_US/include/include.tab`. The same file exists for the french version: :code:`site-content/fr_FR/include/include.tab`.

These language files follow a defined syntax:

  .. code-block:: bash

    key1 [tab] key2 [tab] translated string

and are separated by a carriage return. Keys are split in different files for convenience, but are "compiled" in a big unique file at execution.