在Sphinx ( ReStructuredText发布系统)中,是否有任何模糊的规则来限制文字块可以包含的内容?
背景:我的文档包含许多跟在双冒号段落后面的文字块,如下所示:
Background:... follow a double-colon paragraph, like this::
$ sudo su
# echo ttyS0,115200 > /sys/module/kgdboc/parameters/kgdboc
这个块(前面有不同的段落)是发出错误的块之一:“警告:不一致的文字块引用。”该消息指示错误在"echo“行中。在HTML输出中,文字块只包含"sudo“行;"echo”行被视为普通文本。
作为一个类,我不能在报告错误的行中识别任何公共属性,也不能识别它们与其他文字块中不会出错的行的区别。
发布于 2021-02-02 02:43:26
我简化了项目以隔离问题,并以这种方式确定了问题。
我有一个带编号的列表项,其中包含一个双冒号的文字块,该块仅缩进到列表项的文本,如下所示:
2. Set up the... directory::
$ A Linux command
$ Another Linux command
$ And ANOTHER Linux command
$ etc.
当我进一步缩进文字块时,问题就消失了。
我被两件事误导了:
隔离问题是一种暴力解决问题的方法,但当演绎失败时,通常是有效的。我以后会记住这一点的。
https://stackoverflow.com/questions/65925967
复制相似问题