# 语言 {#translate}

语言可能成为理解的障碍。我们希望尽可能让更多人能够使用 Tuist。如果你使用的语言 Tuist 尚未支持，你可以通过改进英文源内容以及 [Glossia](https://glossia.ai) 用于翻译的本地化上下文，帮助 Tuist 支持该语言。

由于语言支持是一项持续的工作，我们会在发现有贡献者愿意协助维护时添加新语言。目前支持的语言包括：

- 英语
- 阿拉伯语
- 西班牙语
- 日语
- 格鲁吉亚语
- 韩语
- 俄语
- 粤语
- 简体中文
- 繁体中文

> [!TIP]
> **请求新增语言**
>
> 如果你认为 Tuist 支持某种新语言会带来益处，请在[社区论坛中创建一个主题](https://community.tuist.io/c/general/4)，与社区成员讨论。


## 如何提供帮助 {#how-to-translate}

Tuist 的语言支持由代码仓库驱动。贡献者更新英文源内容和翻译上下文，[Glossia](https://glossia.ai) 会自动生成对应的本地化文件。

工作流程如下：

1. 更新英文源内容。
2. 如果译者需要更多指引，请更新相关的 `L10N.md` 上下文。
3. 针对这些源更改发起拉取请求。
4. 在这些更改合并到 `main` 后，Glossia 会翻译变更内容，并保持一个包含更新后的本地化文件的翻译拉取请求处于开启状态。

> [!WARNING]
> **不要修改生成的本地化内容**
>
> 请勿直接编辑生成的本地化内容。应改为更新英文源和语言上下文。


## L10N.md 结构 {#l10n-md-structure}

`L10N.md` 文件定义了 Glossia 在翻译时使用的上下文。最简单的理解方式是将其视为可在不同目录层级生效的作用域化语言说明。

例如：

```text
.
|-- L10N.md
|-- server
|   |-- L10N.md
|   |-- L10N
|   |   `-- es.md
|   `-- priv
|       `-- gettext
|           `-- marketing.pot
```


## 目录上下文 {#directory-context}

Glossia 会从仓库根目录向下遍历到待翻译的目录，并将该路径上找到的每个 `L10N.md` 文件合并起来。

在上述示例中：

- `L10N.md` 全局生效。
- `server/L10N.md` 添加服务器特定的上下文。
- `server/L10N/es.md` 为该区域添加仅适用于西班牙语的覆盖配置。

这意味着你可以将上下文放置在合适的位置：

- 在根目录提供仓库范围的指引
- 在子目录中提供特定区域的指引
- 在 `L10N/<locale>.md` 中提供特定语言的指引
