首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >问答首页 >Sphinx在文字块中出现神秘错误

Sphinx在文字块中出现神秘错误
EN

Stack Overflow用户
提问于 2021-01-28 03:22:32
回答 1查看 147关注 0票数 0

在Sphinx ( ReStructuredText发布系统)中,是否有任何模糊的规则来限制文字块可以包含的内容?

背景:我的文档包含许多跟在双冒号段落后面的文字块,如下所示:

代码语言:javascript
运行
复制
Background:... follow a double-colon paragraph, like this::

        $ sudo su
        # echo ttyS0,115200 > /sys/module/kgdboc/parameters/kgdboc

这个块(前面有不同的段落)是发出错误的块之一:“警告:不一致的文字块引用。”该消息指示错误在"echo“行中。在HTML输出中,文字块只包含"sudo“行;"echo”行被视为普通文本。

作为一个类,我不能在报告错误的行中识别任何公共属性,也不能识别它们与其他文字块中不会出错的行的区别。

EN

回答 1

Stack Overflow用户

发布于 2021-02-02 02:43:26

我简化了项目以隔离问题,并以这种方式确定了问题。

我有一个带编号的列表项,其中包含一个双冒号的文字块,该块仅缩进到列表项的文本,如下所示:

代码语言:javascript
运行
复制
2. Set up the... directory::

   $ A Linux command
   $ Another Linux command 
   $ And ANOTHER Linux command
   $ etc.

当我进一步缩进文字块时,问题就消失了。

我被两件事误导了:

  1. 消息并不指向文字块中的第一行,而是指向其中的某个明显随机的行。在上面的例子中,它指向块中的第五行(共八行)!

  1. 在大多数情况下,这种形式的缩进虽然不正确,但工作正常。

隔离问题是一种暴力解决问题的方法,但当演绎失败时,通常是有效的。我以后会记住这一点的。

票数 1
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/65925967

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档