在 Sphinx 中的引用中保留内联代码

2024-05-08

在 Sphinx 中,如果我有以下标题声明:

.. _somestuff:

``this is code``, this is not!
==============================

它呈现如下:

    this is code, 这不是!

这很好,但是,如果我使用参考,例如:

Have a look at :ref:`somestuff`

它丢失了代码格式并呈现如下:

看一下这是代码,这不是! http://s.tk

代替:

看一下this is code, 这不是! http://s.tk


是否可以保留参考中的代码格式?我该怎么办呢?


如果你看一下:ref:其文档官方网站 http://sphinx-doc.org/markup/inline.html关于内联标记:

:ref:

为了支持对任何文档中任意位置的交叉引用, 使用标准的rest标签。为此,标签名称必须 在整个文档中保持唯一......

我认为(正如@Kevin Horn)现在不可能,因为它仅用于创建与项目中其他部分的链接(无需首先格式化)。那么如果你写这样的东西:

.. _somestuff:

``this is code``, this is not!
==============================

.. _another_somestuff:

this is another code!
========================

如果我链接到这些部分:

Have a look at :ref:`somestuff`
Have a look at :ref:`another_somestuff`
Have a look at :ref:`this link <somestuff>`

结果是:


看一下这是代码,这不是!

看一下这是另一个代码!

看一下这个链接


它们的风格都是一样的。

Note:斜体/粗体字表示链接

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

在 Sphinx 中的引用中保留内联代码 的相关文章

随机推荐