我已经开始了一个关于阅读文档的文档项目,从GitHub仓库构建。我将其设置为Sphinx项目,并在内容中使用Markdown。这样做的主要原因是利用GitHub的Markdown预览,这很棒。
我在文档中有jpg图像,这些图像是从它们驻留在GitHub上的URL中提取的。我刚刚测试了PDF下载,并注意到下载中没有包含任何图像。有可能发生这种情况吗?我需要以不同的方式进行设置吗?
我已经阅读了阅读文档文档(有趣的短语)并查看了github问题,但没有看到任何直接解决这个问题...
答案 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!!")