阅读文档 PDF 不包含图像

Read the Docs PDF doesn't include images

我已经开始了一个关于阅读文档的文档项目,从 GitHub 存储库构建。我将其设置为 Sphinx 项目,并在内容中使用 Markdown。这样做的主要原因是利用了 GitHub 的 Markdown 预览,它很棒。

我在文档中有 jpg 图像,这些图像是从它们位于 GitHub 上的 url 中提取的。我刚刚测试了 PDF 下载,并注意到 none 的图像包含在下载中。有可能发生这种情况吗?我需要进行不同的设置吗?

我已经阅读了 read the docs docs(有趣的短语)并查看了 github 问题,但没有看到任何直接解决这个问题的内容...

原来问题出在对上传到 github 的图像使用 http 引用。当我这样做时,RTD PDF 不包含图像。

![hey dubuque library](https://github.com/legiongis/clitoolbox/raw/master/docs/img/dubuque_library.jpg "Hello Dubuque!!")

但是,将其更改为 markdown 文件的相对路径解决了问题。

![hey dubuque library](img/dubuque_library.jpg "Hello Dubuque!!")