#html #css #printing #python-sphinx
Вопрос:
У меня есть некоторая документация, в которой есть требование, которое должно быть доступно для печати. Для этого мы использовали целевые объекты sphinx latexpdf, но мы тратим много времени на то, чтобы возиться с параметрами latex и пытаться правильно форматировать, особенно с объектами таблиц. Гораздо проще поддерживать необходимые стили в CSS, и HTML отлично смотрится из коробки. Итак, я пытаюсь найти способ красиво распечатать файл singlehtml.
Я знаю, что есть способы сделать HTML-файл удобным для принтера, но я не могу заставить его работать со Сфинксом. Например, я попытался добавить разрыв страницы перед каждым заголовком 1-го уровня. Я добавил CSS для h1, но он не печатается с разрывом страницы.
Мне также нужно, чтобы верхние и нижние колонтитулы на каждой странице отображали определенные защитные знаки. Я знаю, что есть несколько методов для этого в HTML, между CSS и объектами таблицы, я могу заставить это работать в необработанном HTML-файле. Я просто пытаюсь заставить sphinx генерировать правильные html-объекты. Могу ли я поместить все содержимое sphinx в ячейку таблицы «тело»? (ссылка на «Окончательный» метод здесь: https://medium.com/@Idan_Co/the-ultimate-print-html-template-with-header-footer-568f415f6d2a)
Кто — нибудь смог изменить способ печати документации sphinx? Есть ли какие-либо примеры того, как выполнять операции, упомянутые выше, в Sphinx?
Спасибо.
Комментарии:
1. То, что вы получаете в терминах CSS/HTML, во многом зависит от используемой вами темы «Сфинкс «. Некоторые части в основном фиксируются Sphinx (например, создание некоторых целевых имен), но большинство зависит от темы. Мой совет для вас проблема будет заключаться в использовании простейшей возможной темы с минимальными параметрами, возможно, также отключив большинство параметров HTML .
2. Создав вторую документацию с вышеуказанными опциями, вы могли бы ссылаться на нее, используя соответствие 1:1 с каждой из ваших
.rstстраниц. Впоследствии применение стороннего программного обеспечения ко 2-й версии вашей документации должно дать что-то очень близкое к удобной для печати версии, что должно оставить вас с минимальным количеством изменений для настройки, если это необходимо.