.. meta::
    :description: Infrastructure Translation

.. _translation:

Translation
===========

Translation (or multi-language support) explains how the system deals with languages other than English.

The first thing to understand is that when Dragonfly is involved in displaying anything,
then it translates the strings in the current language before displaying them. Otherwise if
you ask Qt to display something, then you need to translate the string yourself before displaying it.

Translating Strings
-------------------

To translate strings one must use the services supplied by Qt. Any object deriving from
QObject understands the *tr* method (see the Qt documentation), so when needing a translation
if you don't have any Qt object handy you can just instantiate one.


Language Files
--------------

Dragonfly comes with one language file per supported language, they reside in the *Language*
folder of our installation folder.

Modifying Language Files
------------------------

ORS controls the contents of the language files, so if you need to add translations or
modify existing translations you should not modify the language files, instead you need
to change the *overrides.xml* file found in the *Language* folder.