如何同时使用:start-after:和:lines:,with literalinclude?

时间:2017-02-09 16:56:35

标签: python-sphinx

我正在尝试将Sphinx的literalinclude与代码示例一起使用,并希望同时使用start-afterlines。但是,我得到的只是一条空行。这是一个错误吗?如果没有,我该怎么做呢?

最小的非工作示例

  • 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:,则所有内容都按预期工作:相关的行会突出显示,另一行会另外打印。

0 个答案:

没有答案