集成

GitHub (Strings)

文本由 Phrase Language AI 从英语机器翻译而得。

提示

有关 Phrase TMS 中 GitHub 集成的信息,请参阅 GitHub (TMS)

先决条件

  • .phrase.yml 配置文件必须位于要监控的分支根中。该文件定义了从存储库导入( pull)或导出( push)哪些文件。

  • 存储库需要读取和写入访问。

  • 配置文件定义不正确可能会导致错误。确保文件至少包含一个 push 和一个 pull 译文、正确的文件格式以及 update_translations 参数的正确设置。

  • GitHub 访问令牌

    • 经典令牌

      需要存储库范围(如果与公共存储库同步,则为 public_repo

    • 细粒度令牌

      需要以下权限:

      • 目录:读取和写入

      • pull 请求:读取和写入

  • 如果在 GitHub 中启用了 SSO,也必须为访问令牌启用。

  • 无法保护 phrase_translations 分支。

  • 确存储库设置不需要签名的提交。

注释

由于不断改进,用户界面可能与视频中呈现的不一样。

连接存储库

配置文件就绪后,要连接存储库,请执行以下步骤:

  1. Integrations 页面,向下滚动到 GitHub 同步连接器,然后单击 Configure

    存储库同步页面打开。

  2. 单击添加同步/GitHub

    GitHub 同步设置窗口打开。

  3. 从下拉列表中选择项目。

  4. 您可以选择自托管实例并提供 GitHub 自托管 API 端点

  5. 提供具有 API 范围的个人 Repo 访问令牌

  6. 从下拉列表中选择 GitHub 存储库

  7. 从下拉列表中选择一个存储库分支,从中导入(push)和导出( pull)。这通常是主分支。

  8. 单击验证配置以确保访问令牌和配置文件正确。

  9. (可选)选择自动导入以导入每次提交到所选 GitHub 分支的文件。

  10. 点击保存

    该项目已连接到选定的 GitHub 存储库并添加到列表中。

导入文件

确保在 .phrase.yml 配置文件中正确配置 push Orchestrator 命令。push 选项与 uploads API 端点相同。

导入文件:

  • 存储库同步页面,选择一个项目并单击导入导入_sync.png

    语言文件(在配置文件中定义为 push 原文/源语条目)导入项目。

    必须存在默认区域。

    注释

    如果导入时出现问题,请使用 CLI 客户在本地测试 .phrase.yml 配置文件并检查是否有错误信息。

    如果需要,请联系 phrase 技术支持,并在支持请求中附上 .phrase.yml 配置文件。

导出文件

确保在 .phrase.yml 配置文件中正确配置 pull Orchestrator 命令。pull 选项(例如 include_empty_translations 参数)与 locales download API 端点相同。

导出文件:

  1. 存储库同步页面,选择一个项目并单击导出导出_sync.png

    存储库库中最新的语言文件将作为新的pull请求导出。

  2. 导出文件后,可以在存储库库中合并或关闭pull请求,并删除分支。

注释

如果导出时出现问题,请使用 CLI 客户在本地测试 .phrase.yml 配置文件并检查是否有错误信息。

如果需要,请联系 phrase 技术支持,并在支持请求中附上 .phrase.yml 配置文件。

历史

存储库同步保存每个 Phrase Strings 项目的最新导入和导出历史记录。

查看历史记录:

  • Repo 同步 页面,选择一个项目并单击 History history_sync.png

    显示了项目的导入和导出历史。历史记录中的导出条目包括指向相应合并请求的链接。

这篇文章有帮助吗?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.