Skip to main content

Using Custom Language Files

In case you want to edit tool tips for existing languages or add support for additional languages you can edit or create language files in the subdirectory /languages of your FSI Viewer setup directory.

Each language file contains a list of phrases used in FSI Viewer user interface.The language files are XML files and need to be saved in UTF-8 format. The attribute id specifies the context of each phrase. Please note that you need to use XML entities for characters not allowed in XML files, like e.g.

XML entityused for
& &
&lt; <
&gt;>
&quot;"
&apos;,

You can use basic HTML-tags to apply text formatting to the tool tips.

Excerpt from a language file:
<Data language="english" color="000000" font="_sans" offsetTop="0" offsetLeft="0" offsetWidth="0" offsetHeight="0">
<tip id="ZoomOut">
<b>Zoom Out</b>
<br/>Click to decrease magnification
</tip>
<tip id="ZoomIn">
<b>Zoom In</b>
<br/> Click to increase magnification
</tip>
<tip id="Downloading Data">Downloading:</tip>
</Data>

You can duplicate existing language files or create new files as needed.

To use custom language files, please use the language parameter and set the parameter value to the filename without the .xml extension.

It is also possible to map the available language files to the language of the browser (the file mapping.json in the \languages folder of your FSI Viewer installation can be adapted to your liking for that). In order to use the mapping defined in the JSON file, the parameter language needs to be set to auto.