我正在尝试将Sphinx的literalinclude
与代码示例一起使用,并希望同时使用start-after
和lines
。但是,我得到的只是一条空行。这是一个错误吗?如果没有,我该怎么做呢?
index.rst
,主要文档文件:
Behold this example code:
.. literalinclude:: example.py
:start-after: blobfish
:lines: 1
example.py
,要包含的示例:
# blobfish
this = line is an_example
this = line is another_example
conf.py
,因为Sphinx需要一个:
source_suffix = '.rst'
master_doc = 'index'
我通过在包含上述文件的文件夹中调用sphinx-build . out
进行编译。没有错误消息。
在输出中,我希望看到介绍性句子后跟this = line is an_example
。但是,而不是后者我只得到一个空行。如果我将:lines:
更改为:emphasize-lines:
,则所有内容都按预期工作:相关的行会突出显示,另一行会另外打印。