reST：具有任意标题的内联链接？

| 如果定义了内部超链接目标，如何使用任意文本作为链接标题链接到它？例如： _`这是一个非常长的内部链接目标。 ... 指向很长链接目标的“简短参考” _。我怎样才能使“简短参考”目标成为“非常长的内部目标”？编辑：另一个示例：小部件 ======= ... 使用`widget`_。如何使“小部件”（单数）链接到“小部件”（复数）标题？（当然，我意识到可以使用`widget`_\\s完成此操作……但这并不能解决一般问题）

已邀请:

3 个回复

纫合峭

我还没有找到使用“标准” reST来执行此操作的方法。但是使用Sphinx，可以实现以下功能：

.. _`This is a very long internal link target`:

:ref:`Short reference <This is a very long internal link target>` to the very long link target.

痰嫉

很好，mzjn的答案也适用于课程：

:class:`MyClasses <mymodule.MyClass>` in plural is awesome.

欢呼！

感秆暴壳

pure-reStructuredText方法是为同一目标定义多个目标名称：

.. _my widget:
.. _above:
My long title about widgets
===========================
…
See how to use  `my widget`_ in the section above_.

（此方法的局限性在于您可能要在两个不同的位置使用相同的文本（例如\“ above \”），并且上述方法在这种情况下会失败。）

要回复问题请先登录或注册

reST：具有任意标题的内联链接？

3 个回复

发起人

python

documentation

restructuredtext

问题状态

reST：具有任意标题的内联链接？

与内容相关的链接

3 个回复

发起人

python

documentation

restructuredtext

问题状态