如何将外部 Python 文件添加到重构的文本文档中？

Question

我想使用 Sphinx 和重组文本写一本书。由于大部分内容都是用 Python 编写的解决方案，我想将文本和代码分开。

是否有命令可以将外部 python 脚本添加到我的重组文本文档中？

我尝试使用

.. code-block:: python
    .. include:: unittest_exp1.py

和

.. code-block:: python
    .. file:: unittest_exp1.py

Answer 1

使用literalinclude，如 Sphinx 文档中所示。

.. literalinclude:: example.py
   :language: python
   :emphasize-lines: 12,15-18
   :linenos: