Skip to content

Latest commit

 

History

History
185 lines (137 loc) · 6.41 KB

translating.rst

File metadata and controls

185 lines (137 loc) · 6.41 KB

Translating using Weblate

Once you navigate to a translation, you will be shown set of links which lead to translation. These are results of various checks, like untranslated or fuzzy strings. Should no other checks fire, there will be still link to all translations. Alternatively you can use search field to find translation you need to fix.

image

Suggestions

As an anonymous user, you have no other choice than making a suggestion. However if you are logged in you can still decide to make only a suggestion instead of saving translation, for example in case you are unsure about the translation and you want somebody else to review it.

Note

Permissions might vary depending on your setup, what is described is default Weblate behaviour.

Translating

On translate page, you are shown source string and edit area for translating. Should the translation be plural, multiple source strings and edit areas are shown, each described with label for plural form.

Any special whitespace chars are underlined in red and indicated with grey symbols. Also more than one space is underlined in red to allow translator to keep formatting.

There are various extra information which can be shown on this page. Most of them are coming from the project source code (like context, comments or where the message is being used). When you configure secondary languages in your preferences, translation to these languages will be shown.

Bellow translation can be also shown suggestions from other users, which you can accept or delete.

Plurals

What are plurals? Generally spoken plurals are words which take into account numeric meanings. But as you may imagine each language has it's own definition of plurals. English, for example, supports one plural. We have a singular definition, for example "car", which means implicit one car, and we have the plural definition, "cars" which could mean more than one car but also zero cars. Other languages like Czech or Arabic have more plurals and also the rules for plurals are different.

Weblate does have support for translating these and offers you one field to translate every plural separately. The number of fields and how it is used in the translated application depends on plural equation which is different for every language. Weblate shows the basic information, but you can find more detailed description in the Language Plural Rules from the Unicode Consortium.

image

Keyboard shortcuts

While translating you can use following keyboard shortcuts:

Alt+Home

Navigates to first translation in current search.

Alt+End

Navigates to last translation in current search.

Alt+PageUp

Navigates to previous translation in current search.

Alt+PageDown

Navigates to next translation in current search.

Alt+Enter or Ctrl+Enter

Saves current translation.

Translation context

Translation context part allows you to see related information about current string.

Nearby messages

Displays messages which are located nearby in translation file. These usually are also used in similar context and you might want to check them to keep translation consistent.

Similar messages

Messages which are similar to currently one, which again can help you to stay consistent within translation.

All locations

In case message appears in multiple places (eg. multiple components), this tab shows all of them and for inconsistent translations (see check-inconsistent) you can choose which one to use.

Glossary

Displays words from project glossary which are used in current message.

Recent edits

List of people who have changed this message recently using Weblate.

Project

Project information like instructions for translators or information about VCS repository.

If translation format supports it, you can also follow links to source code which contains translated strings.

Translation history

Every change is by default (unless disabled in component settings) saved in the database and can be reverted. Of course you can still also revert anything in underlaying version control system.

Export and import

Weblate supports both export and import of translation files. This allows you to work offline and then merge changes back. Your changes will be merged within existing translation (even if it has been changed meanwhile).

Note

This ability might be limited by privileges.

Import method

You can choose how imported strings will be merged out of following options:

Add as translation

Imported translations are added as translation. This is most usual and default behavior.

Add as a suggestion

Imported translations are added as suggestions, do this when you want to review imported strings.

Add as fuzzy translation

Imported translations are added as fuzzy translations. This can be useful for review as well.

Additionally, when adding as a translation, you can choose whether to overwrite already translated strings or not.

image

Glossary

Each project can have assigned glossary for any language. This could be used for storing terminology for given project, so that translations are consistent. You can display terms from currently translated string in bottom tabs.

Managing glossaries

On project page, on Glossaries tab, you can find link Manage all glossaries, where you can start new glossaries or edit existing ones. Once glossary is existing, it will also show up on this tab.

image

On further page, you can choose which glossary to manage (all languages used in current project are shown). Following this language link will lead you to page, which can be used to edit, import or export the glossary:

image

Machine translation

Based on configuration and your language, Weblate provides buttons for following machine translation tools.

All machine translations are available on single tab on translation page.

machine-translation-setup