WordPress

通过 Polylang 或 WPML 翻译 WordPress 文章和页面,并在内容发布时同步更新译文。

WordPress 将文章的每种语言版本保存为独立文章,再由 Polylang 或 WPML 将各版本与原文关联。Lingo.dev 连接会读取已发布的源语言文章,通过本地化引擎翻译标题、摘要和区块内容,并将结果写入每篇文章关联的译文。区块标记、区块设置、短代码和嵌入地址保持不变;其中的文本以及搜索、导航等区块的标签则会被翻译。

先从一种文章类型开始,手动运行一次同步。检查结果后,再让已发布文章的保存操作自动触发翻译。

WordPress 集成需要 Enterprise 套餐才能使用。请查看定价,了解当前的可用情况。如果组织需要升级套餐才能使用,设置 → 集成会在 WordPress 旁显示当前套餐不支持。

准备站点 #

站点必须可通过公共地址以 HTTPS 访问,并运行已配置好语言的 Polylang 或 WPML。Lingo.dev 根据 WordPress 提供的语言区域,将内容翻译为对应的 WordPress 语言,例如用 de_DE 对应 de-DE,因此无需配置语言映射。如果某种语言的语言区域已被另一种语言占用,就会改用较短的语言区域,例如用 de 对应 de_DE_formal,以便与 de_DE 并存。

从 WordPress 插件目录安装并启用 Lingo.dev 插件。然后在 WordPress 中打开设置 → Lingo.dev,生成密钥。插件仅保存密钥的哈希值,因此请在离开页面前复制密钥。生成新密钥会替换旧密钥;在 Lingo.dev 中输入新密钥之前,同步将暂停。

连接站点 #

在 Lingo.dev 中打开设置 → 集成,选择 WordPress 的连接;也可以从 Studio 中选择添加集成 → WordPress,打开同一表单。输入连接名称、站点地址和密钥。选择连接后,Lingo.dev 会检查插件是否使用该密钥响应、站点返回的地址是否与输入的地址一致,以及 Polylang 或 WPML 是否已启用,然后向插件提供用于接收文章变更通知的地址。同一站点一次只能连接到一个组织。

从 Studio 发起连接后,会直接进入设置流程。如果站点是在设置中连接的,其连接页面会显示在 Studio 中设置;你也可以在 Studio 的已连接列表中选择该站点,再选择设置。选择本地化引擎和要翻译的文章类型。Lingo.dev 会将内容从站点的默认语言翻译为站点中所有设有 WordPress 语言区域的其他语言;之后在 Polylang 或 WPML 中新增的语言也会自动纳入翻译。

翻译一种文章类型 #

运行同步,打开对应的工作流运行,再到 WordPress 中检查一篇翻译后的文章。检查措辞、链接、区块和发布状态,然后到站点上阅读这篇文章。

首次同步会保留站点已有的译文。如果一篇文章的译文只包含部分字段,例如标题已翻译,但摘要尚未翻译,首次同步会保留已翻译的字段,并翻译其余字段。

源文章处于已发布状态时,译文也会发布。私密或已计划发布的译文会保留原有状态;取消发布源文章不会改变其译文。

让译文与源内容的变更保持同步 #

当所选文章类型中的源语言文章发布或更新时,插件会通知 Lingo.dev,后者会重新读取文章并翻译变更内容。保存草稿或译文都不会触发翻译。Lingo.dev 还会每小时检查自上次检查以来修改过的文章,即使通知遗漏,也能补上更新。

要处理已修改的文章和缺失的译文,请使用同步。要替换现有译文,包括手动编辑过的译文,请使用重新翻译。

同步期间的编辑 #

每次写入都会携带读取时站点提供的源文章及其译文的哈希值。如果编辑者在同步翻译期间修改了其中任一内容,插件会拒绝写入,避免覆盖编辑结果,并在运行记录中将该文章标记为已跳过。下次同步会重新读取该文章。

更改设置或断开连接 #

在 Studio 中,打开该集成的设置选项卡,即可更改引擎和文章类型;语言则在 Polylang 或 WPML 中更改。前往设置 → 集成,即可重命名连接、替换密钥或断开连接。在 WordPress 中生成新密钥后,选择替换密钥,然后输入新密钥。

更改网站地址后,需要重新建立连接。断开连接会请求插件停止向 Lingo.dev 发送通知,同时删除该连接的历史记录和同步状态,但会保留 WordPress 中已翻译的文章。插件只接受使用其当前密钥发送的请求,因此,在 WordPress 中生成新密钥后,请先选择 替换密钥,再断开连接。如果使用旧密钥断开网站连接,插件仍会继续发送通知,但 Lingo.dev 会忽略这些通知;在 WordPress 中删除插件即可停止发送通知。