Sphinx v1.0的新功能：
sphinx.ext.extlinks –标记以缩短外部链接
https://www.sphinx-
doc.org/en/master/usage/extensions/extlinks.html
该扩展添加了一个新的配置值：
外部链接
此配置值必须是外部站点的字典，并将唯一的简短别名映射到基本URL和前缀。例如，要为上述问题创建别名，您可以添加
extlinks = {'issue': ('http://bitbucket.org/birkenfeld/sphinx/issue/%s', 'issue ')}现在，您可以将别名用作新角色，例如
:issue:123
`。然后，这会插入一个指向[http://bitbucket.org/birkenfeld/sphinx/issue/123](http://bitbucket.org/birkenfeld/sphinx/issue/123)的链接。如您所见，在角色中给定的目标已替换为基本URL中的%s`。
链接标题取决于元组中的第二项，即前缀：
如果前缀为None，则链接标题为完整URL。如果前缀为空字符串，则链接标题为角色内容中给出的部分URL（在这种情况下为123）。如果前缀为非空字符串，则链接标题为部分URL，前缀为前缀–在上面的示例中，链接标题将是问题123。您还可以使用生成链接的其他角色（即）所支持的通常的“显式标题”语法
:issue:this
issue <123>``。在这种情况下，前缀不相关。
