WeasyPrint - инструмент для создания PDF-файлов из HTML и CSS. Он пригодится, если нужно сохранить страницу сайта, подготовить документ к печати или автоматически формировать отчёты.
Программа работает без браузера и учитывает стили оформления, поэтому помогает получать аккуратно свёрстанные PDF на основе веб-разметки.
Что такое WeasyPrint и как его установить
WeasyPrint бесплатный инструмент с открытым исходным кодом. В отличие от обычной функции "Печать в PDF" в браузере, он рассчитан на использование в проектах и скриптах: документ можно создавать автоматически, без ручного открытия веб-страницы.
Для работы программа обрабатывает HTML и CSS, а затем формирует файл в формате PDF. Скачать WeasyPrint можно с официального сайта проекта или со страницы программы на GitHub.
Там публикуются сведения о версиях, инструкции и варианты установки для разных операционных систем. Перед загрузкой стоит проверить системные требования и выбрать подходящий способ установки. Один из распространённых вариантов - установка через пакетный менеджер Python.
Для этого в терминале вводят команду `pip install weasyprint`. В зависимости от операционной системы и версии программы могут потребоваться дополнительные системные библиотеки.
Если установка завершается ошибкой, следует свериться с официальной документацией: в ней перечислены актуальные зависимости и способы их настройки.
После установки полезно убедиться, что WeasyPrint доступен из командной строки. Для этого можно запросить сведения о версии программы. Если команда распознаётся и выводит данные, инструмент готов к работе.
При возникновении проблем проверьте, правильно ли настроено окружение Python и установлены ли необходимые компоненты.
Какие файлы понадобятся
Для преобразования достаточно подготовить HTML-документ. В нём размещается содержимое страницы: заголовки, текст, таблицы, изображения и другие элементы.
Чтобы управлять внешним видом будущего PDF, к документу подключают CSS-стили - отдельным файлом или непосредственно внутри HTML. Перед конвертацией проверьте ссылки на таблицы стилей, шрифты и изображения.
Если ресурсы не найдены, часть оформления может пропасть, а картинки не появятся в итоговом файле.
Особенно важно убедиться, что корректно указаны пути к локальным файлам, если проект запускается из другого каталога.
Как создать PDF и настроить результат
Базовое преобразование выполняется одной командой. В терминале указывают исходный HTML-файл и имя PDF, который нужно создать. Например: `weasyprint page. html result. pdf`.
В этом случае программа прочитает содержимое `page. html` и сохранит готовый документ как `result. pdf`. Если HTML расположен в интернете, можно передать вместо имени файла адрес страницы.
Также WeasyPrint поддерживает запуск из Python-кода, что удобно для сайтов и приложений, где PDF формируется по запросу пользователя или на основе динамических данных.
Такой подход позволяет автоматизировать подготовку счетов, справок и других документов. Внешний вид страницы задаётся с помощью CSS.
Стили помогают изменить шрифты, цвета и отступы, а также подготовить макет к печати. Для многостраничных документов можно настроить параметры листа и поля, задать правила разбиения контента и определить, какие элементы следует повторять на каждой странице. Это особенно полезно для отчётов и документов с таблицами.
Перед сохранением готового PDF стоит проверить результат: не обрезаны ли заголовки, помещаются ли таблицы на страницах, правильно ли отображаются изображения и шрифты.
Если макет выглядит не так, как ожидалось, обычно достаточно поправить CSS или пути к ресурсам и повторить конвертацию.
WeasyPrint удобен тем, что позволяет выпускать PDF по готовой веб-разметке, не открывая браузер и не выполняя печать вручную. Освоив установку, базовую команду и правила оформления для печати, можно быстро создавать документы как для личных задач, так и для автоматизированных рабочих процессов.
