Question

我的项目有以下sphinx目录结构。

/applications
  /app1   
    Content.rst
  /app2
    Content.rst
/components
  /component1
    Content.rst
    /figures
       Figure1.png 
  /component2
    Content.rst
    /figures
      Figure1.png

对于每个可重复使用的UI软件组件，我有一个单独的目录，包括图中UI的一些屏幕截图。每个组件都有一些数字，通过使用相对路径的图像指令，可以使目录轻松移动和重新命名。

此外，我有最终用户客户的应用程序。但并非每个应用程序都使用每个组件。

现在发生了相对和绝对路径的问题。假设applications/app1/Content.rst包含某个地方：

.. include:: components/component1/Content.rst

此外假设components/component1/Content.rst包含某个地方：

.. image:: figures/Figure1.png

现在找到component1的文件第一个文件包含在我的文档中，但是component1的图像不包含在文档中。

Python Sphinx打印：

WARNING: image file not readable: figures/Figure1.png

这里的相对路径似乎存在问题，经过几个小时我无法解决。在处理components/component1/Content.rst时，我甚至还想知道目前的工作目录是什么。

如果可能的话，我还想避免组件的Content.rst中的绝对路径。

我非常感谢您对我的问题的任何帮助。

查看

如果我将图像行更改为：

.. image:: components/component1/figures/Figure1.png

显示图像，但是如果我需要移动或重命名我的组件，现在我遇到了严重的问题。

但现在我还有另一个问题：如果有人想通过components/component1/Content.rst命令在index.rst中加入toctree::。然后查看图像components/component1/components/component1/figures/Figure1.png，这又错了。

使用include伪指令发出相对路径和绝对路径

0 个答案: