Python sphinx 如何将Sphinx/reStructuredText链接紧凑地格式化为代码?

Python sphinx 如何将Sphinx/reStructuredText链接紧凑地格式化为代码?,python-sphinx,markup,Python Sphinx,Markup,我正在生成Sphinx文档,并希望我的docstring在代码中尽可能具有可读性,因此我希望尽量减少,同时直接从docstring生成尽可能多的Sphinx文档 特别是,我希望能够尽可能不让URL出现在文档字符串中,让它们出现在不太令人不安的地方,并在适当的地方将链接文本格式化为代码。但不清楚如何做所有这些事情。比如说, Sadly, `git`_, though it works as a link, does not format `git` as code, while ``git``_

我正在生成Sphinx文档,并希望我的docstring在代码中尽可能具有可读性,因此我希望尽量减少,同时直接从docstring生成尽可能多的Sphinx文档

特别是,我希望能够尽可能不让URL出现在文档字符串中,让它们出现在不太令人不安的地方,并在适当的地方将链接文本格式化为代码。但不清楚如何做所有这些事情。比如说,

Sadly, `git`_, though it works as a link, does not format `git` as code, 
while ``git``_ generates an error; and `git <http://git-scm.com>`_ 
again does not format `git` while ``git` <http://git-scm.com>`_ is 
again an error.
.. _`git`:  http://git-scm.com
或者像这样的替代品

:git:

生成代码格式的链接?

看起来像的副本。不完全是这样,我的问题更一般地是关于创建紧凑链接的方法,但我认为我的答案(“不,我所做的是尽可能接近的”)来自该问题,所以:像副本一样关闭。
:git: