RST条件指令在使用标准语法时不起作用

Question

我已经在我的Makefile中定义了一个条件标签，因此我可以使用ONLY指令有条件地删除文本块。

Makefile条目：

...设置BUILDDIR = _build

sphinx-build -t内部...

我只有一条信息行需要针对特定​​的文档版本进行消失。这是实例：

general:
    workspace: "xxx"
    <first indented list items>

.. only:: internal

    xt-team-name: "phoenix"    # for use with XT Grok - exclude this line otherwise **

    <following list items - must stay put>

'internal'指令有效，但是它擦除了单行文本之后的所有内容，而我不想为此构建而擦除。在排除的文本行之后，我没有空格键字符或制表位，只是换行符。我以为换行符将结束条件运算？

将其仅用于一件作品的诀窍是什么？无法移动任何内容-这会破坏信息的前后缩进部分的逻辑。调整了示例以使其更加清晰。

Answer 1

空白在reStructuredText中具有含义。

根据internal指令缩进要为only隐藏的内容。

不要缩进要显示的内容。

general:
    workspace: "xxx"
    ...

.. only:: internal

    xt-team-name: "phoenix"    # for use with XT Grok - exclude this line otherwise **

<following body of information>

编辑

一旦意识到您想要一个项目列表而不是段落，您仍然可以使用适当的缩进来使之工作。

List of Items

*   One
*   Two

    .. only:: internal

        * Two and one-half (hidden)

*   Three

sphinx-build -b html . _build

sphinx-build -b html -t internal . _build

<< img src =“ https://image.soinside.com/eyJ1cmwiOiAiaHR0cHM6Ly9pLnN0YWNrLmltZ3VyLmNvbS9weGNYUS5wbmcifQ==” alt =“在此处输入图像描述”>“ >>

此外，如果您不希望“二分之一（隐藏）”成为嵌套列表的成员，但又成为其父列表的成员，则可以使其和它的only指令脱钩。