文档

通过建议功能维护翻译内容

让母语使用者修复您网站上的文案,审核他们的建议,并通过常规的拉取请求应用这些更改。

模型能正确翻译大部分字符串,但母语读者仍能发现其中的错误。借助建议功能,该读者可修正您网站上的措辞,您可在 Coroid 中审核这些修改,随后改动会以普通的 pull request 形式进入您的代码库。

这就是 Coroid 用十三种语言维护自身产品的方式。下述步骤的前提是项目已按照说明完成国际化处理。国际化项目此处所有内容都存放在项目的工作台下的本地化。

启用贡献功能

贡献功能需要两项配置:.coroid/i18n.json项目的建议绑定规则,以及支持该功能的引擎版本。国际化向导会默认添加这两项配置。

对于未设置这两项配置的项目,请打开贡献者并选择提议启用贡献功能Coroid 会生成一个任务来添加这两项配置,您只需合并其生成的 pull request 即可。在此之前,贡献者会提示缺少哪些配置。

邀请贡献者

选择邀请贡献者,输入对方的电子邮箱以及其可翻译的语言即可。

  • 审核。保持应用建议前先审核对新贡献者保持开启状态。若关闭该功能,建议会立即获批,但仅当建议的源文本与同步的代码库内容一致时才会如此。
  • 无需占用席位。贡献者不会被添加到您的组织中,也不会占用成员席位。其访问权限仅局限于该项目及选定的语言。
  • 邀请会过期。受邀人需在七天内使用被邀请的邮箱地址登录或创建账户并予以确认。

撤销访问权限会停止新的建议提交,但会保留该人的历史记录。

您网站上的选择器

贡献者可通过您的网站提交建议,在该页面上他们能看到上下文中的文本。

  1. 在设置 → 访问与开销 → 站点来源下添加每个站点的地址,每行对应一个 HTTPS 来源,然后启用即可。新的来源需经所有者或管理员启用后才能使用。
  2. 在贡献者中选择准备站点集成任务该任务会将 Coroid 的选择器包添加到您的网站。仅当页面地址包含?coroid-translate=1时才会加载该包,因此普通访客无需下载任何内容。
  3. 贡献者只需携带该参数打开您的网站,点击相应字符串,Coroid 的弹出窗口便会弹出,显示对应的键、源文本及当前译文。
ACMENeuheitenAngeboteMarken
Weiter zur Kasse gehen

Kostenloser Versand ab 50 € und 30 Tage Rückgabe.

Bestellung prüfen
翻译模式点击任意文本即可退出
建议新增翻译内容
关键词
ui · cart.checkout
英语源文本
Proceed to checkout
当前翻译
Weiter zur Kasse gehen
您的翻译
Zur Kasse

请保持大括号与尖括号内的内容与原样一致。

提交建议

处于翻译模式的客户站点:贡献者点击标题后,可在 Coroid 弹出框中提出更优的德语表述。仅为示例数据。

弹出窗口会在发送前检查占位符。贡献者需在弹出窗口中登录 Coroid;您的网站不会处理其凭证。匿名建议不会被接受。

审核

建议列表会显示每条建议对应的键、语言、源文本、当前译文及拟议译文。可按状态或语言筛选,随后批准或拒绝每条建议。您也可以一次性拒绝多条建议。

本地化
门店页面
英语 源码 · 5 多种语言 · 已校验 2小时前 于 3f2c9a1
  • 概览
  • 字符串
  • 建议
  • 交换
  • 贡献者
  • 自动化
  • 设置
建议
准备修正任务
待审核已批准已应用
  • cart.checkoutdeLena · 德语
    en
    Proceed to checkout
    de
    Weiter zur Kasse gehen
    de
    Zur Kasse
    批准驳回
  • product.inStockfrHugo · 法语
    en
    In stock
    fr
    En stock
    fr
    Disponible
    批准驳回
  • nav.dealsdeLena · 德语

    提交的源文本与仓库中同步的文本不一致。

    en
    Weekly deals
    de
    Angebote
    de
    Angebote der Woche
    批准驳回

工作台中的建议:待决策的修正内容,已与同步的源文本核对。此为示意性数据。

Coroid 会将每条建议的源文本与同步的默认分支内容进行对比。若贡献者查看建议后源文本发生了变动,则该建议无法获批,对应行会标注相关信息;拒绝该建议后,贡献者可重新提交建议。

状态含义
待审核等待审核人处理
已批准准备进入下一轮修正任务
已排队修正任务正在应用该建议
已应用内容写在 pull request 中;合并并部署后即生效
源文本已变动源文本在应用前发生了变更
无效该建议未通过引擎检查,例如存在损坏的占位符
已拒绝审核人拒绝了该建议

应用已批准的建议

将已批准的建议转换为 pull request 有两种方式。两种方式均使用同一修正任务:该任务会执行指定引擎的apply-claim命令,重新检查每条源文本,仅写入目标目录,并报告已应用、已过时及无效的内容。

  • 立即执行。在建议中选择准备修正任务,或者 提交在字符串下操作。一个任务最多可处理项目中500条已批准的建议,以及工作台中做出的相关更改。
  • 每晚执行一次。向导默认会安装夜间修正任务;否则请在安装夜间修正任务中操作自动化任务。该计划于02点运行:00它会在 UTC 时间运行,不会调用模型,仅当内容获批后才创建任务。可在Factory中的调度表中暂停或恢复它的运行。

在Coroid之外合并的字符串。

人们也会修改并非由Coroid编写的拉取请求中的字符串。该向导会安装翻译在Coroid之外合并的字符串。默认情况下如此;否则请将其安装在自动化任务当此类pull request合并到你的默认分支时,Coroid会读取它此前针对该pull request执行的翻译检查结果。如果存在缺失或过时的字符串,它会为此合并请求创建一个翻译任务。若无需翻译任何内容,则不会有任何操作。

这需要翻译内容对拉取请求执行检查,以及审核每一条PR自动化流程,因此该检查会在合并前执行。

将设置迁移至其他组织

设置导出和导入功能会携带夜间调度表及合并字符串自动化规则。它们会在目标项目中处于暂停状态,站点源地址会被禁用,且贡献者不会被同步:需在新组织中重新邀请他们。