我正在使用 rst/sphinx 生成文档,并且引用文件中的图像存在问题。
该include
指令可以很好地引入第一个文件,但我没有获得从包含的文件中引用的图像。
我的结构是这样的:
/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
Run Code Online (Sandbox Code Playgroud)
当我从目录构建时doc_a
,我得到文本+图像。都好。master_doc
但是,当我从指令所在的目录构建时include
,我只得到文本,构建中缺少图像。
我怎样才能解决这个问题?我不想在两个目录中复制所有图像,这是目前唯一可行的方法。
***编辑:在上面的项目结构中添加了详细信息,因为下面建议的修复尚未起作用。
我尝试了以下所有方法来回应第一条评论中的建议,但都不起作用:
.. figure:: /documentation/documents/doc_a/source/images/picture.jpg
Run Code Online (Sandbox Code Playgroud)
和
.. figure:: /documents/doc_a/source/images/picture.jpg
Run Code Online (Sandbox Code Playgroud)
和
.. figure:: /doc_a/source/images/picture.jpg
Run Code Online (Sandbox Code Playgroud)
还有其他想法吗?