Eğer HTML raporları, faturalar veya portal sayfaları oluşturuyorsanız ve toplu olarak PDF’lere ihtiyacınız varsa, temel gereksinim makineler arasında tekrarlanabilir çıktıdır. Bu adım adım kılavuz, Aspose.HTML for Python via .NET kullanarak Python’da birden fazla HTML dosyasını PDF’ye toplu olarak nasıl dönüştüreceğinizi gösterir. Klasör tabanlı bir dönüştürücü oluşturacak, ardından tutarlı render için SVG ağırlıklı sayfalara ve gömülü fontlara genişleteceksiniz.

Neden Aspose.HTML’i HTML’den PDF’ye Toplu Dönüştürme İçin Kullanmalısınız?

Aspose.HTML for .NET, dosyalardan veya URL’lerden HTML içeriği yükleyebilen ve render seçenekleri üzerinde ince kontrol sağlayarak PDF’ye dışa aktarabilen bir belge renderleme API’sidir. Toplu dönüşüm senaryoları için temel faydalar şunlardır:

  • Tarayıcı otomasyonu olmadan güvenilir renderleme
  • Sayfa boyutu, kenar boşlukları ve arka plan renderleme gibi PDF seçenekleri üzerinde kontrol
  • Sunucu ortamlarında öngörülebilir yürütme
  • Birçok dönüşümde yazı tiplerini ve kaynakları standartlaştırma yeteneği

Birden Çok HTML Dosyasını Python’da PDF’ye Toplu Dönüştürme — Adım Adım

Adım 1: Ortamınızı Kurun

Python ve dağıtım ortamınıza uygun bir .NET çalışma zamanına ihtiyacınız var. Dönüşümleri bir sunucuda çalıştırmayı planlıyorsanız, aynı çalışma zamanını oraya da kurun.

Yükle Aspose.HTML for Python via .NET

Çalıştır:

pip install aspose-html-net

Sanal bir ortam kullanıyorsanız:

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

Adım 2: Giriş ve Çıkış Klasörlerini Oluşturun (İsteğe Bağlı)

Proje dizininizde iki klasör oluşturun:

  • input_html HTML dosyaları ve varlıklar için
  • output_pdf oluşturulan PDF’ler için

Güvenilir varlık çözümlemesi için önerilen yapı:

  • input_html

  • report1.html

    • report2.html
    • styles

  • site.css

    • images

  • logo.png

    • fonts

  • Inter Regular.ttf

CSS, resimleri ve yazı tiplerini aynı kök içinde tutun, böylece göreceli yollar tutarlı bir şekilde çalışır.

Adım 3: Toplu Dönüştürme Betiğini Yazın

Bu betik, giriş klasörünü tarar, .html ve .htm dosyalarını bulur ve her dosyayı çıktı klasörünün altında aynı göreli yol ile bir PDF’ye dönüştürür. Ayrıca her dosya için başarı ve başarısızlıkları kaydeder.

Kod örneği: Bir klasördeki HTML dosyalarını PDF’ye toplu dönüştürme.

Bu bölüm, kurumsal otomasyonda kullanılan birincil toplu iş desenini uygular. HTML dosyalarını enumerate eder, belirli çıktı yolları oluşturur, her belgeyi dönüştürür ve izleme ve yeniden çalıştırmalar için saklayabileceğiniz bir özet rapor döndürür.

Aşağıdaki adımları izleyin:

  1. Giriş ve çıkış klasörlerini ayarlayın.
  2. Tüm HTML dosyalarını listeleyin.
  3. Her HTML belgesini yükleyin.
  4. Her belgeyi PDF’ye dönüştürün.
  5. PDF’leri belirli adlarla kaydedin.

Bu kod örneği, Aspose.HTML for Python via .NET kullanarak bir HTML dosyası koleksiyonunu PDF’ye dönüştürmenin nasıl yapılacağını gösterir.

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input, output, vb.) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen belgelere bakın veya destek ekibi ile iletişime geçin.

Adım 4: Dönüştürücüyü çalıştırın ve çıktıyı doğrulayın

Çalıştır:

python batch_html_to_pdf.py

Doğrula:

  • PDF’ler output altında oluşturulur
  • Klasör yapısı input ile aynı
  • Düzen beklentileri karşılıyor
  • CSS ve görseller doğru şekilde görünüyor

CSS eksikse, neredeyse her zaman bir yol veya varlık paketleme sorunu olduğu için Fix Missing CSS, Images, and Broken Relative Paths bölümüne atlayın.

Yazı Tipi İşleme Tutarlılığını Fontları Gömerek Sağlayın

Faturalar veya uyumluluk belgeleri oluşturuyorsanız, yazı tipi ikamesi satır sonlarını ve sayfalama düzenini değiştirebilir. En güvenilir çözüm, şablonlarınızla birlikte yazı tiplerini gönderip CSS ile yüklemektir.

Kod örneği: Gömülü yazı tipleriyle HTML’yi PDF’ye dönüştürme

Bu bölüm şablon paketlemeye odaklanır. Dönüştürme kodu aynı kalır. Yazı tiplerini, göreceli yollarla CSS @font-face kullanarak gömebilirsiniz.

Aşağıdaki adımları izleyin:

  1. Gerekli yazı tiplerini erişilebilir bir klasöre yerleştirin.
  2. Yazı tiplerini CSS içinde font‑face kurallarıyla referans verin.
  3. HTML’nin CSS ve yazı tiplerini göreceli yollarla yüklediğinden emin olun.
  4. HTML’yi PDF’ye dönüştürün ve yazı tipi görünümünü doğrulayın.

Klasör yapısı:

  • input_html

  • invoice.html

    • styles

  • invoice.css

    • fontlar

  • Inter Regular.ttf

    • Inter Bold.ttf

CSS örneği:

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

Batch betiğinizi tekrar çalıştırın ve doğrulayın:

  • PDF, istenen yazı tipini kullanır.
  • Boşluk ve sayfalama, beklediğiniz düzenle eşleşir.

Eksik CSS, Görseller ve Bozuk Göreceli Yolları Düzelt

PDF çıktınız biçimsiz görünüyor veya resimler eksikse, bu kontrol listesini kullanın:

  1. Tüm varlık referanslarının HTML içinde HTML dosyasının konumuna göre göreceli olduğundan emin olun.
  2. Şablonları ve varlıkları tek bir kök klasör altında tutun, örneğin input.
  3. Yalnızca sizin makinenizde bulunan mutlak yolları kullanmaktan kaçının.
  4. Sunucunun erişemediği URL’ler üzerinden sunulan varlıklardan kaçının.

Hızlı bir test, HTML dosyasını yerel olarak açıp, CSS ve resimlerin üretime gönderdiğiniz aynı klasör yapısından yüklendiğini doğrulamaktır.

Sonuç

Artık Aspose.HTML in Python via .NET ile birden çok HTML dosyasını PDF’ye toplu olarak dönüştürmek için eksiksiz bir adım‑adım yaklaşımına sahipsiniz. Birden çok HTML dosyasını PDF’ye toplu dönüştürmeyi otomatikleştirmek, kurumsal sistemler için belge oluşturmayı kolaylaştırır. SDK’yı kurarak, net bir kaynak listesi hazırlayarak, gömülü yazı tipleri ve SVG koruması için PDF seçeneklerini yapılandırarak ve hataları nazikçe ele alarak, binlerce sayfaya ölçeklenebilen güvenilir bir dönüşüm hattı oluşturabilirsiniz. SDK’nın ilerleme olayları ve zengin API’si, uzun süren işleri izlemeyi ve tutarlı çıktı kalitesini sağlamayı kolaylaştırır.

Üretim kullanımı için, fiyatlandırma sayfasını ziyaret ederek bir lisans satın alabilirsiniz. Alternatif olarak, değerlendirme amaçları için bir geçici lisans talep edebilirsiniz. Daha fazla öğreticiye Aspose.HTML blog üzerinden göz atabilir ve ek destek için forumlarda topluluğa katılabilirsiniz.

SSS

1. HTML ve HTM dosyalarını tek bir çalıştırmada toplu olarak dönüştürebilir miyim?

Evet. Batch betiğinizde, giriş klasörünü tararken hem .html hem de .htm uzantılarını dahil edin, ardından her dosyayı PDF’ye dönüştürün ve aynı göreli çıktı yapısını koruyun.

2. PDF’imde CSS stilleri veya resimler neden eksik?

Bu genellikle göreceli yolların dönüşüm ortamında çözümlenemediği durumlarda olur. CSS, resimleri ve yazı tiplerini aynı input kökünün altında tutun, HTML ve CSS içinde göreceli yollar kullanın ve makineye özgü mutlak yolları kullanmaktan kaçının.

3. Sunucular arasında PDF çıktısını tutarlı nasıl yaparım?

Gerekli yazı tiplerini şablonlarınızla birlikte paketleyin ve CSS font‑face kurallarını kullanarak başvurun. Ayrıca tüm varlıkları yerel ve sürümlü tutun, böylece dönüştürücü her ortamda aynı HTML, CSS, görüntü ve yazı tiplerini görür.

4. Aspose.HTML, oluşturulan PDF’de SVG kalitesini korur mu?

Evet. Satır içi SVG öğeleri genellikle PDF’de vektör içeriği olarak işlenir. Dönüştürmeden sonra, kenarların keskin kalmasını ve SVG içindeki metnin beklenen yazı tiplerini kullandığını doğrulamak için grafiklere ve simgelere yakınlaştırın.

5. Yüzlerce veya binlerce dosyayı dönüştürürken hatalarla nasıl başa çıkabilirim?

Dosyaları bağımsız olarak işleyin, her dosya için istisnaları yakalayın ve başarılı ve başarısız öğeleri listeleyen bir özet raporu yazın. Bu, tüm toplu işlemi tekrarlamak yerine yalnızca başarısız dosyaları yeniden çalıştırmanıza olanak tanır.

Devamını Oku