Использование reStructuredText для включения файла, который также содержит директиву изображения

Question

Это расширение этого вопроса. Я хочу include (не буквально включить) раздел из другого файла reST, который содержит директиву изображения. Ниже приведен пример того, что я пытаюсь сделать.

Файл с директивой включения (summary.rst):

Weekly Summary
--------------

These are Monday's notes::

  .. include:: ./notes/weekly_notes.rst
      :start-after: begin-monday
      :end-before: end-monday

Файл для включения (./notes/weekly_notes.rst):

.. begin-monday

Meeting Notes from Monday
+++++++++++++++++++++++++

... some text ...

.. image:: image.png

.. end-monday

В настоящее время включение работает нормально , за исключением , изображение НЕ отображается в summary.rst . Он отображается правильно в weekly_notes.rst. Это очевидно, потому что относительное расположение не совпадает для двух файлов.

Есть ли способ обойти это, чтобы изображение отображалось в обоих местах ??

Спасибо.

Answer 1

Проблема в пути к изображению. Я предполагаю, что image.png находится в той же папке, что и weekly_notes.rst

Docutils (или, скорее всего, писатель, которого вы используете) вместо этого пытается найти изображение в папке summary.rst.

Если вы только используете включенный weekly_notes.rst, то вы должны использовать ./notes/image.png в качестве пути к изображению.