工作原理
TownSquare Labs 本地化系统由几个关键部分组成。本章将概述该程序的运行方式,帮助您了解其工作原理以及如何有效地使用它。
在这个系统中,我们整合了多个应用程序,使其作为一个统一的整体无缝运行:
- GitHub:托管文档,同步上游版本库中的文档,并将翻译同步到特定分支。
- Crowdin:管理翻译流程,包括翻译、校对和设置语言首选项。
- 人工智能系统:利用先进的人工智能协助翻译员,确保工作流程顺畅。
- 自定义词汇表:为翻译员提供指导,同时确保人工智能根据项目上下文生成准确的译文。此外用户还可根据需要上传自己的词汇表。
本指南不会详细介绍整个流程,但会重点介绍使 TownSquare Labs 本地化系统独一无二的关键组成部分。您可以自行进一步了解该计划。
通过GitHub实现文档和翻译同步
我们的版本库使用多个分支来管理文件和翻译。下面将详细解释每个特殊分支的目的和功能:
分支概览
-
dev
dev
分支运行 GitHub Actions 来处理同步任务,你可以在.github/workflows
目录中找到工作流配置。sync-fork.yml
:此工作流程从上游版本库同步文档。每天 00:00 运行。sync-translations.yml
:此工作流程将更新的翻译同步到相应的语言分支,以便在相应的语言网站上进行预览。
-
main
这个分支通过在dev
分支上运行的 GitHub Actions 与上游仓库保持同步。它也用于更新我们的打算提交给原始仓库的某些代码。 -
l10n_main
这个分支包括了来自main
分支的所有更改和 Crowdin 的翻译,这个分支中的所有修改都会定期通过使用名为l10n_main_[some data]
的新子分支提交到上游仓库。 -
**
l10n_feat
或者l10n_feat_[特定函数]** 这个分支将包含与翻译系统相关的代码或文档的更改。 一旦所有内容完成后,此分支中的更改将合并为
l10_main`。 -
[lang]_preview
这些分支被指定用于特定语言的预览,例如ko_preview
用于韩语ja_preview
用于日语。它们允许我们在不同语言中预览网站。
dev
分支运行 GitHub Actions 来处理同步任务。你可以在 .github/workflows
目录中找到工作流配置:
如何创建新的 Crowdin 项目
-
登录您的 Crowdin 帐户。
-
点击菜单中的
Create new project
。 -
设置项目名称和目标语言。您可以稍后在设置中更改语言。
-
转到刚刚创建的项目,选择
Integrations
,点击Add Integration
按钮,搜索GitHub