hyperlink - Sphinx / reST：同一段落中的多个匿名显式外部链接

Question

如何在同一段落中创建两个单独的外部链接，例如：

for pytorch click `here <http://www.pytorch.org>`_ and for tensorflow click
`here <http://www.tensorflow.org>`_

显示如下

对于 pytorch，请单击此处，对于 tensorflow，请单击此处

但是带有分隔或非内联链接！这将允许我将所有外部链接收集在一个地方，并使用我喜欢的任何标题调用它们。

现在，如果我使用匿名链接，如下代码所示：

.. __: pytorch_
for example.com click here__

.. __: tensorflow_
and for tensorflow.com click here__

.. _pytorch: http://www.pytorch.org
.. _tensorflow: http://www.tensorflow.org

这就是我得到的（注意单独的段落）

对于 pytorch，请单击此处
对于张量流，请单击此处

换句话说，如果我们举这个例子......我可以使用相同的标题（例如）链接到同一段落中的here两个不同的显式和非内联外部链接吗？

Answer 1

按照这个答案，使用带有 raw-html 角色的替换。

添加到conf.py：

rst_epilog = """
.. role:: raw-html(raw)
   :format: html

.. |pytorch| replace:: :raw-html:`<a href="https://www.pytorch.org">here</a>`

.. |tensorflow| replace:: :raw-html:`<a href="https://www.tensorflow.org">here</a>`
"""

在你的.rst：

|pytorch| and |tensorflow|

Answer 2

extlinks扩展旨在缩短外部链接，但它也允许指定链接描述文本

要使用它，请在您的conf.py

# enable `extlinks` extension
extensions = [
        'sphinx.ext.extlinks',
]

# add external URLs
extlinks = {
        'pytorch': ('https://www.pytorch.org/%s', 'pytorch'),
        'tensorflow': ('https://www.tensorflow.org/%s', 'tensorflow')
        }

现在在文档中执行以下操作：

Incidentally :tensorflow:`some <>` libraries turn out to be more popular than
:pytorch:`some <>`

输出应如下所示

顺便说一句，有些图书馆比有些图书馆更受欢迎