Якщо ви генеруєте HTML‑звіти, рахунки або портальні сторінки і вам потрібні PDF у великих кількостях, ключовою вимогою є повторюваний результат на різних машинах. У цьому покроковому посібнику показано, як пакетно конвертувати кілька HTML‑файлів у PDF за допомогою Python, використовуючи Aspose.HTML for Python via .NET. Ви створите конвертер, що працює з папками, а потім розширите його для сторінок з великою кількістю SVG та вбудованих шрифтів для послідовного рендерингу.

Навіщо використовувати Aspose.HTML для пакетного перетворення HTML у PDF?

Aspose.HTML for .NET — це API для рендерингу документів, яке може завантажувати HTML‑вміст з файлів або URL‑адрес і експортувати його у PDF з тонким контролем параметрів рендерингу. Для сценаріїв пакетного перетворення ключові переваги такі:

  • Надійне відображення без автоматизації браузера
  • Контроль над параметрами PDF, такими як розмір сторінки, поля та рендеринг фону
  • Передбачуване виконання у серверних середовищах
  • Можливість стандартизації шрифтів та ресурсів у багатьох конвертаціях

Пакетне перетворення кількох HTML‑файлів у PDF за допомогою Python — крок за кроком

Крок 1: Налаштуйте своє середовище

Вам потрібен Python та середовище виконання .NET, яке відповідає вашому середовищу розгортання. Якщо ви плануєте виконувати конвертації на сервері, встановіть там той самий runtime.

Встановити Aspose.HTML for Python via .NET

Запуск:

pip install aspose-html-net

Якщо ви використовуєте віртуальне середовище:

python -m venv .venv
.venv\Scripts\activate
pip install aspose-html-net

Крок 2: Створіть вхідні та вихідні папки (необов’язково)

Створіть дві папки у каталозі вашого проєкту:

  • input_html для HTML‑файлів та ресурсів
  • output_pdf для створених PDF‑файлів

Рекомендована структура для надійного розв’язання ресурсів:

  • input_html

  • report1.html

    • report2.html
    • styles

  • site.css

    • images

  • logo.png

    • шрифти

  • Inter Regular.ttf

Тримайте CSS, зображення та шрифти в одному корені, щоб відносні шляхи працювали послідовно.

Крок 3: Напишіть скрипт пакетного перетворення

Цей скрипт сканує вхідну папку, знаходить файли .html та .htm і конвертує кожен файл у PDF з тим же відносним шляхом у папці виводу. Він також записує успішні та невдалі операції для кожного файлу.

Приклад коду: пакетне перетворення папки HTML‑файлів у PDF.

Цей розділ реалізує основний шаблон пакетної обробки, який використовується в корпоративній автоматизації. Він перебирає HTML‑файли, створює детерміновані шляхи виводу, конвертує кожен документ і повертає підсумковий звіт, який ви можете зберігати для моніторингу та повторних запусків.

Виконайте наведені нижче кроки:

  1. Встановіть вхідну та вихідну папки.
  2. Перерахуйте всі HTML-файли.
  3. Завантажте кожен HTML-документ.
  4. Перетворіть кожен документ у PDF.
  5. Збережіть PDF-файли з детермінованими іменами.

Цей приклад коду демонструє, як конвертувати колекцію HTML‑файлів у PDF за допомогою Aspose.HTML for Python via .NET.

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (input, output тощо), щоб вони відповідали фактичним розташуванням ваших файлів, перевірте, що усі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь‑якими проблемами, будь ласка, зверніться до документації або зв’яжіться з командою підтримки для отримання допомоги.

Крок 4: Запустіть конвертер і перевірте результат

Запустити:

python batch_html_to_pdf.py

Перевірити:

  • PDF‑файли створюються у output
  • Структура папок відповідає input
  • Макет відповідає очікуванням
  • CSS та зображення відображаються правильно

Якщо CSS відсутній, перейдіть до розділу Fix Missing CSS, Images, and Broken Relative Paths, оскільки це майже завжди проблема шляху або пакування ресурсів.

Забезпечте послідовність відображення шрифтів шляхом вбудовування шрифтів

Якщо ви генеруєте рахунки-фактури або документи відповідності, заміна шрифтів може змінювати розриви рядків та пагінацію. Найбільш надійним рішенням є постачання шрифтів разом із вашими шаблонами та їх завантаження за допомогою CSS.

Приклад коду: Перетворення HTML у PDF з вбудованими шрифтами

Цей розділ зосереджений на пакуванні шаблонів. Код конвертації залишається незмінним. Ви вбудовуєте шрифти, використовуючи CSS @font-face з відносними шляхами.

Виконайте наведені нижче кроки:

  1. Розмістіть потрібні шрифти у доступній папці.
  2. Посилайтеся на шрифти через CSS, використовуючи правила @font-face.
  3. Переконайтеся, що HTML завантажує CSS і шрифти за допомогою відносних шляхів.
  4. Перетворіть HTML у PDF і перевірте відображення шрифтів.

Структура папки:

  • input_html

  • invoice.html

    • styles

  • invoice.css

    • fonts

  • Inter Regular.ttf

    • Inter Bold.ttf

Зразок CSS:

@font-face {
  font-family: "Inter";
  src: url("../fonts/Inter Regular.ttf") format("truetype");
  font-weight: 400;
  font-style: normal;
}

@font-face {
  font-family: "Inter";
  src: url("../fonts/Inter Bold.ttf") format("truetype");
  font-weight: 700;
  font-style: normal;
}

body {
  font-family: "Inter", Arial, sans-serif;
}

Запустіть ваш пакетний скрипт ще раз і перевірте:

  • PDF використовує потрібний шрифт.
  • Інтервали та пагінація відповідають очікуваному макету.

Виправити відсутні CSS, зображення та пошкоджені відносні шляхи

Якщо ваш PDF‑вивід виглядає без стилів або відсутні зображення, скористайтеся цим контрольним списком:

  1. Переконайтеся, що всі посилання на ресурси в HTML є відносними щодо розташування файлу HTML.
  2. Зберігайте шаблони та ресурси в одній кореневій папці, наприклад input.
  3. Уникайте абсолютних шляхів, які існують лише на вашому комп’ютері.
  4. Уникайте ресурсів, які надаються за URL‑адресами, недоступними для сервера.

Швидкий тест — відкрити HTML‑файл локально та переконатися, що він завантажує CSS і зображення з тієї ж структури папок, яку ви відправляєте у продакшн.

Висновок

Тепер у вас є повний покроковий підхід до пакетного перетворення кількох HTML‑файлів у PDF за допомогою Aspose.HTML у Python via .NET. Автоматизація пакетного перетворення кількох HTML‑файлів у PDF спрощує створення документів для корпоративних систем. Встановивши SDK, підготувавши чіткий список джерел, налаштувавши параметри PDF для вбудованих шрифтів та збереження SVG, а також обробляючи помилки коректно, ви можете створити надійний конвеєр конвертації, який масштабується до тисяч сторінок. Події прогресу SDK та багатий API спрощують моніторинг тривалих завдань і забезпечують постійну якість вихідних даних.

Для використання у продакшн ви можете придбати ліцензію, відвідавши сторінку цін. Альтернативно, ви можете запросити тимчасову ліцензію для цілей оцінки. Досліджуйте більше навчальних матеріалів у блоґу Aspose.HTML та приєднуйтесь до спільноти на форумі для додаткової підтримки.

Питання та відповіді

1. Чи можу я пакетно конвертувати файли HTML і HTM за один запуск?

Так. У вашому пакетному скрипті включіть обидва розширення .html і .htm під час сканування вхідної папки, потім конвертуйте кожен файл у PDF і збережіть ту ж саму відносну структуру вихідних даних.

2. Чому у моєму PDF відсутнє CSS-оформлення або зображення?

Зазвичай це трапляється, коли відносні шляхи не розв’язуються у середовищі конвертації. Тримайте CSS, зображення та шрифти в одному кореневому каталозі input, використовуйте відносні шляхи в HTML та CSS і уникайте машинно‑специфічних абсолютних шляхів.

3. Як забезпечити послідовність виводу PDF на різних серверах?

Об’єднайте необхідні шрифти з вашими шаблонами та посилайтеся на них за допомогою правил CSS @font-face. Також зберігайте всі ресурси локально та з версіями, щоб конвертер завжди бачив однакові HTML, CSS, зображення та шрифти в будь‑якому середовищі.

4. Чи зберігає Aspose.HTML якість SVG у згенерованому PDF?

Так. Вбудовані елементи SVG, як правило, відображаються як векторний контент у PDF. Після конвертації збільшіть масштаб діаграм і значків, щоб переконатися, що краї залишаються чіткими, а текст у SVG використовує очікувані шрифти.

5. Як обробляти помилки під час конвертації сотень або тисяч файлів?

Обробляйте файли незалежно, ловіть виключення для кожного файлу та створюйте підсумковий звіт, у якому перераховані успішні та невдалі елементи. Це дозволяє повторно запускати лише невдалі файли, замість повторення всього пакету.

Читати далі