接入 Crowdin
Crowdin 是一个专业的本地化内容管理平台，不少商业项目使用该网站翻译并管理其本地化资源。同时，该网站也为开源项目和教学项目提供了免费或优惠的许可证。当你的项目中需要翻译的字符串较多，或需要支持很多种不同的语言，那么使用专业的管理平台会十分方便。
同时，Crowdin 也不仅仅是 CAT (计算机辅助翻译)，也提供了内容管理的功能，以及多种与第三方工具集成的方案，包括与 GitHub 等代码托管平台集成。由于 Crowdin 提供了 CLI 和 API 等多种方式管理项目资源，你也可以使用 CI (Continuous Integration，持续集成) 等方式管理你的项目资源。
TIP
除了 Crowdin，还有很多其他平台也提供类似的功能，有一些甚至是完全免费的，如：
你也可以尝试搜索 Translation Management System 或 Localization Platform 等关键词，整个互联网上有无数的本地化管理平台等着你去发掘。
注册及登录 Crowdin
你可以使用邮箱注册，也可以用谷歌账号、Github 账号等第三方登录，与其他网站异曲同工，因此此处不再赘述。
创建本地化项目
成功注册并登录 Crowdin 后，你会被自动导向你的个人页面。点击右上角的加号，即可创建项目。
TIP
若你的项目是开放源代码的，并且活跃了 4 个月及以上，你可以申请 Crowdin 的开源项目许可。当你成功创建项目后，填写这个表单，Crowdin 的客服人员会帮助你。
在新建项目界面，需要填写项目名称 (推荐和插件或机器人的名称一致)，选择是否公开项目，设置源语言和目标语言，然后点击创建项目按钮。
TIP
公开项目意味着所有 Crowdin 用户都能搜索到你的项目，也可以看到你的项目的所有内容，也可以向项目贡献翻译。如果你是通过开源项目免费许可的方式创建的项目，则只能创建公开项目。
项目结构
项目中的文件结构由项目性质决定。通常我们需要将不同语言的翻译内容分别存储为不同的文件，并放置在同一个目录下 (如 locales)，以便于管理。
Crowdin 支持多种文件格式，这里以 YAML (.yml) 为例分别说明不同项目下的文件结构。
单插件项目
单插件项目的翻译文件通常存储在插件的根目录下的 src/locales 目录中，如：
src/
locales/
en-US.yml
zh-CN.yml
...
package.json这里有一个示例项目可以参考。
多插件项目
多插件项目通常是 monorepo 结构，即根目录作为开发工作区，每个插件作为一个子项目放置在其他目录下。这种情况下，与单插件项目类似，翻译文件通常存储在插件的根目录下的 src/locales 目录中，如：
packages/
plugin-a/
src/
locales/
en-US.yml
zh-CN.yml
...
plugin-b/
src/
locales/
en-US.yml
zh-CN.yml
...这里有一个示例项目可以参考。
机器人项目 / 整合包项目
机器人项目是多插件项目的一种特殊形式。除了有多个插件的翻译文件外，还有机器人本身的翻译文件，通常放置在根目录下的 locales 目录中，如：
locales/
en-US.yml
zh-CN.yml
...
packages/
plugin-a/
src/
locales/
en-US.yml
zh-CN.yml
...
plugin-b/
src/
locales/
en-US.yml
zh-CN.yml
...文档项目 (Vitepress)
由于文档通常需要对每个页面和大量配置文件进行翻译，我们通常将每个页面的主要内容放置在不同的目录下，并将配置文件本身进行拆分，如：
.vitepress/
config/
index.ts
en-US.json
zh-CN.json
...
en-US/
index.md
zh-CN/
index.md
package.json这里有一个示例项目可以参考。·
上传项目文件
你可以通过网页手动上传文件，也可以通过 Crowdin 的 CLI 程序进行上传，或是使用集成让 Crowdin 直接从代码仓库同步文件。
手动上传
导航至 Crowdin 的内容 (Content) 界面，你可以点击上传文件 (Upload Files) 按钮上传源语言文件。
设置代码仓库集成
除了手动上传，你还可以设置集成，让 Crowdin 自动同步 GitHub 等仓库里的文件，并可设置定期推送译文到相应的分支。
你可以点击这里直达 Crowdin 关于 GitHub 集成的文档，跟随文档配置好集成后即可让 Crowdin 自动同步 GitHub 上的内容。如果你使用的是 Gitlab 等其他仓库，也可以在这里找到相应的指南。
设置完成后，Crowdin 并不会立刻同步，需要手动触发：点击 Sync Now，等待进度条走完即可。以后 Crowdin 会定时检查并自动同步。
通过 CLI 上传文件
Crowdin 还提供了一个 CLI 工具，可以通过命令行管理本地和远程的本地化资源文件。你可以通过 npm 或 yarn 安装。
$ npm i -g @crowdin/cli
$ yarn global add @crowdin/cliCrowdin 也提供了 Homebrew / apt 等多种安装方式，对于 Windows 用户，你也可以直接下载 Crowdin 所提供的安装程序安装，请查看 Crowdin 的文档获知更多详情。
在运行 Crowdin 的 CLI 工具之前，你需要确保当前项目的根目录下存在名为 crowdin.yml 的配置文件，你可以运行 crowdin init 创建一个基础配置文件，修改其中的条目以适应你的项目。详细的介绍可以看 Crowdin 的文档。
你也可以参考上方提到的示例项目中的 crowdin.yml 文件。
TIP
crowdin.yml 中的配置项不仅适用于 Crowdin CLI，还可以在上述的代码仓库集成中发挥作用，Crowdin 会自动读取该文件以确定翻译的范围。
推荐在项目目录下的 crowdin.yml 文件中配置好文件筛选器，并且在 $HOME/.crowdin.yml 文件中存储你的 Crowdin 密钥等敏感信息，然后你就可以简单地运行 crowdin upload sources 上传源文件，而不需要每次都打出冗长的包含通配符的文件路径了。
文件类型
Crowdin 支持许多常见文件类型，如 HTML、docx、pdf，本地化软件框架支持的 xliff 与 po 等自然也不在话下，如果你不确定你的文件类型是否受支持，你可以在这里查看 Crowdin 支持的文件类型列表。
作为示例，我们使用的是 YAML 格式的文档，Crowdin 目前仅支持纯文本的 YAML 格式的文档，不支持 anchor 等高级功能。
当然你也可以使用 JSON 格式，但传统的 JSON 无法添加注释，显示在 Crowdin 上则会缺少足够的上下文信息。因为译者在 Crowdin 上无法看到源码，也无法看到翻译后的结果的显示样式，作为开发者应当通过各种方式向译者提供详尽的上下文信息。再综合考虑 koishi 对 i18n 的处理方式与 Crowdin 支持的格式，采用 YAML 是较为经济的选择。
Crowdin 会读取 YAML 中的键值和注释作为该待翻译字符串的上下文。以下面的 YAML 为例：
commands:
ping:
description: 回复 ping 信息
options:
# 这是一段注释
detail: 显示网络连接情况
messages:
pong: PONG! # 注释也可以写在后方那么在翻译界面，Crowdin 会为 回复 ping 信息 这一字符串添加 commands.ping.description 作为其上下文信息。而对于 显示网络连接情况 这一字符串，除了显示 commands.ping.options.detail 以外，还会显示 这是一段注释 作为其上下文信息。当然，除了写在键值的上方，你也可以写在键值后方，效果是一样的。
commands:
dress:
message:
dress: '{name}今天穿了{color}色的裙子'与大部分 CAT 工具一样，Crowdin 同样会标识出诸如 {name} 这样的插值语法，并且在译文缺少插值或译者翻译插值变量时报告错误。
进行翻译
当你成功添加源文件之后，就可以着手进行翻译了。点开想要翻译的语言，打开对应文件，就可以进入 Crowdin 的在线翻译编辑器。假设你是从个人电脑打开的，那么视图会从左到右分成三个部分，左边是待翻译的字符串，中间是翻译区，右边是评论和参考区。
如果你对该项目申请了开源项目免费许可，那么该项目还会启用 Global TM 功能。这是 Crowdin 的共享翻译语料库，可以根据其他人的项目中存在的类似文本对当前的待翻译字符串进行提示，你的项目的字符串及翻译结果也会上传到这个语料库中。
下载翻译
与上传翻译一样，Crowdin 提供了多种方式可以下载翻译结果，你可以直接通过网页下载单个或多个文件，也可以通过 Crowdin CLI 下载。如果你设置了代码仓库的集成，并勾选了定时同步，则 Crowdin 会定时自动推送翻译结果到指定的分支。