Configuration

Open config.xml to change configuration. There, check out the module multilanguage. The parameter lang.enabled must be set to 'true' to enable this module. If enabled, the parameter lang.default must contain a default language (or the corresponding language abbreviation). An unlimited number of additional languages can be added to lang.alt; These languages must be separated by a semicolon. The following example configures the languages German (default), English and French (alternatives):

<module key="multilanguage">
  <param key="lang.enabled"/>true
  <param key="lang.default"/>de
  <param key="lang.alt" description="a semicolon seperated list of alternative languages"/>en;fr
</module>

If you want to use the built-in HTML Language Switcher, you have to configure language names for each language code:

Open lang.xml and go to key="Language". The default configuration looks like this:

<word key="Language">
    <lang key="de">Deutsch</lang>
    <lang key="en">English</lang>
    <lang key="fr">Français</lang>
</word>

Usage

If you want to use the built-in navigation bar, you have to open navigation.xml and configure one label for each language.

The following example applies to German as the default language and English as the alternative language:

<submenu label="Projektbeschreibung" label-en="project description">

To display individual words, such as headings, in different languages use div or span elements, set the parameter data-template="lang:translate" and choose a new data-template-content parameter. Example:

<span data-template="lang:translate" data-template-content="Search"/>

This data-template-content parameter must be unique and added to file lang.xml. The following example shows the translations for the word "Search" in German, English and French:

<word key="Search">
  <lang key="de">Suche</lang>
  <lang key="en">Search</lang>
  <lang key="fr">Recherche</lang>
</word>