Sphinx PDF输出很糟糕。我该如何追逐原因?

时间:2014-09-14 22:39:56

标签: pdf python-sphinx rst2pdf

我的Sphinx输入是六个第一个文件和一堆PNG和JPG。 Sphinx生成正确的HTML,但是当我 make pdf 时,我得到的输出文件在Adobe Reader中显示为空白(并且出现超过5000%!)并且在Windows资源管理器中根本不显示。

如果我删除各种输入文件或者如果我编辑出看起来完全无关紧要的输入部分,问题就会消失,但我无法处理具体原因。关于如何跟踪这个的任何想法?使用-v选项运行Sphinx构建时不会显示错误。

我正在使用最新的Sphinx(1.2.3)和最新的rst2pdf(0.93),默认样式。在Win7上。

(已添加)这可能会帮助其他人遇到同样的问题:我尝试连接第一个文件,然后在连接文件上运行rst2pdf。这有用,虽然它给了我一些关于坏部分层次结构的警告,并且无法处理Sphinx:ref:stuff。坏分区层次结构(即==, - ,~~在一个文件中,==,~~, - 在另一个文件中)可以连接到绝望的PDF吗?消除冲突并不能解决问题,但这并不意味着它不是一个线索!

如果能捕获Sphinx发送给rst2pdf的输出,我可以探索更多。

1 个答案:

答案 0 :(得分:0)

我们遇到了类似的问题:项目中的pdf输出很糟糕,有很多章节和图片。 我们解决了禁用中断页面的问题:在conf.py中,将 pdf_break_level 值设置为0.