image - 文档 : missing images when using include directives (rst, 狮身人面像)

Question

我正在使用 rst/sphinx 生成文档，但引用文件中的图像有问题。
include指令可以很好地引入 rst 文件，但我没有从包含的文件中获取本身引用的图像。

我的结构是这样的:

   /documentation
        /master_doc
            /source
                pointer_file.rst  
                    and this file calls file.rst:
                    include:: ../../doc_a/source/file.rst
        /documents
             /doc_a
                  /source
                       /images
                            picture.jpg
                       file.rst
                             includes a figure ref:
                             .. figure:: images/picture.jpg

当我从 doc_a 构建时目录，我得到文本+图像。都好。
但是当我从 master_doc 构建时目录，其中 include指令进来，我只得到文本，而构建中缺少图像。

我怎样才能解决这个问题？我不想在两个目录中复制我的所有图像，这是目前似乎唯一可行的方法。

*** 编辑:由于下面建议的修复尚未起作用，因此向上面的项目结构添加了详细信息。

为了回应第一条评论中的建议，我尝试了以下所有方法，但都没有奏效:

.. figure:: /documentation/documents/doc_a/source/images/picture.jpg

和

.. figure:: /documents/doc_a/source/images/picture.jpg

和

.. figure:: /doc_a/source/images/picture.jpg

还有其他想法吗？

Answer 1

尝试将图像文件路径从相对更改为绝对。

.. figure:: /doc_a/source/images/picture.jpg

来自 reStructuredText Primer, Images :

When used within Sphinx, the file name given (here gnu.png) must either be relative to the source file, or absolute which means that they are relative to the top source directory. For example, the file sketch/spam.rst could refer to the image images/spam.png as ../images/spam.png or /images/spam.png.