python-2.7 - 狮身人面像 - 引用来自不同位置的图像
问题描述
我正在使用 Python Sphinx(通过ReadTheDocs)。
我有一个包含一些子模块的存储库,我正在尝试创建一个统一的文档,但仍然将文档资产单独保存在每个模块中。
我的文件夹层次结构是:
MyProject
docs
index.rst
module_1_link.rst
_static
<more irrelevant assets...>
module_1
docs
README.rst
_static
myimage.png
index.rst文件如下所示:
.. toctree::
:caption: Module1
module_1_link
文件module_1_link.rst只包含一个指向模块 1 的 README 文件的链接:
.. include:: ../module1/docs/README.rst
并且模块 1 的README.rst引用了图像:
.. image:: _static/myimage.jpg
当我查看模块 1(在 GitHub 内)的 README 文件时 - myimage.png 完美显示。
但是,当我通过 sphinx 运行文档时,我得到:
WARNING: image file not readable: _static/myimage.jpg
我找不到从 README 文件和 sphinx 呈现的索引文件中引用相同图像并在两个地方都看到它的方法。
解决方案
将对图像的引用更改README.rst
为相对于文档根目录。
.. image:: /module1/docs/_static/myimage.jpg
另请参阅有关图像路径的Sphinx 文档。
在 Sphinx 中使用时,给定的文件名(此处
gnu.png
)必须是相对于源文件的,或者是绝对的,这意味着它们是相对于顶级源目录的。例如,该文件sketch/spam.rst
可以将图像images/spam.png
称为../images/spam.png
或/images/spam.png
。
推荐阅读
- c# - 执行在数据集的 .xsd 中配置的存储过程
- google-api - cse 热门查询与谷歌搜索结果中的显示不完全相同
- python - 外部终端和VSCode之间的Python3不同
- c# - 下拉菜单在 View MVC 上不显示数据
- android - 如果 Glide 无法连接到远程服务器,Android 片段会从 drawable 中加载默认图像
- c - 交互式、限制性、动态的用户输入
- swift - 替换 Swift String 中的字符?
- javascript - 使用 SVG 弧线绘制部分圆
- verilog - 从参数名称实例化 Verilog 模块
- react-native - ReactNative 0.57 构建 IOS 无法读取未定义的属性“文件名”(空))