Как я могу добавить внешний файл 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:

Answer 2

Вы пытались .. literalinclude:: имя файла?

Вот небольшой пример:

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