Jika Anda menghasilkan laporan HTML, faktur, atau halaman portal dan memerlukan PDF dalam jumlah besar, persyaratan utama adalah output yang dapat diulang di semua mesin. Panduan langkah demi langkah ini menunjukkan cara mengonversi secara batch beberapa file HTML ke PDF di Python menggunakan Aspose.HTML for Python via .NET. Anda akan membangun konverter berbasis folder, lalu memperluasnya ke halaman yang banyak mengandung SVG dan font yang disematkan untuk rendering yang konsisten.

Mengapa Menggunakan Aspose.HTML untuk Konversi Batch HTML ke PDF?

Aspose.HTML for .NET adalah API rendering dokumen yang dapat memuat konten HTML dari file atau URL dan mengekspor ke PDF dengan kontrol yang halus atas opsi rendering. Untuk skenario konversi batch, manfaat utama adalah

  • Rendering yang andal tanpa otomatisasi browser
  • Kontrol atas opsi PDF seperti ukuran halaman, margin, dan rendering latar belakang
  • Eksekusi yang dapat diprediksi di lingkungan server
  • Kemampuan untuk menstandarisasi font dan sumber daya di banyak konversi

Mengonversi Banyak File HTML ke PDF dalam Python — Langkah demi Langkah

Langkah 1: Siapkan Lingkungan Anda

Anda memerlukan Python dan runtime .NET yang cocok dengan lingkungan penyebaran Anda. Jika Anda berencana menjalankan konversi di server, instal runtime yang sama di sana juga.

Instal Aspose.HTML for Python via .NET

Jalankan:

pip install aspose-html-net

Jika Anda menggunakan lingkungan virtual:

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

Langkah 2: Buat Folder Input dan Output (Opsional)

Buat dua folder di direktori proyek Anda:

  • input_html untuk file HTML dan aset
  • output_pdf untuk PDF yang dihasilkan

Struktur yang direkomendasikan untuk resolusi aset yang dapat diandalkan:

  • input_html

  • report1.html

    • report2.html
    • styles

  • site.css

    • images

  • logo.png

    • fonts

  • Inter Regular.ttf

Letakkan CSS, gambar, dan font di dalam akar yang sama agar jalur relatif berfungsi secara konsisten.

Langkah 3: Tulis Skrip Konversi Batch

Script ini memindai folder input, menemukan file .html dan .htm, dan mengonversi setiap file menjadi PDF dengan jalur relatif yang sama di bawah folder output. Script ini juga mencatat keberhasilan dan kegagalan per file.

Contoh kode: Mengonversi batch folder berisi file HTML ke PDF.

Bagian ini mengimplementasikan pola batch utama yang digunakan dalam otomasi perusahaan. Ini mengenumerasi file HTML, membangun jalur output deterministik, mengonversi setiap dokumen, dan mengembalikan laporan ringkasan yang dapat Anda simpan untuk pemantauan dan menjalankan ulang.

Ikuti langkah-langkah di bawah ini:

  1. Atur folder input dan output.
  2. Enumerasi semua file HTML.
  3. Muat setiap dokumen HTML.
  4. Konversi setiap dokumen ke PDF.
  5. Simpan PDF dengan nama yang deterministik.

Contoh kode ini menunjukkan cara mengonversi sekumpulan file HTML menjadi PDF menggunakan Aspose.HTML for Python via .NET.

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input, output, dll.) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi atau hubungi tim dukungan untuk bantuan.

Langkah 4: Jalankan konverter dan verifikasi output

Jalankan:

python batch_html_to_pdf.py

Verifikasi:

  • PDF dibuat di output
  • Struktur folder mencerminkan input
  • Tata letak sesuai harapan
  • CSS dan gambar muncul dengan benar

Jika CSS tidak ada, lompat ke bagian Fix Missing CSS, Images, and Broken Relative Paths karena biasanya itu merupakan masalah jalur atau pengemasan aset.

Membuat Rendering Font Konsisten dengan Menyematkan Font

Jika Anda membuat faktur atau dokumen kepatuhan, substitusi font dapat mengubah pemenggalan baris dan penomoran halaman. Solusi paling andal adalah menyertakan font bersama templat Anda dan memuatnya menggunakan CSS.

Contoh kode: Mengonversi HTML ke PDF dengan font tertanam

Bagian ini berfokus pada pengemasan templat. Kode konversi tetap sama. Anda menyematkan font dengan menggunakan CSS @font-face dengan jalur relatif.

Ikuti langkah-langkah di bawah ini:

  1. Tempatkan font yang diperlukan di folder yang dapat diakses.
  2. Referensikan font melalui CSS menggunakan aturan @font-face.
  3. Pastikan HTML memuat CSS dan font melalui jalur relatif.
  4. Konversi HTML ke PDF dan verifikasi tampilan font.

Struktur folder:

  • input_html

  • invoice.html

    • styles

  • invoice.css

    • fonts

  • Inter Regular.ttf

    • Inter Bold.ttf

Contoh 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;
}

Jalankan skrip batch Anda lagi dan verifikasi:

  • PDF menggunakan font yang dimaksud.
  • Spasi dan penomoran halaman sesuai dengan tata letak yang Anda harapkan.

Perbaiki CSS yang Hilang, Gambar, dan Jalur Relatif yang Rusak

Jika output PDF Anda terlihat tidak berformat atau gambar tidak muncul, gunakan daftar periksa ini:

  1. Pastikan semua referensi aset dalam HTML bersifat relatif terhadap lokasi file HTML.
  2. Simpan templat dan aset di bawah satu folder root, seperti input.
  3. Hindari jalur absolut yang hanya ada di mesin Anda.
  4. Hindari aset yang disajikan melalui URL yang tidak dapat diakses oleh server.

Tes cepat adalah membuka file HTML secara lokal dan memastikan bahwa ia memuat CSS serta gambar dari struktur folder yang sama yang Anda kirim ke produksi.

Kesimpulan

Anda sekarang memiliki pendekatan langkah demi langkah yang lengkap untuk mengonversi secara batch banyak file HTML ke PDF dengan Aspose.HTML dalam Python via .NET. Mengotomatisasi konversi batch banyak file HTML ke PDF menyederhanakan pembuatan dokumen untuk sistem perusahaan. Dengan menginstal SDK, menyiapkan daftar sumber yang jelas, mengonfigurasi opsi PDF untuk font yang disematkan dan pelestarian SVG, serta menangani kesalahan dengan elegan, Anda dapat membangun pipeline konversi yang andal yang dapat menangani ribuan halaman. Peristiwa kemajuan SDK dan API yang kaya memudahkan pemantauan pekerjaan yang berjalan lama dan memastikan kualitas output yang konsisten.

Untuk penggunaan produksi, Anda dapat membeli lisensi dengan mengunjungi pricing page. Sebagai alternatif, Anda dapat meminta temporary license untuk tujuan evaluasi. Jelajahi lebih banyak tutorial di Aspose.HTML blog dan bergabung dengan komunitas di forums untuk dukungan tambahan.

FAQs

1. Bisakah saya mengonversi batch kedua file HTML dan HTM dalam satu kali proses?

Ya. Dalam skrip batch Anda, sertakan kedua ekstensi .html dan .htm saat memindai folder input, kemudian konversi setiap file ke PDF dan pertahankan struktur output relatif yang sama.

2. Mengapa PDF saya kehilangan styling CSS atau gambar?

Hal ini biasanya terjadi ketika jalur relatif tidak dapat diselesaikan di lingkungan konversi. Simpan CSS, gambar, dan font di bawah akar input yang sama, gunakan jalur relatif dalam HTML dan CSS, serta hindari jalur absolut yang spesifik mesin.

3. Bagaimana cara membuat output PDF konsisten di seluruh server?

Bundel font yang diperlukan dengan templat Anda dan referensikan mereka menggunakan aturan CSS font‑face. Juga, simpan semua aset secara lokal dan versi sehingga konverter selalu melihat HTML, CSS, gambar, dan font yang sama di setiap lingkungan.

4. Apakah Aspose.HTML mempertahankan kualitas SVG dalam PDF yang dihasilkan?

Ya. Elemen SVG inline umumnya dirender sebagai konten vektor dalam PDF. Setelah konversi, perbesar grafik dan ikon untuk memastikan tepi tetap tajam dan teks di dalam SVG menggunakan font yang diharapkan.

5. Bagaimana cara menangani kegagalan saat mengonversi ratusan atau ribuan file?

Proses file secara terpisah, tangkap pengecualian per file, dan tulis laporan ringkasan yang mencantumkan item yang berhasil dan yang gagal. Ini memungkinkan Anda menjalankan kembali hanya file yang gagal alih‑alih mengulangi seluruh batch.

Baca Selengkapnya