工作原理

TownSquare Labs 本地化系统由几个关键部分组成。本章将概述该程序的运行方式，帮助您了解其工作原理以及如何有效地使用它。

在这个系统中，我们整合了多个应用程序，使其作为一个统一的整体无缝运行：

GitHub：托管文档，同步上游版本库中的文档，并将翻译同步到特定分支。
Crowdin：管理翻译流程，包括翻译、校对和设置语言首选项。
人工智能系统：利用先进的人工智能协助翻译员，确保工作流程顺畅。
自定义词汇表：为翻译员提供指导，同时确保人工智能根据项目上下文生成准确的译文。此外用户还可根据需要上传自己的词汇表。

信息

本指南不会详细介绍整个流程，但会重点介绍使 TownSquare Labs 本地化系统独一无二的关键组成部分。您可以自行进一步了解该计划。

通过GitHub实现文档和翻译同步

我们的版本库使用多个分支来管理文件和翻译。下面将详细解释每个特殊分支的目的和功能：

分支概览

1.`dev`

dev分支运行 GitHub Actions 来处理同步任务。你可以在 .github/workflows 目录中找到工作流配置：

sync-fork.yml：此工作流程从上游版本库同步文档。每天 00:00 运行。
sync-translations.yml：此工作流程将更新的翻译同步到相应的语言分支，以便在相应的语言网站上进行预览。

2.`localization`

该分支通过在 dev 分支上运行的 GitHub Actions 与上游版本库保持同步。它还用于更新我们打算提交到原始版本库的某些代码。

3.`l10n_localization`

该分支包含来自 localization 分支的所有修改和来自 Crowdin 的翻译。此分支中的所有修改都会提交到上游版本库。

4.`[lang]_localization`

这些分支指定用于特定语言的预览，如 "ko_localization "用于韩语，"ja_localization "用于日语。通过它们，我们可以预览不同语言的网站。

通过维护这些分支和使用 GitHub Actions，我们有效地管理了文档和翻译更新的同步，确保我们的多语言内容始终是最新的。

如何创建新的 Crowdin 项目

登录您的 Crowdin 帐户。
点击菜单中的 Create new project。
设置项目名称和目标语言。您可以稍后在设置中更改语言。
转到刚刚创建的项目，选择Integrations，点击 Add Integration 按钮，搜索 GitHub，然后安装。
在 Crowdin 上配置 GitHub 集成之前，请先指定要上传到 Crowdin 的文件，以免上传不必要的文件：
1. 在你的 GitHub 仓库的根目录下创建一个crowdin.yml文件，输入以下基本配置：
```
project_id: <Your project id>
preserve_hierarchy: 1
files:
  - source: <Path of your original files>
    translation: <Path of your translated files>
```
1. 获取正确的配置值：
  - project_id：在您的 Crowdin 项目中，转到 Tools 选项卡，选择 API，并在其中找到project_id。
  - preserve_hierarchy：是否在 Crowdin 服务器上保持 GitHub 中的目录结构。
  - source and translation：指定要上传到 Crowdin 的源文件路径(source)和翻译文件(translation)的输出路径。
    
    请参阅我们的官方配置文件了解示例。
    更多详情，请参阅Crowdin 配置文件。
配置 Crowdin 以连接到你的 GitHub 仓库：
1. 单击 Add Repository 并选择 Source and translation files mode。
2. 连接 GitHub 账户并搜索要翻译的 repo。
3. 选择左侧的分支，这将生成一个新的分支，Crowdin 将在该分支中发布翻译。
4. 选择将翻译更新到 GitHub 分支的频率。其他配置可保留默认设置，然后点击保存启用集成。