1. .NET
  2. Nasıl Yapılır
  3. PDF'leri Birleştirme
Python Kullanarak PDF Dosyaları Nasıl Birleştirilir | IronPDF

Python Kullanarak PDF Dosyalarını Tek Bir PDF'e Birleştirme

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Python, PdfDocument.Merge() yöntemini kullanarak birden fazla PDF belgesini tek bir dosyada birleştirmek için doğrudan bir çözüm sunar ve çok sayıda PDF'yi verimli bir şekilde birleştirmek için hem iki dosya birleştirme hem de toplu işlemleri destekler.

PDF (Portable Document Format), platformlar ve uygulamalar arasında aynı görünmesi gereken belgeleri paylaşmak için standarttır. Raporları birleştiriyor veya taranmış belgeleri birleştiriyor olun, iş ve veri işleme iş akışlarında çeşitli kaynaklardan PDF içeriği birleştirmek sürekli bir gerekliliktir.

IronPDF, bu işlemi Python'da tek bir yöntem çağrısı ile ele alır. Bu kılavuz, kurulum, temel iki dosya birleştirme ve birden fazla belgeyi bir kerede birleştirmek için toplu işlemleri kapsar.

Hızlı Başlangıç: Python'da PDF Dosyalarını Birleştir

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/quickstart.py
from ironpdf import *

renderer = ChromePdfRenderer()
pdf_a = renderer.RenderHtmlAsPdf("<p>Document A</p>")
pdf_b = renderer.RenderHtmlAsPdf("<p>Document B</p>")

merged = PdfDocument.Merge([pdf_a, pdf_b])
merged.SaveAs("merged.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/quickstart.py
from ironpdf import *

renderer = ChromePdfRenderer()
pdf_a = renderer.RenderHtmlAsPdf("<p>Document A</p>")
pdf_b = renderer.RenderHtmlAsPdf("<p>Document B</p>")

merged = PdfDocument.Merge([pdf_a, pdf_b])
merged.SaveAs("merged.pdf")
PYTHON

Asgari İş Akışı (5 adım)

  1. PDF dosyalarını birleştirmek için gerekli Python kütüphanesini yükleyin
  2. RenderHtmlAsPdf kullanarak bireysel PDF dosyaları üretin veya mevcut olanları PdfDocument.FromFile ile yükleyin
  3. PDF dosyalarını tek bir PdfDocument içinde birleştirmek için Merge yöntemini uygulayın
  4. SaveAs ile birleşik belgeyi kaydedin
  5. Birden fazla PDF için, Merge'a PdfDocument nesnelerinin listesini geçirin

IronPDF for Python'u Nasıl Kurarım?

IronPDF, pip üzerinden bir Python paketi olarak temin edilebilir. Python 3.x gerektirir ve standart birleştirme işlemleri için herhangi bir ek sistem bağımlılığı olmadan Windows ve Linux üzerinde çalışır. Paket, HTML-PDF dönüşümünü dahili olarak yöneten Chromium tabanlı bir işleme motoruyla birlikte gelir.

Aşağıdaki komutu kullanarak pip ile IronPdf kütüphanesini yükleyin:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/install.sh
pip install ironpdf
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/install.sh
pip install ironpdf
SHELL

"Modül Tanımlı Değil" hataları veya izin sorunları gibi yaygın sorunlarla ilgili ayrıntılı kurulum talimatları ve yardım için resmi belgelere bakın.

Hangi İçe Aktarma İfadeleri Gereklidir?

Python betiğinizde, IronPDF'nin PDF oluşturma ve birleştirme özelliklerine erişmek için aşağıdaki ithalat ifadelerini dahil edin:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/imports.py
from ironpdf import *

# Set your license key for production use
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/imports.py
from ironpdf import *

# Set your license key for production use
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
PYTHON

Üretim uygulamaları için, IronPDF'nin tam özellik setini etkinleştirmek için lisans anahtarınızı yapılandırın. Ücretsiz bir deneme mevcuttur - ücretsiz denemenizi başlatın ve satın alma yapmadan başlayın.

Python'da İki PDF Dosyasını Nasıl Birleştiririm?

Python'da PDF dosyalarını birleştirmek iki adımdan oluşur: kaynak PDF belgelerini oluşturmak, ardından bunları PdfDocument.Merge() ile birleştirmek. Yöntem, PdfDocument nesnelerinin bir listesini kabul eder ve öğelerin listede göründüğü sırayla yeni bir birleştirilmiş belge oluşturur.

Aşağıda eksiksiz bir çalışma örneği verilmiştir:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-two-pdfs.py
from ironpdf import *

# HTML content for the first PDF
html_a = """<p> [PDF_A] </p>
            <p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

# HTML content for the second PDF
html_b = """<p> [PDF_B] </p>
            <p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

# Initialize renderer
renderer = ChromePdfRenderer()

# Convert each HTML string to a PDF document
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

# Merge the two documents into one
merged = PdfDocument.Merge([pdfdoc_a, pdfdoc_b])

# Save the merged result to disk
merged.SaveAs("Merged.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-two-pdfs.py
from ironpdf import *

# HTML content for the first PDF
html_a = """<p> [PDF_A] </p>
            <p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

# HTML content for the second PDF
html_b = """<p> [PDF_B] </p>
            <p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

# Initialize renderer
renderer = ChromePdfRenderer()

# Convert each HTML string to a PDF document
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

# Merge the two documents into one
merged = PdfDocument.Merge([pdfdoc_a, pdfdoc_b])

# Save the merged result to disk
merged.SaveAs("Merged.pdf")
PYTHON

PDF Oluşturma İçin RenderHtmlAsPdf Kullanmanın Avantajı Nedir?

Yukarıdaki örnek, her biri iki sayfalık bir belgeyi temsil eden iki HTML dizesi kullanır. RenderHtmlAsPdf, IronPDF'nin Chrome tabanlı görüntüleme motorunu kullanarak her bir dizeyi PdfDocument nesnesine dönüştürür; bu motor, HTML, CSS ve JavaScript içeriğinden doğru sonuçlar üretir. Bu yaklaşım, raporlar veya web şablonlarından veri odaklı belgeler üretmek için uygundur. Daha karmaşık işleme senaryoları için şu HTML to PDF öğreticiliğine bakın.

İpuçlarıAyrıca PdfDocument.FromFile("path/to/file.pdf") kullanarak diskten mevcut PDF dosyalarını yükleyebilir ve bunları doğrudan Merge yöntemine aktarabilirsiniz. Bu, önceden oluşturulmuş raporları veya harici olarak üretilmiş belgeleri birleştirirken faydalıdır.

Birleştirme Yöntemi Nasıl Çalışır?

PdfDocument.Merge, tek argümanı olarak PdfDocument nesnelerinden oluşan bir Python listesi alır. Belgeleri liste sırasına göre birleştirir, ilk belgede bulunan tüm sayfaları ikinci belgedeki tüm sayfaların önüne yerleştirir, ve bu şekilde devam eder. Sonuç, daha fazla değiştirilebilen veya kaydedilebilen yeni bir PdfDocument'dir. Her kaynak belgedeki sayfa sayısı, yer imleri ve gömülü içerik çıktıda korunur.

Metod, işlendiği haliyle ve dosyadan yüklenen belgeleri aynı listede kabul eder. Bu, bir raporun bir kısmı dinamik olarak oluşturulurken ve diğer kısmı statik bir şablon olduğunda, yeni işlenmiş HTML çıktısını diskten mevcut PDF'lerle tek bir çağrıda birleştirebileceğiniz anlamına gelir.

Birleştirilen PDF'i Nasıl Kaydederim?

Birleştirilmiş belgeyi diske yazmak için istenen çıktı yolunu SaveAs'ye aktarın:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/save-merged.py
# Save the merged document
merged.SaveAs("Merged.pdf")

# Optionally compress images before saving to reduce file size
merged.CompressImages(90)
merged.SaveAs("Merged_Compressed.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/save-merged.py
# Save the merged document
merged.SaveAs("Merged.pdf")

# Optionally compress images before saving to reduce file size
merged.CompressImages(90)
merged.SaveAs("Merged_Compressed.pdf")
PYTHON

Kaydettikten sonra, büyük birleştirilmiş belgelerin dosya boyutunu küçültmek için PDF sıkıştırma gibi ek işleme uygulayabilirsiniz.

IronPDF output showing a 4-page merged PDF with thumbnail panel confirming successful two-document merge

Hem kaynak belgelerden sayfalar gösteren birleştirilmiş PDF çıktısı

Python'da İkiden Fazla PDF Dosyasını Nasıl Birleştiririm?

IronPDF'de toplu birleştirme, iki belgeyi birleştirme ile aynı modeli izler. Tek fark, PdfDocument çağrısından önce listeye daha fazla PdfDocument.Merge nesnesi eklenmesidir. Metod, tek bir işlemde onlarca veya yüzlerce belgeyi işlemek üzere ölçeklenir.

Bu, ister 2 ister 200 belgeyi birleştiriyor olun, aynı API'dir. Gecelik rapor toplama veya belge montaj hattı gibi yüksek hacimli senaryolar için, IronPDF ayrıca birleştirme işleminden önce işleme aşamasını hızlandırmak için paralel PDF üretimi de destekler.

Süreç iki adımdan oluşur:

  • Birleştirilecek PdfDocument nesnelerini içeren bir Python listesi oluşturun
  • Listeyi PdfDocument.Merge argümanı olarak geçirin

Bir Liste ile Birden Çok PDF'yi Nasıl Birleştiririm?

Aşağıdaki kod, tek bir çağrıda dört HTML işlenmiş belgeyi birleştirir:

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-multiple-pdfs.py
from ironpdf import *

# HTML content for each document
html_a = """<p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

html_b = """<p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

html_c = """<p> [PDF_C] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_C] 2nd Page</p>"""

html_d = """<p> [PDF_D] Content Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_D] Summary Page</p>"""

renderer = ChromePdfRenderer()

# Render all four documents
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)
pdfdoc_c = renderer.RenderHtmlAsPdf(html_c)
pdfdoc_d = renderer.RenderHtmlAsPdf(html_d)

# Collect into a list and merge
pdfs = [pdfdoc_a, pdfdoc_b, pdfdoc_c, pdfdoc_d]
pdf = PdfDocument.Merge(pdfs)

# Save the combined document
pdf.SaveAs("merged_multiple.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-multiple-pdfs.py
from ironpdf import *

# HTML content for each document
html_a = """<p> [PDF_A] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_A] 2nd Page</p>"""

html_b = """<p> [PDF_B] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_B] 2nd Page</p>"""

html_c = """<p> [PDF_C] 1st Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_C] 2nd Page</p>"""

html_d = """<p> [PDF_D] Content Page </p>
            <div style='page-break-after: always;'></div>
            <p> [PDF_D] Summary Page</p>"""

renderer = ChromePdfRenderer()

# Render all four documents
pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)
pdfdoc_c = renderer.RenderHtmlAsPdf(html_c)
pdfdoc_d = renderer.RenderHtmlAsPdf(html_d)

# Collect into a list and merge
pdfs = [pdfdoc_a, pdfdoc_b, pdfdoc_c, pdfdoc_d]
pdf = PdfDocument.Merge(pdfs)

# Save the combined document
pdf.SaveAs("merged_multiple.pdf")
PYTHON

Merge'ye aktarılan liste, nihai belgedeki sayfa sırasını belirler. Listedeki öğelerin yeniden düzenlenmesi, ek kod olmadan çıkış sırasını değiştirir. Birleştirmeden önce belgeleri sıralamanız gerekiyorsa (örneğin, tarihe veya rapor numarasına göre), önce Python listesini sıralayın, ardından Merge'ye aktarın.

Diskten Mevcut PDF Dosyalarını Nasıl Birleştiririm?

Yeni oluşturulmuş dosyalar yerine mevcut PDF dosyalarını birleştirirken, birleştirmeden önce her dosyayı PdfDocument.FromFile ile yükleyin. Bu, diğer sistemler tarafından üretilen dosyalarla çalışırken - taranmış belgeler, üçüncü taraf rapor dışa aktarımları veya farklı araçlarla üretilen PDF'ler - tipik modeldir. IronPDF, dosyayı PdfDocument nesnesi olarak belleğe okur; bu nesne, son kaydetme işleminden önce birleştirilebilir, değiştirilebilir veya incelenebilir.

#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-existing-pdfs.py
from ironpdf import *

# Load existing PDF files from disk
existing_pdf1 = PdfDocument.FromFile("report1.pdf")
existing_pdf2 = PdfDocument.FromFile("report2.pdf")
existing_pdf3 = PdfDocument.FromFile("report3.pdf")

# Merge all loaded documents
merged_existing = PdfDocument.Merge([existing_pdf1, existing_pdf2, existing_pdf3])

# Save the combined result
merged_existing.SaveAs("merged_reports.pdf")
#:path=/static-assets/pdf/content-code-examples/how-to/python-merge-pdf/merge-existing-pdfs.py
from ironpdf import *

# Load existing PDF files from disk
existing_pdf1 = PdfDocument.FromFile("report1.pdf")
existing_pdf2 = PdfDocument.FromFile("report2.pdf")
existing_pdf3 = PdfDocument.FromFile("report3.pdf")

# Merge all loaded documents
merged_existing = PdfDocument.Merge([existing_pdf1, existing_pdf2, existing_pdf3])

# Save the combined result
merged_existing.SaveAs("merged_reports.pdf")
PYTHON

Lütfen dikkate alınIronPDF, yazı tiplerini, resimleri, açıklamaları ve kaynak dosyaların sayfa düzenlerini birleştirme sırasında korur. Gömülü form alanlarına veya dijital imzalara sahip belgeler de birleştirilebilir, ancak çıktıdaki etkileşimli form alanları kullanım durumunuza bağlı olarak yeniden düzeltme gerektirebilir.

IronPDF output showing a multi-page merged PDF with thumbnail navigation panel displaying pages from four source documents

Dört kaynak PDF'den tüm sayfaları gösteren çok belgeli birleştirme sonucu

Python'da PDF Birleştirme İçin Sonraki Adımlar Nelerdir?

Bu kılavuz, IronPDF ile PDF birleştirme için iki ana modeli ele almıştır: HTML içeriğini PDF belgelerine dönüştürme ve bunları PdfDocument.Merge ile birleştirme ve toplu birleştirme için diskten mevcut dosyaları yükleme. Hem HTML işleme hem de diskten yükleme yaklaşımları aynı API'yı kullanır ve basit iki dosyayı birleştirmeden büyük belge partilerine ölçeklenir.

IronPDF, ek olarak başlık ve altbilgi ekleme, markalama için filigran uygulama, birleşik belgeden metin çıkarma ve programatik olarak PDF formlarını doldurma gibi birleştirme sonrası işlemleri destekler.

Kütüphane, Windows ve Linux'ta Python 3.x'i destekler. Daha fazla Python PDF işlemi için, PDF'leri ayırma, PDF'leri görüntülere dönüştürme ve PDF'leri yazdırma konularını inceleyin. Tam Python kodu örnekleri listesi için, IronPDF for Python örnek sayfasını ziyaret edin.

Ücretsiz denemenize başlayın ve ortamınızdaki PDF birleştirmeyi test edin ya da üretim dağıtımları için lisanslama seçeneklerini görüntüleyin.

Başka neler yapabileceğinizi görmek için hazır mısınız? IronPDF Python eğitim sayfasını buradan inceleyin: IronPDF for Python eğitimleri

Yazılım ürününü indirin.

Sıkça Sorulan Sorular

Python kullanarak birden fazla PDF dosyasını nasıl birleştirebilirim?

pip install ironpdf ile IronPDF'i kurun, ardından PdfDocument.Merge() ile PdfDocument nesnelerinin bir Python listesi geçin. Metod, SaveAs ile kaydettiğiniz yeni bir birleşik belge döndürür.

Diske kaydedilmiş mevcut PDF dosyalarını render edilenler yerine birleştirebilir miyim?

Evet. Her mevcut PDF'i yüklemek için PdfDocument.FromFile('path/to/file.pdf') kullanın, ardından yüklenen nesneleri PdfDocument.Merge()'e geçin. Aynı liste içinde dosya yüklenmiş ve taze render edilmiş belgeleri karıştırabilirsiniz.

PdfDocument.Merge belge biçimlendirmesini ve yazı tiplerini korur mu?

Evet. IronPDF, tüm kaynak belgelerden yazı tiplerini, görüntüleri, açıklamaları ve sayfa düzenlerini birleştirme sırasında korur. Her kaynak belgenin özgün görünüşü, birleştirilmiş son PDF'te korunur.

Birleştirilmiş PDF'deki sayfa sırasını nasıl kontrol edebilirim?

Çıkış sıradaki sayfalar, Merge'e geçilen Python listesindeki PdfDocument nesnelerinin sırasına uyar. Sıralamayı kontrol etmek için elements listeyi Merge'den önce yeniden düzenleyin.

Birleştirilmiş PDF'in dosya boyutunu azaltmak için sıkıştırabilir miyim?

Evet. Birleştirdikten sonra, CompressImages(quality) çağrısını birleştirilmiş PdfDocument üzerinde, SaveAs'den önce yapın. 90 kalite değeri, sıkıştırma ve görsel sadakat arasında iyi bir denge sağlar.

Python için IronPDF platformlar arası mı?

Evet. Python için IronPDF, Windows ve Linux üzerinde Python 3.x'i destekler. Aynı PdfDocument.Merge() API, her iki platformda da yapılandırma değişiklikleri gerekmeden çalışır.

Birleştirilmiş PDF belgeye meta veri ekleyebilir miyim?

Evet. Birleştirdikten sonra, pdf.MetaData.Author ve pdf.MetaData.Title gibi meta veri özelliklerini, birleştirilmiş PdfDocument üzerinde kayıttan önce ayarlayın.

Curtis Chau
Curtis Chau
  Mühendislik ekibiyle şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Sürüm: 2026.5 just released
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz?
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.