debian-mirror-gitlab/doc/development/i18n/translation.md

110 lines
4.5 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
stage: Manage
group: Import
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2018-03-17 18:26:18 +05:30
# Translating GitLab
2022-01-26 12:08:38 +05:30
For managing the translation process, we use [Crowdin](https://crowdin.com).
2021-09-04 01:27:46 +05:30
To contribute translations at [`translate.gitlab.com`](https://translate.gitlab.com),
2022-01-26 12:08:38 +05:30
you must create a Crowdin account. You may create a new account or use any of their supported
2021-09-04 01:27:46 +05:30
sign-in services.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
## Language selections
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
GitLab is being translated into many languages. To select a language to contribute to:
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
1. Find the language that you want to contribute to, in the
2022-01-26 12:08:38 +05:30
[GitLab Crowdin project](https://crowdin.com/project/gitlab-ee).
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
- If the language you want is available, proceed to the next step.
- If the language you want is not available,
[open an issue](https://gitlab.com/gitlab-org/gitlab/-/issues?scope=all&utf8=✓&state=all&label_name[]=Category%3AInternationalization).
2022-01-26 12:08:38 +05:30
Notify our Crowdin administrators by including `@gitlab-org/manage/import` in your issue.
2021-09-04 01:27:46 +05:30
- After the issue and any merge requests are complete, restart this procedure.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
1. View the list of files and folders. Select `gitlab.pot` to open the translation editor.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
### Translation editor
2018-03-17 18:26:18 +05:30
The online translation editor is the easiest way to contribute translations.
2022-01-26 12:08:38 +05:30
![Crowdin Editor](img/crowdin-editor.png)
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
- Strings for translation are listed in the left panel.
- Translations are entered into the central panel. Multiple translations are required for strings
that contain plurals. The string to translate is shown in the above image with glossary terms
highlighted. If the string to translate isn't clear, you can request context.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
A glossary of common terms is available in the **Terms** tab in the right panel. In the **Comments**
tab, you can add comments to discuss a translation with the community.
2018-03-17 18:26:18 +05:30
Remember to **Save** each translation.
2018-03-27 19:54:05 +05:30
## General Translation Guidelines
2018-03-17 18:26:18 +05:30
Be sure to check the following guidelines before you translate any strings.
2018-03-27 19:54:05 +05:30
### Namespaced strings
2021-12-11 22:18:48 +05:30
A namespace precedes the string and is separated from it by a `|` (`namespace|string`). When you see
a namespace before an externalized string, you should remove the namespace from the final
translation. For example, in `OpenedNDaysAgo|Opened`, remove `OpenedNDaysAgo|`. If translating to
French, translate `OpenedNDaysAgo|Opened` to `Ouvert•e`, not `OpenedNDaysAgo|Ouvert•e`.
2018-03-27 19:54:05 +05:30
2018-03-17 18:26:18 +05:30
### Technical terms
2021-09-04 01:27:46 +05:30
You should treat some technical terms like proper nouns and not translate them. Technical terms that
should always be in English are noted in the glossary when using
[`translate.gitlab.com`](https://translate.gitlab.com).
This helps maintain a logical connection and consistency between tools (for example, a Git client)
and GitLab.
2018-03-17 18:26:18 +05:30
2021-12-11 22:18:48 +05:30
To find the list of technical terms:
1. Go to [`translate.gitlab.com`](https://translate.gitlab.com).
1. Select the language to translate.
1. Select **Glossary**.
2018-03-17 18:26:18 +05:30
### Formality
2020-06-23 00:09:42 +05:30
The level of formality used in software varies by language:
| Language | Formality | Example |
| -------- | --------- | ------- |
2021-09-04 01:27:46 +05:30
| French | formal | `vous` for `you` |
| German | informal | `du` for `you` |
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Refer to other translated strings and notes in the glossary to assist you in determining a suitable
level of formality.
2018-03-17 18:26:18 +05:30
### Inclusive language
2021-09-04 01:27:46 +05:30
[Diversity, inclusion, and belonging](https://about.gitlab.com/handbook/values/#diversity-inclusion)
are GitLab values. We ask you to avoid translations that exclude people based on their gender or
ethnicity. In languages that distinguish between a male and female form, use both or choose a
neutral formulation.
2018-03-17 18:26:18 +05:30
2020-06-23 00:09:42 +05:30
<!-- vale gitlab.Spelling = NO -->
2021-10-27 15:23:28 +05:30
2021-09-04 01:27:46 +05:30
For example, in German, the word _user_ can be translated into _Benutzer_ (male) or _Benutzerin_
(female). Therefore, _create a new user_ translates to _Benutzer(in) anlegen_.
2021-10-27 15:23:28 +05:30
2020-06-23 00:09:42 +05:30
<!-- vale gitlab.Spelling = YES -->
2018-03-17 18:26:18 +05:30
### Updating the glossary
2021-09-04 01:27:46 +05:30
To propose additions to the glossary, please
2020-06-23 00:09:42 +05:30
[open an issue](https://gitlab.com/gitlab-org/gitlab/-/issues?scope=all&utf8=✓&state=all&label_name[]=Category%3AInternationalization).
2018-03-27 19:54:05 +05:30
2021-09-04 01:27:46 +05:30
## French translation guidelines
2018-03-27 19:54:05 +05:30
2020-06-23 00:09:42 +05:30
<!-- vale gitlab.Spelling = NO -->
2021-10-27 15:23:28 +05:30
2021-09-04 01:27:46 +05:30
In French, the _écriture inclusive_ is now over (see on [Legifrance](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000036068906/)).
To include both genders, write _Utilisateurs et utilisatrices_ instead of _Utilisateur·rice·s_. If
there is not enough space, use the male gender alone.
2021-10-27 15:23:28 +05:30
2020-06-23 00:09:42 +05:30
<!-- vale gitlab.Spelling = YES -->