【问题标题】:Create a link with independent text创建带有独立文本的链接
【发布时间】:2018-06-22 01:34:34
【问题描述】:

是否可以使用 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”

注意

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

【问题讨论】:

    标签: python-sphinx restructuredtext


    【解决方案1】:

    Cross-referencing arbitrary locations,特别是ref role

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

    【讨论】:

      猜你喜欢
      • 2014-07-28
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2014-05-21
      相关资源
      最近更新 更多