Python sphinx RST条件指令don';不能使用标准语法
我在makefile中定义了一个条件标记,因此我可以使用唯一的指令有条件地删除文本块 生成文件条目: 。。。 set BUILDDIR=\u build 斯芬克斯建筑-t内部 我有一行信息,需要为特定的文档构建使其消失。以下是一个例子:Python sphinx RST条件指令don';不能使用标准语法,python-sphinx,restructuredtext,Python Sphinx,Restructuredtext,我在makefile中定义了一个条件标记,因此我可以使用唯一的指令有条件地删除文本块 生成文件条目: 。。。 set BUILDDIR=\u build 斯芬克斯建筑-t内部 我有一行信息,需要为特定的文档构建使其消失。以下是一个例子: 概述: 工作区:“xxx” .. 仅限::内部 xt团队名称:“phoenix”#用于xt Grok-否则排除此行** “internal”指令起作用,但它清除了单行文本之后的所有内容,我不想在这个构建中清除这些内容。在排除的文本行之后,我没有空格键字符或制
概述:
工作区:“xxx”
.. 仅限::内部
xt团队名称:“phoenix”#用于xt Grok-否则排除此行**
“internal”指令起作用,但它清除了单行文本之后的所有内容,我不想在这个构建中清除这些内容。在排除的文本行之后,我没有空格键字符或制表符-只有一条空行。我以为换行符会结束条件运算
让它只在一块上工作的诀窍是什么?不能移动任何东西-它会破坏前面和后面缩进部分信息的逻辑。调整示例以使其更清晰。空白在reStructuredText中有意义 在
only
指令下缩进要为内部
隐藏的内容
不要缩进要显示的内容
general:
workspace: "xxx"
...
.. only:: internal
xt-team-name: "phoenix" # for use with XT Grok - exclude this line otherwise **
<following body of information>
sphinx build-bhtml_构建
sphinx build-bhtml-t internal_构建
另外,如果您不希望“Two-and-half(hidden)”成为嵌套列表的成员,而是其父列表的成员,那么您可以删除它及其
only
指令。您介意澄清以下内容吗?在我看来,目标是有3个部分在同一级别缩进,第二部分是可选的,对吗?完成。这是一个较长的缩进项目列表的一部分。我仍然不确定你想要什么。如果您基本上显示了两个要合并为一个的RST代码,则会更好。这是一个列表,还是块引号,或者应该是什么?@RichardGrace如果答案解决了你的问题,你应该点击答案左侧的绿色复选标记接受它。谢谢!不幸的是,该行是一个长得多的缩进列表的一部分。所以这不是一个解决方案。我会调整我的例子,使之更加清晰。你的例子再清楚不过了。是否要有条件地隐藏
?如果是,则缩进。如果没有,就不要缩进。如果它也是缩进的,它就不起作用了。请记住,我在一个较大的列表中间排除了单个列表项。整个列表缩进。不缩进也不是一个选项。需要保持以下内容的完整性。您有段落,而不是项目列表。如果适当缩进,仍然可以在列表中使用条件句。我将用另一个例子更新我的答案。史蒂夫·皮尔西谢谢!!:)还是很难让它正常工作。缩进组合不起作用。在这种情况下,我只使用一个缩进列表,因为如果我能让它工作的话,这个概念应该应用到多层列表上,只需要在所有的板上应用另一个缩进。我感谢你的帮助。自从CP/M时代以来,还没有一个出版平台给我带来这么多的困难来完成简单的任务。我也会竖起大拇指,但StackOverflow不允许我这么做。也无法嵌入图像,这可能会有所帮助。
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