2022 için PDF Görüntüleyici Araçları

Neden Puppeteer?

• Kullanım kolaylığı: Puppeteer, başsız tarayıcılarla çalışma karmaşıklıklarını gizleyen basit ve kullanımı kolay bir API sunar.
• Güçlü: Puppeteer, web sayfalarını manipüle etmek ve tarayıcı öğeleriyle etkileşim kurmak için geniş yetenekler sunar.
• Ölçeklenebilir: Puppeteer ile, birden fazla tarayıcı instance'ını paralel olarak çalıştırarak, PDF oluşturma sürecinizi kolayca ölçeklendirebilirsiniz.

Puppeteer ve fs'yi İçe Aktarma

const puppeteer = require('puppeteer');
const fs = require('fs');

Kod, Chrome ve Chromium gibi headless tarayıcıları kontrol etmek için çok yönlü bir araç olan puppeteer ve dosya sistemi işlemlerini yönetmek için yerleşik bir Node.js modülü olan fs'yu içe aktararak başlar. Puppeteer, HTML işlemi, ekran görüntüsü alma ve PDF dosyaları oluşturma gibi web tabanlı görevleri otomatikleştirmenizi sağlar.

exportWebsiteAsPdf Fonksiyonunu Tanımlama

async function exportWebsiteAsPdf(html, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Set the HTML content for the page, waiting for DOM content to load
  await page.setContent(html, { waitUntil: 'domcontentloaded' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

exportWebsiteAsPdf fonksiyonu, kod parçacığımızın merkezidir. Bu asenkron fonksiyon, bir html dizgisini ve bir outputPath'yi giriş parametreleri olarak kabul eder ve bir PDF dosyası döndürür. Fonksiyon aşağıdaki adımları gerçekleştirir:

1. Puppeteer kullanarak yeni bir başsız tarayıcı instansı başlatır.
2. Yeni bir tarayıcı sayfası oluşturur.
3. Sağlanan html dizgisini, sayfa içeriği olarak ayarlar ve DOM içeriğinin yüklenmesini bekler.
4. Ekran medya türünü benzeterek, ekranlar için kullanılan CSS'nin yerine yazdırma için özel stillerin uygulanmasını sağlar.
5. Yüklenen HTML içeriğinden bir PDF dosyası üretir, marjlar, arka plan baskısı ve format (A4) belirtilir.
6. Tarayıcı örneğini kapatır.
7. Oluşturulan PDF dosyasını döndürür.

exportWebsiteAsPdf Fonksiyonunu Kullanma

// Usage example
// Get HTML content from HTML file
const html = fs.readFileSync('test.html', 'utf-8');

// Convert the HTML content into a PDF and save it to the specified path
exportWebsiteAsPdf(html, 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

Kodun son bölümü exportWebsiteAsPdf fonksiyonunun nasıl kullanılacağını göstermektedir. Aşağıdaki adımları gerçekleştiriyoruz:

1. fs modülünün readFileSync metodunu kullanarak bir HTML dosyasından HTML içeriğini okuyun.
2. Yüklenen html dizgisi ve istenilen outputPath ile exportWebsiteAsPdf fonksiyonunu çağırın.
3. Başarılı bir PDF oluşturma işlemini yönetmek ve konsola bir başarı mesajı kaydetmek için bir .then bloğu kullanın.
4. HTML'den PDF'e dönüştürme işlemi sırasında oluşabilecek hataları yönetmek ve konsola bir hata mesajı kaydetmek için bir .catch bloğu kullanın.

Bu kod parçası, Node.js ve Puppeteer kullanarak bir HTML şablonunu PDF dosyasına dönüştürmenin kapsamlı bir örneğini sağlar. Bu çözümü uygulayarak, çeşitli uygulamalar ve kullanıcılar için yüksek kalitede PDF'ler üretilebilir.

Puppeteer'ı İçeri Aktarma

const puppeteer = require('puppeteer');

Kod, Chrome ve Chromium gibi başlıksız tarayıcıları kontrol etmek için güçlü bir araç olan Puppeteer kütüphanesini içeri aktararak başlar. Puppeteer, HTML kodunuzu görüntülemek, ekran görüntüleri almak ve bizim durumumuzda PDF dosyası üretmek gibi çeşitli web tabanlı görevleri otomatikleştirmenizi sağlar.

exportWebsiteAsPdf Fonksiyonunu Tanımlama

async function exportWebsiteAsPdf(websiteUrl, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Open the URL in the current page
  await page.goto(websiteUrl, { waitUntil: 'networkidle0' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

exportWebsiteAsPdf fonksiyonu, kod parçacığımızın merkezidir. Bu asenkron fonksiyon, bir websiteUrl ve bir outputPath'yı giriş parametreleri olarak kabul eder ve bir PDF dosyası döndürür. Fonksiyon aşağıdaki adımları gerçekleştirir:

1. Puppeteer kullanarak yeni bir başsız tarayıcı instansı başlatır.
2. Yeni bir tarayıcı sayfası oluşturur.
3. Sağlanan websiteUrl adresine gider ve ağı waitUntil seçeneği networkidle0 olarak ayarlandığında ağın boş duruma geçmesini bekler.
4. Ekran medya türünü benzeterek ekranlar için kullanılan CSS'nin yazdırma için özel stiller yerine uygulanmasını sağlar.
5. Yüklenen web sayfasını belirtilen marjlar, arka plan baskısı ve format (A4) ile bir PDF dosyasına dönüştürür.
6. Tarayıcı örneğini kapatır.
7. Oluşturulan PDF dosyasını döndürür.

exportWebsiteAsPdf Fonksiyonunu Kullanma

// Usage example
// Convert the URL content into a PDF and save it to the specified path
exportWebsiteAsPdf('https://ironpdf.com/', 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

Kodun son bölümü, exportWebsiteAsPdf fonksiyonunun nasıl kullanılacağını göstermektedir. Aşağıdaki adımları uyguluyoruz:

1. İstenen websiteUrl ve outputPath ile exportWebsiteAsPdf fonksiyonunu çağırın.
2. Başarılı bir PDF oluşturma işlemini yönetmek için bir then bloğu kullanın. Bu blokta, konsola bir başarı mesajı kaydediyoruz.
3. Web sitesinden PDF'e dönüştürme işlemi sırasında oluşabilecek hataları yönetmek için bir catch bloğu kullanın. Bir hata oluşursa, konsola bir hata mesajı kaydediyoruz.

Bu kod parçasını projelerinize entegre ederek Node.js ve Puppeteer kullanarak URL'leri yüksek kaliteli PDF dosyalarına kolayca dönüştürebilirsiniz.

IronPDF'nin Ana Özellikleri

IronPDF ile HTML'den PDF'ye Dönüşüm: IronPDF, CSS dahil HTML içeriğini PDF dosyalarına dönüştürmenizi sağlar. Bu özellik, web sayfalarından veya HTML şablonlarından piksel mükemmelliğinde PDF belgeleri oluşturmanıza olanak tanır.

URL İşleme: IronPDF, bir sunucudan bir URL kullanarak web sayfaları alabilir ve bunları PDF dosyalarına dönüştürebilir, web içeriğini arşivlemek veya dinamik web sayfalarından raporlar oluşturmak kolay hale gelir.

Metin, Görüntü ve PDF Birleştirme: IronPDF, metinleri, görüntüleri ve mevcut PDF dosyalarını tek bir PDF belgesinde birleştirmenizi sağlar. Bu özellik, birden çok içerik kaynağı içeren karmaşık belgeler oluşturmak için özellikle faydalıdır.

PDF Manipülasyonu: IronPDF, sayfa ekleme veya kaldırma, meta verileri değiştirme veya hatta PDF belgelerinden metin ve görüntü çıkarma gibi mevcut PDF dosyalarını düzenleme araçları sağlar.