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:

Answer 2

这是一个小example：

.. literalinclude:: filename
    :linenos:
    :language: python
    :lines: 1, 7-8 
    :start-after: 12
    :end-before: 5