关于自动链接
具有仓库管理员权限的任何人均可配置自动链接引用,将议题、拉取请求提交消息、和发行说明链接到外部第三方服务。
自动链接引用现在可以接受字母数字字符。 最初引入时,自定义自动链接仅限于使用数字标识符的外部资源。 自定义自动链接现在适用于字母数字标识符。 仅识别数字标识符的旧版自动链接引用将被弃用,并带有“旧版”标签。
您可以通过指定引用前缀和目标 URL 来定义自定义自动链接。
- 引用前缀不能具有重叠的名称。 例如,存储库不能有两个自定义自动链接,其前缀为
TICKET
和TICK
,因为这两个前缀都与TICKET123a
字符串匹配。 - 目标 URL 包含一个支持以下字符的
<num>
变量:a-z
(不区分大小写)、0-9
和-
。
配置自动链接以引用外部资源
此过程演示如何配置自动链接以引用外部资源。 例如,如果您使用 Zendesk 跟踪用户报告的工单,则可以在打开的拉取请求中引用事件单编号以解决问题。
-
在 GitHub.com 上,导航到仓库的主页面。
-
在仓库名称下,单击 Settings(设置)。
-
在边栏的“Integrations(集成)”部分中,单击 自动链接引用。
-
单击 Add autolink reference(添加自动链接引用)。
-
在“Reference prefix(引用前缀)”下,输入您希望协作者用来为外部资源生成自动链接的、简短有意义的前缀。
-
在“Target URL(目标 URL)”中,输入您想要链接到的外部系统的链接。 确保将
<num>
保留为引用号的变量。 -
单击 Add autolink reference(添加自动链接引用)。