Языки
Язык может стать барьером для понимания. Мы хотим, чтобы Tuist был доступен как можно большему числу людей. Если вы владеете языком, который Tuist пока не поддерживает, вы можете помочь проекту заговорить на этом языке, улучшив исходные тексты на английском и контекст локализации, который использует Glossia для перевода.
Поддержка языков — это непрерывный процесс, поэтому мы добавляем новые языки, когда появляются участники, готовые помогать с их поддержкой. В настоящее время поддерживаются следующие языки:
- Английский
- Арабский
- Испанский
- Японский
- Грузинский
- Корейский
- Русский
- Кантонский
- Упрощённый китайский
- Традиционный китайский
Если вы считаете, что Tuist выиграет от поддержки нового языка, создайте новую тему на форуме сообщества, чтобы обсудить это с сообществом.
Как помочь#
Поддержка языков в Tuist управляется через репозиторий. Участники обновляют исходные тексты на английском и контекст перевода, а Glossia автоматически генерирует локализованные файлы.
Рабочий процесс:
- Обновите исходное содержимое на английском.
- Обновите соответствующий контекст
L10N.md, если переводчикам нужны дополнительные указания. - Откройте pull request с этими изменениями в исходных текстах.
- После того как изменения попадут в ветку
main, Glossia переведёт изменённые части и оставит открытым pull request с обновлёнными локализованными файлами.
Не редактируйте сгенерированное локализованное содержимое напрямую. Вместо этого обновите исходные тексты на английском и языковой контекст.
Структура L10N.md#
Файлы L10N.md определяют контекст, который Glossia использует при переводе. Проще всего рассматривать их как инструкции по языку с определённой областью действия, которые могут находиться на разных уровнях каталогов.
Например:
.
|-- L10N.md
|-- server
| |-- L10N.md
| |-- L10N
| | `-- es.md
| `-- priv
| `-- gettext
| `-- marketing.pot
Контекст каталога#
Glossia проходит от корня репозитория до переводимого каталога и объединяет все найденные на этом пути файлы L10N.md.
В приведённом выше примере:
L10N.mdприменяется глобально.server/L10N.mdдобавляет контекст, специфичный для сервера.server/L10N/es.mdдобавляет переопределения только для испанского языка в той же области.
Это значит, что вы можете размещать контекст там, где он уместен:
- общие рекомендации для всего репозитория в корне
- рекомендации для конкретной области в подкаталоге
- рекомендации для конкретного языка в
L10N/<locale>.md