集成

连接代码仓库和 CMS 翻译,在 CI 中运行本地化,收集 Crowdin 评测依据,或调查 Jira 反馈。

将 Lingo.dev 与团队日常编写、翻译和审核内容的工具搭配使用。每种连接各有用途:有些将译文写回源系统,有些则收集评测依据或协助调查反馈。

直接在内容所在的系统中翻译 #

这些原生连接会读取选定的源内容,交由本地化引擎翻译,再通过你授予的服务平台访问权限将结果写回。

连接触发方式译文写回位置
GitHub已配置的代码仓库事件,或指定范围的翻译命令为默认分支的变更创建翻译拉取请求,或向符合条件的拉取请求分支提交译文。
Payload手动同步,或插件发送的源内容变更通知原集合和全局中,所选目标语言区域对应的本地化字段。
WordPress手动同步,或通过插件通知的已发布内容保存事件每篇文章在所选语言下关联的 Polylang 或 WPML 译文。
Zendesk 帮助中心手动同步所选类别、分区和文章的各语言版本。

提供商设置决定访问范围。在 GitHub 中,请选择仓库和源文件匹配模式。在 Payload 中,请选择包含本地化字段的集合和全局。在 WordPress 中,请选择文章类型。在 Zendesk 中,请分别选择类别、分区和文章:选中某个类别不会自动选中其子项。

发布行为也因提供商而异。在 Payload 的发布模式下,如果已发布的文档仍有未发布的修改,系统会等这些修改发布或撤销后再写入译文,因为发布译文会让这些修改一并上线。在 Zendesk 中写入草稿可能会移除已上线的语言区域版本,直到该版本重新发布。首次写入前,请先阅读提供商文档中的发布章节,尤其是在已有译文的情况下。

在你的流水线中运行翻译 #

GitHub Actions、GitLab CI、Bitbucket Pipelines 和 Buildkite 都会在你自己的运行器上运行 CLI。这些配置示例以可下载的构建产物或单个受信任分支为起点,方便你在扩大仓库写入权限前检查结果。提交 .lingo/lock.json 后,如果源文件在上次翻译后有过更改,或目标文件缺失,lingo check 就会让拉取请求或合并请求的检查失败。无需 API 密钥。

调度、密钥、输出保留,以及提交或拉取请求的创建,都由你的流水线负责。Lingo.dev API 密钥用于授权翻译,服务平台凭据则用于授权代码仓库写入。在 CI 中自动执行翻译介绍了如何将源内容修订版本、已完成的输出和应用检查关联起来。

评测翻译或调查反馈 #

Crowdin 会将受支持的字符串级活动发送到 Radar。你可以借此检查在 Crowdin 中生成的译文,无需迁移翻译生成或审核工作流。针对你想解答的问题配置评测,再查看收集到的文本和评测结果。此连接不会将修正后的译文同步回 Crowdin。

Jira 从已报告的问题入手。添加 lingo 标签后,问题分流工作流会检查该问题,并提出术语表、规则或品牌语调的修改建议。用户逐条应用或忽略建议后,再决定是否重新翻译受影响的已连接内容。Jira 问题分流不会将工单内容作为本地化项目进行翻译。

先完成首次运行,再扩大范围 #

每个服务平台页面都会引导你完成一次小范围的首次运行,涵盖授权、配置、输出检查和恢复。借助这次运行,确认连接会读取和更改哪些内容。连接是否可用,可能取决于组织权限和功能访问权限;仅有服务平台凭据,并不代表可以访问本地化引擎。

停用连接时,请先停止新的触发,并单独处理服务平台凭据。断开连接不会撤销已交付的内容、已发布的评论或已记录的评测。服务平台的恢复说明会介绍哪些状态将保留,以及重新连接后会发生什么。

如果工作流由应用管理,请继续阅读 DevTools,了解 API、CLI 和 JavaScript 接口。