TDE Weblate Translation Workspace

From Trinity Desktop Project Wiki
Revision as of 11:39, 4 May 2019 by imported>SlavekB (Added a chapter about checking tests results)
Jump to navigation Jump to search

About Weblate

Weblate is an open source web-based translation management system with tight version control integration. It provides simple and clean user interface, quality checks and automatic linking to source files.

TDE Weblate

The TDE Weblate is our own instance of Weblate designed to manage TDE translations. It is tightly integrated with TDE Gitea Workspace (TGW). It provides:

  • simple and clean user interface for work on translations
  • integrated quality checks of translations
  • displaying referenced source files in TGW
  • retrieving translations and templates from TGW
  • automatic update of translations according to the templates
  • automated pushing of translations into TGW
  • proper crediting of translators in commits

Thanks to TDE Weblate you do not have to learn how to work with the GIT, you do not have to deal how to get translation files from GIT, how to merge it back to GIT, how to update translation files by templates,… You can focus to work on translations.

TDE Weblate intro.png

Integration with TGW

TDE Weblate manages its own clone of repositories, but is very tightly integrated with TGW.

Commits to TGW automatically invokes the update repository in TDE Weblate. If the translation template is updated, TDE Weblate will automatically update the translation files and immediately push them back to TGW. The translation files are therefore primarily maintained by the TDE Weblate.

During work on translations, individual translated strings are not immediately pushed into TGW. In order for translators to have enough time to work and also to check their translations, while avoiding too many small commits to TGW, pushing translations into TGW takes place after one day delay.

Work on translations is done on the master branch – on the latest development branch. In order to update the translations into a stable branch, a regular merge of the translation files between the master and the stable branch is performed.

Therefore translators do not need to work directly with GIT repositories.

Structure of translations

Each individual translation template in GIT is as an individual component in TDE Weblate. For better orientation, the components are grouped into projects – such as tdelibs, tdebase,… All applications are as components of project applications. Component names were chosen so that translators could reliably determine to which program and part the translation belong.

Using TDE Weblate

Start with registration

To work properly with TDE Weblate you need to register and log in. This will allow you to work on translations, and your work will be pushed to the TGW with your name as author.

To register, use the Register button in the upper right corner of the TDE Weblate. After registration will be sent a confirmation email to activate your account. After confirming your account activation, you will set your password. In your profile settings, you can then choose the language of the TDE Weblate interface and the languages you want to contribute to their translations.

Although TDE Weblate allows to work as an unregistered user, it's not a good idea. In such a case, it is not possible to work on translations, but only to make suggestions. But we do not have enough translators for each language to review and approve the proposals. Suggestions are not forbidden, but we recommend not using it. Instead, it is good to consider registering.

Work on translations

In order to work on translations, you must first of all be logged in. Then you select the component you want to translate. Based on the results of the checks and the status of the translation, you can choose the strings you want to deal with and start working on translations.

Component selection

There are several ways to select a component to translate:

  1. If you just want to translate, but it's not important to you what component, you can use Suggested translations on the Dashboard.
    • You get a list of ten components in your language so you can choose one.

      TDE Weblate suggested.png
       
  2. If you want to translate a specific part – such as application TDEPowersave – you choose the project and the component in this project. In this example, the applications project and the tdepowersave component.
    • If you use the Projects in the top bar, you get a component with a list of all the languages for which the component has already been translated.
    • If you use the links below in Dashboard – like applications, you get the component directly in your language.

      TDE Weblate component languages.png
       
  3. If you want to translate the string that appeared on the screen but you do not know which components this string belongs to, you can use the search.
    • In the Dashboard use Tools / Search, type the string you want to search for – for example Closing applications, select your language if it is not already selected and click on Search.

      TDE Weblate search string.png
       
    • In search results, you can then click either the component name or the specific occurrence of the string. If you use a component name, then you will be able to select the strings you want to translate. If you use a specific occurrence of a string, the editor will be opened directly for the specific occurrence of the string.

      TDE Weblate search results.png
       
    • Please use search rarely – it is currently slow and very memory intensive.

Strings selection

TDE Weblate performs many useful checks to help improve the quality of translations. After selecting a component, you have the option to choose the strings that you want to deal with. Strings selection is based on test results.

TDE Weblate component strings.png

After selecting the strings, the translating editor will be opened.

Translating with full editor

The full editor is used to gradually translate individual strings. The full editor interface provides a large amount of translated string information – translation checks results, links to string locations in the source code, nearby strings, other translations of the same string, comments, and possibly also screenshots.

TDE Weblate editor full.png

Once you edit the string, the flag that the string needs to be edited (the fuzzy flag) is automatically turned off. The keyboard icon provides information about using keyboard shortcuts that may be useful.

Translating with zen editor

The Zen editor is used to translate all selected strings within a single long page. Therefore, additional information about individual translations is limited compared to full editor.

TDE Weblate editor zen.png

Changes in translation are saved automatically when you move to the next string. Once you edit the string, the flag that the string needs to be edited (the fuzzy flag) is automatically turned off. The Edit button can be used to switch back to the full editor.

Adding a new language

After selecting a component, there may be a situation where the translation does not exist in your language. Because translation templates are part of the GIT repositories, TDE Weblate allows to create translations for new languages.

  • To start a translation for a new language:
  1. Use Projects in the top bar to select the project and then the component.
  2. On the component page use Tools / Start new translation or Start new translation button below the list of existing languages.
  3. Select your language from the list and click Start new translation button.
    A new translation will be created.

    TDE Weblate translation new.png
     

When a new translation is created, it automatically pushes a commit with translation for a new language into TGW. Similarly, translation can be removed from TDE Weblate. Again, commit will be automatically pushed to remove the translation from TGW. However, deleting translations requires administrative privileges in TDE Weblate.

Checking tests results

TDE Weblate includes several tests to check translations. Of course, these tests will not solve the grammar check or to check the translations for inaccurate or incomplete. Such checks must be done by the translator himself. TDE Weblate tests perform syntax checking. For example, whether the translation ends with a period as the original, whether the translation contains tags for C formatting as they were in the original, whether the html / xml tags in the translation text are correctly paired, and so on.

The results of checks for individual translations are displayed during the translation in the full editor. The test results can also be used to select strings to translate. If you want to focus on correcting these checks, there is a page that shows the results of checks for all of the components.

  • For check results for all components:
  1. Use Languages in the to bar to select you language
  2. On the language page use Tools / Failing checks
    Results of all failed checks for your language will be listed.

    TDE Weblate translation checks.png
     
  3. Select a check whose results you want to address.
  4. Select the project and the component whose translations you want to fix.
    An editor will be opened where you can fix the translation.