Skip to content

Select One or More Languages

quincywiele edited this page Feb 3, 2020 · 1 revision

Administrators can configure the available languages in settings > languages:

"Default language" means: it can't be deleted. It is used as the reference language for certain maintenance operations. So if there is a mismatch in the data, the default language will be the one used as reference. Ie, when adding a new language, if the database already has existing information, a copy of the existing information needs to be added to that new language as fallback content. The default language will be used as reference for that copy.

There are different levels of support depending on the language:

  • UI level: in principle all languages are supported and the UI can be translated including RTL languages.
  • Search Engine: please refer to ElasticSearch's Language Analytizers page. We support all the languages supported by default. Also please note that there are a few more supported via plug-ins.
  • Database level: all languages supported by MongoDB.

If your language is not in the list, please get in touch with us.

Refer to the "Translate your collection" section of this Wiki to get more information.

Some notes on the Uwazi's internationalization model

When a user uploads a document or creates an entity, a copy of this information will be added to the other available languages. In order to have that piece of information translated, users must switch languages and update the information in the other languages. If the translation is not provided, the information will be displayed in the language it was uploaded regardless of the language the user is working on.

Example. Imagine we have an Uwazi instance with two languages, Arabic and English. While working in Arabic, an administrator uploads a document written in Arabic. An exact copy of this document will appear when switching to English. Admins need to edit this information and provide the English version, if available. If not, this acts as a "fallback" so users navigating in English will see that document in Arabic. Now if the admin uploads a document in English while working in English, a copy of the document (in English) will appear in the Arabic version of the site.

Some metadata is automatically synced across languages: thesauri based properties (select and multi-select), relationships, date based properties, geolocation and numeric. These properties can be automatically translated, so they just get synced when edited.

Table of contents is also synced as long as we are using the same source document (since it depends on the contents of the documents). So if an admin uploaded a document in English and got copied to the Arabic version, and we never uploaded the Arabic document, creating table of contents entries will also create them in the Arabic version since its the same text (yes, in English). The moment we upload the Arabic document, the table of contents won't be synced anymore.

Text references, media and text fields (text and rich text), are not synced across languages on edition. But they are synced along with the rest of properties on creation: when initially uploading a document or creating an entity, all the metadata added before hitting save for the first time will be copied to the other languages. Further editions won't update the not synchronizable fields.

Clone this wiki locally