这篇文章介绍了帮助中心主题的 GitHub 整合错误消息,以及在添加或更新主题时,对于所碰到的问题应采取的故障排除步骤。
您必须是 Guide 管理员才能管理 GitHub 整合。
导入主题失败

-
请确保您已正确撰写 GitHub 存储库 URL 或[用户名]/[存储库]。查看存储库时,最好从地址栏复制粘贴存储库 URL。
- 如果您从特定分支抓取,请确保您正确填写了分支名称。
- 确保您有权访问存储库
- 确保 Zendesk Guide 应用已授权
更新主题失败
确保您有权访问存储库
前往 https://github.com/settings/repositories,确保您可访问存储库。如果您没有看到存储库,那可能是因为您的访问权限已被撤销,或存储库已被删除。联系存储库的管理员以了解更多
-
如果您的访问已被撤销,则需要存储库管理员再次授予您访问权限。
-
如果存储库已被删除,您就无法更新主题或将其连接到另一个存储库,而必须从现有存储库启动新的导入。
确保 Zendesk Guide 应用已授权
确保 Zendesk Guide 应用已在 GitHub 中被授权用于您的帐户。前往 https://github.com/settings/applications,在“已授权的 OAuth 应用”标签中检查 Zendesk Guide 应用是否可以访问您的帐户。
如果 Zendesk Guide 应用未显示已授权的 OAuth 应用,可能是因为:
-
Zendesk Guide GitHub 应用的授权已撤销,您需要重新授权。为此,请尝试再次更新主题;如果操作失败,请尝试添加主题为新主题,然后尝试更新要更新的主题。
- 拥有存储库的 GitHub 组织不允许对 Zendesk Guide 应用授权。在这种情况下,您应联系 GitHub 组织的管理员,以获得“存储库”作用域的 Zendesk Guide 应用授权。由于这是 GitHub 提供的唯一允许访问存储库中代码的作用域,因此没有允许更小作用域的选项。
错误的主题版本号
manifest.json 文件中的主题版本号需要增加,因为它与当前的版本号冲突。增加主题版本号或让主题开发者这样做。
主题版本号不允许使用
manifest.json 文件中的主题版本号不符合版本控制约定。让主题开发者更正主题版本号,使其符合版本控制约定。
无法使用 Internet Explorer 授权
GitHub 不再支持 Internet Explorer,因而无法通过该浏览器进行身份验证,不过可以使用 GitHub 和 Zendesk 支持的其他浏览器进行身份验证,例如 Google Chrome、Firefox 或 Safari。