文章/答案/技术大牛

发布

社区首页 >问答首页 >如何链接reStructuredText中的重复目标？

问如何链接reStructuredText中的重复目标？
EN

Stack Overflow用户

提问于 2020-11-10 12:37:33

回答 1查看 92关注 0票数 0

我的文档中有两个重复的键-> .. command:: targetName在两个单独的页面上。我需要知道如何使用以下语法链接到这两个单独的目标：

Page-1 Click this -> :command:`targetName`  # this will always open the first targetName declared in the doc

目标：

Page-1 Click this -> :command:`targetName <page-1.html#targetName>`  # not working :/
Page-2 Click this -> :command:`targetName <page-2.html#targetName>`  # not working :/
Page-2 Click this -> `targetName <page-2.html#targetName>`_  # this will work but I don't want to use hyperlink instead of " :command: " cuz I want to keep my block style as is.

restructuredtext

cross-reference

python-sphinx

回答 1

Stack Overflow用户

回答已采纳

发布于 2020-11-11 06:40:21

首先是一些术语。您所称的targetName在reStructuredText中称为title。尖括号中的东西是target。见交叉引用语法。

reStructuredText不支持嵌套内联标记，其中包括样式超链接。然而，替换有一个解决办法。

由于reStructuredText不支持嵌套的内联标记，使用样式文本创建引用的唯一方法是使用“替换”指令替换：我建议你试试|Python|_。。。用Python替换：：Python，*这里最好的语言。_Python：http://www.python.org/

就你而言：

Page-1 Click this -> |myTarget|_

.. |myTarget| replace:: ``targetName``
.. _myTarget: page-1.html#targetName

要进一步自定义外观，请使用自定义样式。关于一个例子，请参见如何为reStructuredText、狮身人面像、ReadTheDocs等建立自定义样式？。

票数 2

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/64769094

复制

相似问题

问如何链接reStructuredText中的重复目标？
EN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问如何链接reStructuredText中的重复目标？EN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问如何链接reStructuredText中的重复目标？
EN