sphinxcontrib_github_alt 1.2

链接到特定项目的GitHub问题、拉取请求、提交和用户。

要使用此扩展，请将其添加到 conf.py 中的 extensions 列表，并设置变量 github_project_url

extensions = [...
              'sphinxcontrib_github_alt',
             ]

github_project_url = "https://github.com/ipython/ipython"

然后在您的文档中使用以下角色

* :ghissue:`12` - link to issue #12
* :ghpull:`35` - link to pull request #35
* :ghcommit:`3a1cb54` - link to commit
* :ghuser:`ipython` - link to a user or organisation

它被称为“alt”，因为 sphinxcontrib-github 已经存在。IPython & Jupyter项目在将其作为独立包之前就已经使用这个扩展中定义的语法了一段时间，所以我们不想切换到 sphinxcontrib-github 。