Skip to main content

配置自动链接以引用外部资源

您可以将自动链接添加到 JIRA 议题和 Zendesk 事件单等外部资源,以帮助简化工作流程。

自动链接可用于具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud、和 GitHub Enterprise Server 的仓库。 更多信息请参阅“GitHub 的产品”。

具有仓库管理员权限的任何人均可配置自动链接引用,将议题、拉取请求提交消息、和发行说明链接到外部第三方服务。

自动链接引用现在可以接受字母数字字符。 最初引入时,自定义自动链接仅限于使用数字标识符的外部资源。 自定义自动链接现在适用于字母数字标识符。 仅识别数字标识符的旧版自动链接引用将被弃用,并带有“旧版”标签。

您可以通过指定引用前缀和目标 URL 来定义自定义自动链接。

  • 引用前缀不能具有重叠的名称。 例如,存储库不能有两个自定义自动链接,其前缀为 TICKETTICK,因为这两个前缀都与 TICKET123a 字符串匹配。
  • 目标 URL 包含一个支持以下字符的 <num> 变量: a-z(不区分大小写)、0-9-

此过程演示如何配置自动链接以引用外部资源。 例如,如果您使用 Zendesk 跟踪用户报告的工单,则可以在打开的拉取请求中引用事件单编号以解决问题。

  1. 在 GitHub.com 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Settings(设置)仓库设置按钮

  3. 在边栏的“Integrations(集成)”部分中,单击 自动链接引用

  4. 单击 Add autolink reference(添加自动链接引用)填写自动链接引用信息的按钮

  5. 在“Reference prefix(引用前缀)”下,输入您希望协作者用来为外部资源生成自动链接的、简短有意义的前缀。 Field to type abbreviation for external system

  6. 在“Target URL(目标 URL)”中,输入您想要链接到的外部系统的链接。 确保将 <num> 保留为引用号的变量。 Field to type URL to external system

  7. 单击 Add autolink reference(添加自动链接引用)