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

58 lines
2.3 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
# Translate GitLab to your language
2021-09-04 01:27:46 +05:30
The text in the GitLab user interface is in American English by default. Each string can be
translated to other languages. As each string is translated, it's added to the languages translation
file and made available in future GitLab releases.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Contributions to translations are always needed. Many strings are not yet available for translation
because they have not been externalized. Helping externalize strings benefits all languages. Some
translations are incomplete or inconsistent. Translating strings helps complete and improve each
language.
2018-03-17 18:26:18 +05:30
There are many ways you can contribute in translating GitLab.
2021-09-04 01:27:46 +05:30
## Externalize strings
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Before a string can be translated, it must be externalized. This is the process where English
strings in the GitLab source code are wrapped in a function that retrieves the translated string for
the user's language.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
As new features are added and existing features are updated, the surrounding strings are
externalized. However, there are many parts of GitLab that still need more work to externalize all
2018-03-17 18:26:18 +05:30
strings.
See [Externalization for GitLab](externalization.md).
2021-09-04 01:27:46 +05:30
## Translate strings
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
The translation process is managed at [https://translate.gitlab.com](https://translate.gitlab.com)
2022-01-26 12:08:38 +05:30
using [Crowdin](https://crowdin.com/).
You must create a Crowdin account before you can submit translations. Once you are signed in, select
2021-09-04 01:27:46 +05:30
the language you wish to contribute translations to.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Voting for translations is also valuable, helping to confirm good translations and flag inaccurate
ones.
2018-03-17 18:26:18 +05:30
See [Translation guidelines](translation.md).
2021-09-04 01:27:46 +05:30
## Proofreading
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Proofreading helps ensure the accuracy and consistency of translations. All translations are
proofread before being accepted. If a translation requires changes, a comment explaining why
notifies you.
2018-03-27 19:54:05 +05:30
2021-09-04 01:27:46 +05:30
See [Proofreading Translations](proofreader.md) for more information on who can proofread and
instructions on becoming a proofreader yourself.
2018-03-17 18:26:18 +05:30
## Release
Translations are typically included in the next major or minor release.
2018-12-05 23:21:45 +05:30
2022-01-26 12:08:38 +05:30
See [Merging translations from Crowdin](merging_translations.md).