首页
学习
活动
专区
圈层
工具
发布
社区首页 >问答首页 >Rinohtype链接文本是“第3.1节”,而不是链接或链接目标中指定的文本。

Rinohtype链接文本是“第3.1节”,而不是链接或链接目标中指定的文本。
EN

Stack Overflow用户
提问于 2021-07-29 07:30:50
回答 1查看 80关注 0票数 1

我将一个明确的链接目标指定如下:

代码语言:javascript
复制
.. _REPLY_STATUS_CODE:

REPLY_STATUS_CODE (0x0001)
---------------------------

然后创建一个引用,如下所示:

代码语言:javascript
复制
Related
    :ref:`REPLY_STATUS_CODE`

也尝试过这样的方法:

代码语言:javascript
复制
A :ref:`REPLY_STATUS_CODE <REPLY_STATUS_CODE>` command...

在这两种情况下,链接上的文本都是“Section3.8”,而不是"REPLY_STATUS_CODE“,使用Sphinx构建HTML,将链接文本呈现为"REPLY_STATUS_CODE”。有没有一种方法可以得到我想要的文本,而不是章节和数字?

EN

回答 1

Stack Overflow用户

回答已采纳

发布于 2021-07-30 15:12:46

通过调整链接引用样式,可以使rinohtype创建与HTML中的链接相同的链接:

代码语言:javascript
复制
[STYLESHEET]
name = My custom style sheet
base = sphinx

[linked reference]
type = custom

您仍然可以使用:numref:角色显式地按数字引用元素(这确实需要设置numfig = True,也会影响HTML )。有关更多信息,请参见发布#244如何恢复目标编号引用?

理想情况下,提供像您尝试过的显式链接文本(:ref:`REPLY_STATUS_CODE <REPLY_STATUS_CODE>` )将覆盖按编号链接部分的默认行为,但这将需要对docutils/Sphinx进行更改,因为rinohtype无法看到包含显式链接文本和没有显式链接文本的引用之间的区别。

最后,如果能够定义一个自定义角色,以便rinohtype能够区分不同类型的引用,那就太好了。例如:

代码语言:javascript
复制
.. role:: titleref(ref)
   :class: titleref

唉,这也不可能。因此,至少就目前而言,您只能区分使用:ref::numref: (这也会影响HTML )。

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

https://stackoverflow.com/questions/68571864

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档