创建带有独立文本的链接

时间:2018-06-22 01:34:35

标签: python-sphinx restructuredtext

是否可以使用sphinx创建文档内链接,以使显示的文本独立于链接和目标? 目前,我可以像这样进行文档内链接:

.. _Label_For_Section:

===============
Name Of Section
===============

The link :ref:`Label_For_Section` is rendered as "Name Of Section".
The link Label_For_Section_ is rendered as "Label_For_Section".

我想要的是一种具有链接的方式,其中目标文本,链接标签和显示的链接文本都可以是不同的字符串。例如,链接到名为“ A”的标签为.. _B:且呈现为“ C”的部分

注意

我注意到其他种类的链接(例如外部超链接)也受到类似的约束,我认为解决方案可能看起来很相似,但是我正在寻找文档内链接的解决方案。

1 个答案:

答案 0 :(得分:2)

请参见Cross-referencing arbitrary locations,尤其是ref role

:ref:`Link title <label-name>`