Вывод Sphinx PDF плох. Как мне найти причину?
Мой ввод Sphinx - это шесть первых файлов и куча PNG и JPG. Sphinx генерирует правильный HTML, но когда я создаю pdf, я получаю выходной файл, который отображается пустым в Adobe Reader (и превышает 5000%!) И не отображается вообще в Windows Explorer.
Проблема исчезнет, если я удалю различные входные файлы или отредактирую то, что выглядит как абсолютно безвредные разделы ввода, но я не могу разобраться с конкретной причиной. Любые идеи о том, как отследить это? Запуск сборки Sphinx с параметром -v не показывает ошибок.
Я использую последний Sphinx (1.2.3) и последний rst2pdf (0.93) со стилем по умолчанию. На Win7.
(добавлено) Это может помочь другим с той же проблемой: я попытался объединить первые файлы, затем запустил rst2pdf для объединенного файла. Это сработало, хотя и дало мне кучу предупреждений о неправильной иерархии разделов и не смогло обработать Sphinx:ref: stuff. Может ли плохая иерархия разделов (то есть ==, -, ~~ в одном файле, ==, ~~, - в другом) быть связана с безнадежными PDF-файлами? Устранение конфликта не решает проблему, но это не значит, что это не ключ!
Я мог бы исследовать больше, если бы мог захватить вывод, который Сфинкс отправляет в rst2pdf.
1 ответ
У нас была похожая проблема: плохой вывод PDF на проект с большим количеством глав и изображений. Мы решили отключить страницу разрыва: в файле conf.py установите значение pdf_break_level на 0.