مرور کلی
ادغام فایلهای PDF یک نیاز متداول برای بسیاری از توسعهدهندگان است، چه برای تجمیع گزارشها، ترکیب اسناد یا سادهسازی اشتراکگذاری فایلها. با کتابخانهٔ GroupDocs.Merger for Python via .NET میتوانید بهصورت برنامهنویسی چندین فایل PDF را بهکارآمدی ادغام کنید. این مقاله شما را در فرآیند ادغام فایلهای PDF با استفاده از پایتون راهنمایی میکند، توابع ضروری را پوشش میدهد و مثالهای عملی کد ارائه میدهد.
میتوانید بخشهای زیر را برای آشنایی بیشتر با فرآیند ادغام بررسی کنید:
- چگونه فایلهای PDF را در پایتون ادغام کنیم
- چگونه فایلهای PDF را با نشانکها در پایتون ادغام کنیم
- چگونه بهدرستی جریانهای PDF را در پایتون بارگذاری کنیم
چگونه فایلهای PDF را در پایتون ادغام کنیم
کتابخانهٔ GroupDocs.Merger for Python via .NET به توسعهدهندگان امکان میدهد فایلهای PDF را بدون نیاز به نرمافزارهای شخص ثالث بهراحتی ادغام کنند. این قابلیت برای کارهایی مانند ترکیب چندین سند در یک فایل جامع ضروری است که مدیریت و اشتراکگذاری اسناد را بهبود میبخشد.
مراحل ادغام فایلهای PDF
- بارگذاری فایل PDF منبع: ابتدا یک نمونه از کلاس
Mergerایجاد کنید و مسیر فایل PDF منبع را به آن بدهید. - افزودن فایلهای PDF دیگر: از متد
joinکلاسMergerبرای افزودن سایر فایلهای PDF که میخواهید ترکیب کنید، استفاده کنید. - ذخیرهٔ 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 با نشانکها
- بارگذاری فایل PDF منبع: کلاس
Mergerرا مقداردهی کنید و اولین فایل PDF خود را بارگذاری کنید. - تنظیم گزینههای نشانک: یک شیء
PdfJoinOptionsایجاد کنید و پرچمuse_bookmarksرا رویTrueتنظیم کنید. - افزودن فایلهای PDF دیگر: سایر فایلهای PDF را به ادغامکننده اضافه کنید بهطوری که نشانکها حفظ شوند.
- ذخیرهٔ 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
- بارگذاری PDF از جریان: از یک جریان فایل بهعنوان ورودی برای کلاس
Mergerاستفاده کنید. - انجام عملیات: پس از بارگذاری سند از جریان، میتوانید عملیات ادغام خود را ادامه دهید.
در ادامه یک مثال آورده شده است:
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 دریافت کنید.