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

问题描述 投票:36回答:1

在狮身人面像中,如果我有以下标题声明:

.. _somestuff:

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

它像这样渲染:

[this is code,这不是!

哪个好,但是,如果使用引用,例如:

Have a look at :ref:`somestuff`

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

看看this is code, this is not!

而不是:

看看this is code, this is not!


是否可以在参考文献中保留代码格式?我该怎么办?

python-sphinx restructuredtext documentation-generation
1个回答
2
投票
如果您查看this is code中有关内联标记的:ref:文档:

:ref:

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

我认为(就像@Kevin Horn一样)现在不可能了,因为它仅用于创建与项目中其他部分的链接(无第一种格式)。然后,如果您编写这样的内容:

official web site

如果我链接到这些部分:

.. _somestuff: ``this is code``, this is not! ============================== .. _another_somestuff: this is another code! ========================

结果是:


看看

这是代码,这不是!

看看

这是另一个代码!

看看

此链接

] >>
所有样式都相同。

:斜体/粗体字表示链接
© www.soinside.com 2019 - 2024. All rights reserved.