Sphinx 文字中的 Deindent 块包含指令

Question

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

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

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

生产

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

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

Answer 1

literalinclude有一个dedent选项：

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

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