مرور کلی

ادغام فایل‌های PDF یک نیاز متداول برای بسیاری از توسعه‌دهندگان است، چه برای تجمیع گزارش‌ها، ترکیب اسناد یا ساده‌سازی اشتراک‌گذاری فایل‌ها. با کتابخانهٔ GroupDocs.Merger for Python via .NET می‌توانید به‌صورت برنامه‌نویسی چندین فایل PDF را به‌کارآمدی ادغام کنید. این مقاله شما را در فرآیند ادغام فایل‌های PDF با استفاده از پایتون راهنمایی می‌کند، توابع ضروری را پوشش می‌دهد و مثال‌های عملی کد ارائه می‌دهد.

می‌توانید بخش‌های زیر را برای آشنایی بیشتر با فرآیند ادغام بررسی کنید:

چگونه فایل‌های PDF را در پایتون ادغام کنیم

کتابخانهٔ GroupDocs.Merger for Python via .NET به توسعه‌دهندگان امکان می‌دهد فایل‌های PDF را بدون نیاز به نرم‌افزارهای شخص ثالث به‌راحتی ادغام کنند. این قابلیت برای کارهایی مانند ترکیب چندین سند در یک فایل جامع ضروری است که مدیریت و اشتراک‌گذاری اسناد را بهبود می‌بخشد.

مراحل ادغام فایل‌های PDF

  1. بارگذاری فایل PDF منبع: ابتدا یک نمونه از کلاس Merger ایجاد کنید و مسیر فایل PDF منبع را به آن بدهید.
  2. افزودن فایل‌های PDF دیگر: از متد join کلاس Merger برای افزودن سایر فایل‌های PDF که می‌خواهید ترکیب کنید، استفاده کنید.
  3. ذخیرهٔ PDF ادغام‌شده: در نهایت، متد save را فراخوانی کنید تا نام فایل PDF ادغام‌شده را مشخص کرده و نتیجه را ذخیره کنید.

در ادامه یک مثال ساده برای ادغام دو فایل PDF آورده شده است:

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Basic Usage] # MultipleDocumentOperations # Merge : Pdf")

    # Create Merger instance and load the first PDF file
    with gm.Merger(constants.sample_pdf) as merger:
        print(f"Document info retrieved successfully")
        # Add another PDF file to merge
        merger.join(constants.sample_pdf)
        # Save the merged PDF file
        merger.save(constants.output_pdf)
        print(f"Merge to: {constants.output_pdf}")
    
    print(f"----------------------------------------------------------------------------")

چگونه فایل‌های PDF را با نشانک‌ها در پایتون ادغام کنیم

ادغام PDFهایی که شامل نشانک هستند برای حفظ ناوبری سند ضروری است. کتابخانهٔ GroupDocs.Merger گزینه‌ای برای گنجاندن نشانک‌ها در طول فرآیند ادغام فراهم می‌کند.

مراحل ادغام فایل‌های PDF با نشانک‌ها

  1. بارگذاری فایل PDF منبع: کلاس Merger را مقداردهی کنید و اولین فایل PDF خود را بارگذاری کنید.
  2. تنظیم گزینه‌های نشانک: یک شیء PdfJoinOptions ایجاد کنید و پرچم use_bookmarks را روی True تنظیم کنید.
  3. افزودن فایل‌های PDF دیگر: سایر فایل‌های PDF را به ادغام‌کننده اضافه کنید به‌طوری که نشانک‌ها حفظ شوند.
  4. ذخیرهٔ PDF ادغام‌شده: متد save را فراخوانی کنید تا نتایج ذخیره شوند.

در ادامه نحوهٔ انجام این کار در کد آورده شده است:

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Basic Usage] # MultipleDocumentOperations # Merge # Pdf : MergePdfUseBookmarks")

    # Create Merger instance and load the first PDF file
    with gm.Merger(constants.sample_pdf) as merger:
        print(f"Document info retrieved successfully")
        
        # Initialize PdfJoinOptions with the UseBookmarks flag
        pdf_join_options = gm.domain.options.PdfJoinOptions()
        pdf_join_options.use_bookmarks = True
        
        # Add another PDF file to merge with bookmarks
        merger.join(constants.sample_pdf_bookmarks, pdf_join_options)
        
        # Save the merged PDF file
        merger.save(constants.output_pdf_bookmarks)
        print(f"Merge to: {constants.output_pdf_bookmarks}")
    
    print(f"----------------------------------------------------------------------------")

چگونه به‌درستی جریان‌های PDF را در پایتون بارگذاری کنیم

ادغام فایل‌های PDF از جریان‌ها (streams) انعطاف‌پذیری کتابخانهٔ GroupDocs.Merger را گسترش می‌دهد و به شما امکان می‌دهد محتویات PDF را به‌صورت پویا مدیریت کنید.

مراحل بارگذاری جریان‌های PDF

  1. بارگذاری PDF از جریان: از یک جریان فایل به‌عنوان ورودی برای کلاس Merger استفاده کنید.
  2. انجام عملیات: پس از بارگذاری سند از جریان، می‌توانید عملیات ادغام خود را ادامه دهید.

در ادامه یک مثال آورده شده است:

from turtle import update
import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Advanced Usage] # Loading # LoadDocumentFromStream")

    # Get the file stream for loading
    stream = get_file_stream()
    # Merge PDF files from stream
    with gm.Merger(stream) as merger:
        print(f"Document loaded from stream successfully")
    
    print(f"----------------------------------------------------------------------------")

def get_file_stream():
    # Load the PDF file as a binary stream
    file_path = constants.sample_pdf
    return open(file_path, "rb")

همچنین ببینید

  • برای جزئیات بیشتر دربارهٔ کتابخانهٔ GroupDocs.Merger، مستندات کامل را در documentation بررسی کنید.
  • برای اطلاعات عمیق دربارهٔ کلاس‌ها و متدها، به API Reference مراجعه کنید.
  • برای پیاده‌سازی‌های عملی، به مثال‌های موجود در GitHub examples سر بزنید.
  • برای دریافت آخرین نسخهٔ کتابخانه، صفحهٔ Releases page را بازدید کنید.

می‌توانید یک نسخهٔ آزمایشی رایگان از GroupDocs.Merger for Python via .NET را از here دانلود کنید و برای استفادهٔ بدون محدودیت از کتابخانهٔ ما، یک لایسنس موقت را از Temporary License دریافت کنید.

مثال‌های کد

در ادامه چند مثال دقیق‌تر برای نشان دادن موارد استفاده مختلف از ادغام PDFها با کتابخانهٔ GroupDocs.Merger for Python via .NET آورده شده است.

مثال 1: ادغام پایهٔ چندین فایل PDF

این مثال نشان می‌دهد چگونه چندین فایل PDF را در یک فایل ترکیب کنیم.

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Basic Usage] # MultipleDocumentOperations # Merge : Pdf")

    # Create a Merger instance and load the first PDF file
    with gm.Merger(constants.sample_pdf) as merger:
        print(f"Document info retrieved successfully")
        
        # Add another PDF file to merge
        merger.join(constants.sample_pdf)
        
        # Save the merged PDF file
        merger.save(constants.output_pdf)
        print(f"Merge to: {constants.output_pdf}")
    
    print(f"----------------------------------------------------------------------------")

مثال 2: ادغام PDFها با نشانک‌ها

این مثال نشان می‌دهد چگونه فایل‌های PDF را هنگام حفظ نشانک‌ها ادغام کنیم.

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Basic Usage] # MultipleDocumentOperations # Merge # Pdf : MergePdfUseBookmarks")

    # Create a Merger instance and load the first PDF file
    with gm.Merger(constants.sample_pdf) as merger:
        print(f"Document info retrieved successfully")
        
        # Initialize PdfJoinOptions with the UseBookmarks flag
        pdf_join_options = gm.domain.options.PdfJoinOptions()
        pdf_join_options.use_bookmarks = True
        
        # Add another PDF file to merge with bookmarks
        merger.join(constants.sample_pdf_bookmarks, pdf_join_options)
        
        # Save the merged PDF file
        merger.save(constants.output_pdf_bookmarks)
        print(f"Merge to: {constants.output_pdf_bookmarks}")
    
    print(f"----------------------------------------------------------------------------")

مثال 3: بارگذاری جریان‌های PDF

این مثال نشان می‌دهد چگونه PDFها را با استفاده از جریان‌های فایل بارگذاری کنیم تا ورودی پویا داشته باشید.

from turtle import update
import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Example Advanced Usage] # Loading # LoadDocumentFromStream")

    # Get the file stream for loading
    stream = get_file_stream()
    
    # Merge PDF files from the stream
    with gm.Merger(stream) as merger:
        print(f"Document loaded from stream successfully")
    
    print(f"----------------------------------------------------------------------------")

def get_file_stream():
    # Load the PDF file as a binary stream
    file_path = constants.sample_pdf
    return open(file_path, "rb")

همچنین ببینید

  • برای جزئیات بیشتر دربارهٔ کتابخانهٔ GroupDocs.Merger، مستندات کامل را در documentation بررسی کنید.
  • برای اطلاعات عمیق دربارهٔ کلاس‌ها و متدها، به API Reference مراجعه کنید.
  • برای پیاده‌سازی‌های عملی، به مثال‌های موجود در GitHub examples سر بزنید.
  • برای دریافت آخرین نسخهٔ کتابخانه، صفحهٔ Releases page را بازدید کنید.

می‌توانید یک نسخهٔ آزمایشی رایگان از GroupDocs.Merger for Python via .NET را از here دانلود کنید و برای استفادهٔ بدون محدودیت از کتابخانهٔ ما، یک لایسنس موقت را از Temporary License دریافت کنید.