阅读文档PDF不包含图像

时间:2017-10-26 17:05:03

标签: read-the-docs

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

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

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

1 个答案:

答案 0 :(得分:0)

原来,问题是使用http引用到上传到github的图像。当我这样做时,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!!")