微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

如何在reStructuredText中链接重复的目标?

如何解决如何在reStructuredText中链接重复的目标?

我的文档在两个不同的页面上有两个重复的键-> private final Object lock = new Object();。我需要知道如何使用以下语法链接到这两个单独的目标:

.. command:: targetName

目标:

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

解决方法

首先介绍一些术语。您所说的targetName在reStructuredText中称为title。尖括号中的内容是target。参见Cross-referencing syntax

reStructuredText不支持嵌套的嵌入式标记,其中包括样式超链接。但是,replacement有一种解决方法。

由于reStructuredText不支持嵌套的行内标记,因此创建带有样式文本的引用的唯一方法是使用带有“ replace”指令的替换:

I recommend you try |Python|_.

.. |Python| replace:: Python,*the* best language around
.. _Python: http://www.python.org/

在您的情况下:

Page-1 Click this -> |myTarget|_

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

要进一步自定义外观,请使用自定义样式。有关示例,请参见How do I set up custom styles for reStructuredText,Sphinx,ReadTheDocs,etc.?

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。