Style Guide¶
This page covers conventions concerning the translations.
Note
We expect our readers to use the English version of Blender, not a translated one.
The translations are licensed under the same License as the original.
Should I Translate... ?¶
Maybe¶
- Hyperlinks
May be translated, but only as an addition, not as a replacement. Keep the original link text and add the translation alongside. See also Adding Text.
- Technical Terms
Translate only if the localized expression is commonly used and well understood. Otherwise, keep the English term. See also Technical Terms.
- Unclear Text
If you are not sure you understood the meaning, mark the text as fuzzy and/or add a translator comment. Another translator may be able to clarify it.
- UI Elements
UI elements should use the same translation as in Blender’s user interface. If the UI element has not yet been translated, keep the English term and add the translation in parentheses.
Never¶
- Images
You probably will not find the original scene if it is a screenshot of a file and it is too much load on the server (and too much work for you).
Technical Terms¶
In general, the technical terms used in computer graphics are quite new or even downright neologisms invented for the needs, so they do not always have a translation in your language. Moreover, a large part of Blender users use its English interface.
As a result, unless a term has an evident translation, you should preferably use the English one, putting it in italic. You can then find a translation for it, which you will use from times to times (e.g. to avoid repetitions…). This is also valid in the other way: even when a term has a straightforward translation, do not hesitate to use its English version from times to times, to get the reader used with it…
If a term is definitively not translatable, simply use the English one, but make sure its glossary entry is translated.
In the glossary, the English term is written first (to maintain alphabetic order) with the translated entry following in parenthesis, when appropriate.
Adding Text¶
Generally, you should always translate exactly what is in the text, and avoid providing updates or extra information.
But sometimes that is necessary, for example when talking about the manual itself: To a foreign reader it is not clear, that they can contribute English text only, whereas this is obvious to an English reader.
In these (rare) cases you can and should provide extra information.
Keeping Pages Up To Date¶
When the manual is updated, those translations which are outdated will be marked as fuzzy. To keep track with that, you can use a tool we created for that task, see How to install it.