Pythonを使ってPDFファイルを1つのPDFにマージする

必要なインポートステートメントは何ですか？

Pythonスクリプトで、IronPDFのPDF生成およびマージ機能にアクセスするために次のインポートステートメントを含めてください:

#: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"

本番アプリケーションでは、ライセンスキーを設定して、IronPDFのフル機能セットのロックを解除してください。 無料トライアルが利用可能です - 無料トライアルを開始してください、購入なしで始めます。

なぜPDF生成にRenderHtmlAsPdfを使うのですか

上記の例は、2つのHTML文字列を使用し、それぞれが2ページの文書を表しています。 RenderHtmlAsPdf は、IronPDFのChromeベースのレンダリングエンジンを使用して各文字列を PdfDocument オブジェクトに変換します。これにより、HTML、CSS、およびJavaScriptコンテンツから正確な結果が生成されます。 このアプローチは、ウェブテンプレートからのレポートやデータ駆動型ドキュメントの生成に最適です。 より複雑なレンダリングシナリオについては、HTMLからPDFへのチュートリアルを参照してください。

マージ メソッドはどのように機能しますか?

PdfDocument.Merge は、PdfDocument オブジェクトの Python リストを単一の引数として受け取ります。 リスト順でドキュメントを結合し、最初のドキュメントのすべてのページを2番目のドキュメントのすべてのページの前に配置します。 その結果、さらに修正や保存が可能な新しい PdfDocument が生成されます。 ページ数、ブックマーク、および各ソースドキュメントからの埋め込みコンテンツは、出力で全て保持されます。

メソッドは同じリストでレンダリングされたドキュメントとファイルロードされたドキュメントの任意の組み合わせを受け入れます。これはレポートの一部が動的に生成され、もう一部が静的テンプレートであるときに有用です。

PDFマージ結果をどのように保存しますか？

マージされたドキュメントをディスクに書き込むには、希望の出力パスを SaveAs に渡してください:

#: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")

保存後、大きな結合ドキュメントのファイルサイズを削減するためのPDF圧縮などの追加の後処理を適用できます。

結合PDF出力は、元の両方のドキュメントのページを示します

リストで複数のPDFを結合する方法

以下のコードは、4つのHTMLレンダリングされたドキュメントを一度に結合します：

#: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")

Mergeに渡されるリストは、最終ドキュメントにおけるページの順序を決定します。 リスト内の要素を並べ替えることで、追加のコードなしで出力順序を変更できます。 マージ前にドキュメントを並べ替える必要がある場合（例：日付やレポート番号順）、まずPythonのリストをソートしてから、それをMergeに渡してください。

ディスクにある既存のPDFファイルを結合する方法

新しくレンダリングしたPDFファイルではなく、既存のPDFファイルを結合する場合は、結合する前に各ファイルを PdfDocument.FromFile で読み込んでください。 これは他のシステムによって生成されたファイルを扱うときの典型的なパターンです - スキャンされたドキュメント、サードパーティのレポートエクスポート、または異なるツールによって生成されたPDFなど。 IronPDFはファイルをPdfDocumentオブジェクトとしてメモリに読み込み、最終的な保存前にそのオブジェクトを結合、変更、または確認することができます。

#: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")

すべてのソースPDFからのページを表示するマルチドキュメント結合結果