Skip to main content

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

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

自动链接在包含 GitHub Pro、GitHub Team、GitHub Enterprise Cloud、 和 GitHub Enterprise Server 的存储库中可用。

关于自动链接

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

自动链接引用现在可接受字母数字字符。 最初引入时,自定义自动链接仅限于使用数字标识符的外部资源。 自定义自动链接现在使用字母数字标识符。

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

  • 引用前缀不能具有重叠的名称。 例如,存储库不能有两个带有前缀的自定义自动链接,例如 TICKETTICK,因为这两个前缀都将匹配字符串 TICKET123a
  • 目标 URL 包含一个代表链接资源的引用标识符的 <num> 变量。

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

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

  1. 在 your GitHub Enterprise Server instance 上,导航到存储库的主页。 1. 在存储库名称下,单击 “设置”。 “存储库设置”按钮

  2. 在边栏的“集成”部分中,单击“ 自动链接引用”。

  3. 单击“添加自动链接引用”。 用于填写自动链接引用信息的按钮。

  4. 选择外部资源中使用的引用标识符的格式,字母数字或数字。 自动链接格式设置,字母数字或数字。

  5. 在“Reference prefix(引用前缀)”下,输入您希望协作者用来为外部资源生成自动链接的、简短有意义的前缀。 用于键入外部系统缩写的字段

  6. 在“Target URL(目标 URL)”中,输入您想要链接到的外部系统的链接。 使用 <num> 变量作为引用标识符的占位符。 用于键入外部系统 URL 的字段

  7. 单击“添加自动链接引用”。