SPHINX“唯一”指令列表？

Question

当在狮身人面像中使用重组文本时，如何使用

only

指令使用可选的列表项目？ 例如一个例子：

foo bar:

- a
- b
.. only:: Internal

   - c
- d

上面的问题是，在生成HTML时，它会为

<p>

和

- c

创建一个单独的

- d

。有人知道我如何将所有这些包含在生成的HTML中的单个

<ul>

中？谢谢！

您不能直接在列表项目之间放置指令。该位置的任何文本或RST语法构造都将列表分为二。

Answer 1

-nested

“类”指令和目标应用于以下文档树元素

1

.。 示例：要将类值应用于列表项目“ C”，请将“类”指令附加到项目“ B”的内容：

foo bar:

- a
- b

  .. class:: internal
- c
- d

需要“类”指令之前的空行 - 否则将其解释为前面段落的延续线。 列表项目之间的空线是可选的。

在sphinx中，使用“ rstclass”而不是“类”。

• 您可能会尝试使用狮身人面像的“仅”指令使用相同的概念。另外，您可以使用

  STRIP_ELEMENT_WITH_CLASSES

  DOCUTILS配置选项以删除“分类”项目。