Sphinx 文字中的 Deindent 块包含指令

Question

我在一个文件中有一段代码，我想将其包含在 Sphinx 文档的示例中，使用 literalinclude 指令。

但是该代码在一个函数中，所以当我包含它时，在示例中，每一行的缩进比我想要的多一级。

.. literalinclude:: ../../examples/example.py
   :language: python
   :lines: 13-42
   :tab-width: 0

生产

    import foo
    from foo import bar

    print("I'm indented too far")

还有其他方法可以删除或取消缩进文字块吗？

Answer 1

literalinclude 有一个dedent 选项：

.. literalinclude:: ../../examples/example.py
   :language: python
   :lines: 13-42
   :tab-width: 0
   :dedent: 4

literalinclude 文档的“其他选项”下提到了该选项，但详细信息在 the documentation for code-block 中。