User Tools

Site Tools

This documentation is no longer maintained by the Turris team (although it can be used by the community to share content). The current official documentation is at docs.turris.cz.

This documentation applies only Turris OS 3.x that is no longer present in newly sold routers. The new documentation is located at https://docs.turris.cz/.

How to Participate in the Foris Interface Translation

We developed the Turris router interface in English and we use Czech as the reference localisation language. But if you wish, you can take part in translating the interface into any language of your choosing.

How to translate

We use the online service Weblate for the translations. Translation is done in a web form, with the help of an integrated dictionary and other users. If you take the time to translate, your translation is published in Foris the same moment that more than 85 % of all texts are translated and reviewed by us. Untranslated texts are shown in English.

Translation and publishing is automatic, but we need to add the new language to the interface as a switch. This can take some time - depending on the frequency of updates.

Let's get started

  1. First of all, register for free to the Weblate service.
  2. Choose the part of the project, which you want to translate. The interface is divided into several parts: Foris interface and various plug-ins.
  3. Choose the language you want to help with. If you want to translate into a new language choose Start new translation in tab Tools.
  4. Choose the language you are translating into. The form contains a majority of current and dead languages, you will be able to choose one.
  5. The list of translations now contains the language which you have added. Click on the button on the right, which says Translation and start translating the strings that aren't translated yet.
  6. When the percentage on the Language screen exceeds 85, we proofread the translation and publish it. If you want to speak to us about the translations, you can use this forum to do it .
  7. If a phrase is not translated, the English expression will be used.

These parts of Foris can be translated by you.

Obrazovka Překlady Languages for translation.

Description of the translation interface

Weblate is a very intuitive service and don't need any special skills to use it. The basic interface is the translation screen, where you can see source text and the translation itself.

Obrazovka překladu Picture 3: Screen for translation of expressions and terms

Choice Nearby messages displays other strings with a similar sentence. You can use it for your own translation. This option can help you in case you want to investigate what is the usual approach to the translation (using a polite/familiar form, infinitives, familiar tone etc).

Choice Machine translation suggest translations with automatic translators. You can copy it to the source window and work with it, the copy it and save (in this case another expression is proposed to you for translation).

What is the difference between “Save” and “Suggest”? If you click “Save”, you are sure that the translation is correct. “Suggestion” means you want us to proof-read your translation. Weblate tracks the number of suggestions and finally saved words.

Zen regime - You can switch to this mode by clicking the button in the upper right corner of the screen. The bulk translation is useful for shorter expressions which are very useful when translating Foris interface. Every translation is used in real time and replaced in other parts of texts. Edit icon will let you Translate in a usual way.

Other options of Weblate (with the exception of History) are not vital to know when translating Foris interface.

Please pay attention when translating

Be polite and consistent. What does that mean? For example, decide at the beginning if you use the formal or familiar form (if this applies to your language). We use infinitive or imperative forms for the buttons. The imperative form seems clear and simple to us, please don't consider it a sign of being too directive. Try to use the communication tone which is usual for computer interfaces. Be concise and do not translate one term differently in different places.

Which sections can be translated

We would love your help with these sections:

  • Foris – main language interface for web administration of Turris
  • Foris: Diagnostics plugin
  • Foris: OpenVPN plugin – plugin for simpler setting of the OpenVPN server
  • Foris: TLS plugin – plugin for generating QR codes for mobile access etc.
  • Foris: tzinfo - geographical names translation for time zones

Community of translators

We are very thankful to everybody who contributes to the translation. For communication about translation use this forum.