Localization

Monex is designed to ensure easy translation into different languages.

Dictionary

The dictionary is a set of files with text presenting each visible element in the user interface.
The dictionary is currently presented by the following group of files found in the Monex\Splosno path:

monex.xml - main Slovene translation of Monex
monex.ENG.xml - main English translation of Monex
monex.GER.xml - main German translation of Monex
analizator.xml - main Slovene translation of Analizator
analizator.ENG.xml - main English translation of Analizator
skupno.xml - expressions used by Monex and Analizator
skupno.ENG.xml - English translation of skupno.xml
skupno.GER.xml - German translation of skupno.xml

DTD definition and XSD schema of XML document can be found on the Dokumentacija\DTD path.

Structure

Dictionary is a set of sentences (sentence = "stavek"), which hold the text in different languages.

Description of dictionary XML file structure:

Element/Attribute Description

<slovar> root XML element. Holds one or many <stavek> "sentence" elements.

<stavek> holds one or many <vsebina> "content" elements in different languages.

  attribute: id Unique key of sentence.

<vsebina> Holds text (content).

  attribute: jezik Sets the langugage
In case this attribute is not given the text is considered default and will be used if no appropriate languge can be found.

If needed an external dictionary file can also be included:

<vkljuci> includes an external dictionary file.

  attribute: datoteka Relative or absolute path to external dictionary file.

Element/Attribute	Description
<slovar>	root XML element. Holds one or many <stavek> "sentence" elements.
<stavek>	holds one or many <vsebina> "content" elements in different languages.
attribute: id	Unique key of sentence.
<vsebina>	Holds text (content).
attribute: jezik	Sets the langugage In case this attribute is not given the text is considered default and will be used if no appropriate languge can be found.

Example of a simple dictionary

<slovar>
  <vkljuci datoteka="Zunanji.xml" />
  <stavek id="Pozdrav">
    <vsebina jezik="SLO">Pozdravljen svet!<vsebina>
    <vsebina jezik="ANG">Hello world!<vsebina>
  <stavek>
  <stavek id="Prijava">
    <vsebina jezik="SLO">Prijavi se.<vsebina>
    <vsebina jezik="ANG">Log in.<vsebina>
  <stavek>
  <stavek id="Privzet">
    <vsebina>Privzeta vrednost.<vsebina>
    <vsebina jezik="ANG">Default value.<vsebina>
  <stavek>

Special characters

For special characters like carrige returns or tabs the following can be used:

Entry Description

\\ backslash - \

\n new line

\t tab

\' double quote - "

> > - greater

< < - smaller

& &

Other codes can be found here.

Entry	Description
\\	backslash - \
\n	new line
\t	tab
\'	double quote - "
>	> - greater
<	< - smaller
&	&
Other codes can be found here.

Dictionary check

The consistency of the dictionary can be checked with a tool called SlovarChecker which can be found on the Orodja/SlovarCheck path. The tool will check a language for missing or not used expressions. Additionally it will check the usage of letter shortcuts of form elements. Definition of ignored expressions can be found at: Orodja/SlovarCheck/Checker.ignore.ini and must be copied to the location where SlovarChecker.exe resides to take effect.

Choosing a language

Currently the language can only be set manually. Change the value of "Jezik" stored in the "Globalno.ini" file, found on the installation path of Monex. If the "Globalno.ini" file is not preset run Monex and close it again. Monex will create the file in the correct format.

top

<vkljuci>	includes an external dictionary file.
attribute: datoteka	Relative or absolute path to external dictionary file.