ایجاد کتابچه PDF در پایتون

تولید PDFهای فشرده و قابل چاپ از چندین صفحه یک نیاز مکرر برای گزارش‌ها، کاتالوگ‌ها و راهنماها است. Aspose.PDF for Python via .NET یک SDK قدرتمند فراهم می‌کند که به شما امکان می‌دهد به‌صورت برنامه‌نویسی یک کتابچه PDF را در پایتون با کنترل دقیق ایجاد کنید. در این راهنما خواهید دید که چگونه محیط را تنظیم کنید، یک کتابچه بسازید، در صورت نیاز نشانک‌ها را اضافه کنید و سند نهایی را صادر کنید.

PDF Booklet چیست؟

یک کتابچه PDF سندی است که به گونه‌ای ترتیب داده شده است که چندین صفحه می‌توانند چاپ، تا شده و مانند یک کتاب کوچک، دفترچه راهنما، بروشور یا کاتالوگ خوانده شوند. به‌جای نگه داشتن صفحات به ترتیب معمولی، تولید کتابچه صفحات را بازآرایی می‌کند تا صفحات صحیح پس از چاپ و تا کردن در کنار هم ظاهر شوند.

به عنوان مثال، یک طرح کتابچه می‌تواند یک صفحه را در سمت چپ یک ورق و صفحه دیگری را در سمت راست قرار دهد. هنگامی که به صورت دوطرفه چاپ شده و تا می‌شود، صفحات در ترتیب صحیح خواندن ظاهر می‌شوند.

دفترچه‌ها معمولاً برای موارد زیر استفاده می‌شوند:

• کاتالوگ‌های محصول
• برنامه‌های رویداد
• راهنماهای آموزشی
• گزارش‌ها
• راهنماهای دستورالعمل
• پروفایل‌های شرکت
• بروشورها
• کتاب‌های چاپی کوچک

در پایتون می‌توانید این فرآیند را به‌صورت خودکار انجام دهید به‌جای اینکه صفحات را به‌صورت دستی در یک ویرایشگر PDF جابجا کنید.

API تولید کتابچه PDF پایتون

برای ایجاد یک کتابچه PDF در پایتون، از Aspose.PDF for Python via .NET استفاده می‌کنیم. این یک API پردازش PDF است که به توسعه‌دهندگان پایتون امکان ایجاد، ویرایش، تبدیل، تقسیم، ادغام، امن‌سازی، حاشیه‌نویسی و دستکاری فایل‌های PDF را به‌صورت برنامه‌نویسی می‌دهد.

برای ایجاد کتابچه، کلاس کلیدی این است:

pdf.facades.PdfFileEditor()

کلاس PdfFileEditor ویژگی‌های پیشرفتهٔ دستکاری فایل PDF را فراهم می‌کند. در این آموزش، از متد make_booklet() آن برای تبدیل یک PDF موجود به قالب دفترچه استفاده خواهیم کرد.

مرحله 1: نصب Aspose.PDF SDK

ابتدا، Aspose.PDF for Python via .NET را با استفاده از pip نصب کنید:

pip install aspose-pdf

مرحله ۲: آماده‌سازی PDF ورودی

قبل از ایجاد یک کتابچه، مطمئن شوید که قبلاً یک فایل PDF منبع دارید. برای این آموزش، از نام فایل زیر استفاده خواهیم کرد:

input.pdf

دفترچه خروجی به این شکل ذخیره می‌شود:

booklet.pdf

فایل PDF ورودی را در همان دایرکتوری که اسکریپت پایتون شما قرار دارد قرار دهید، یا مسیر کامل فایل را ارائه کنید.

مثال:

project-folder/
│
├── input.pdf
└── create_booklet.py

گام 3: ایجاد یک بروشور PDF ساده در Python

ساده‌ترین راه برای ایجاد یک کتابچه، فراخوانی make_booklet() با فایل ورودی، فایل خروجی و اندازه صفحه هدف است.

کد پایتون زیر یک کتابچه با اندازه صفحه A5 ایجاد می‌کند:

import aspose.pdf as pdf

# Create PdfFileEditor object
pdf_editor = pdf.facades.PdfFileEditor()

# Create booklet from input PDF
pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5
)

print("PDF booklet created successfully.")

این کد فایل input.pdf را بارگذاری می‌کند، صفحات آن را به صورت چیدمان کتابچه‌ای ترتیب می‌دهد و نتیجه را به عنوان booklet.pdf ذخیره می‌کند.

مرحله 4: ایجاد یک کتابچه PDF سفارشی با صفحات چپ و راست

در بسیاری از موارد، ممکن است بخواهید کنترل کنید که کدام صفحات در سمت چپ و کدام صفحات در سمت راست طرح کتابچه ظاهر شوند.

مثال زیر بر پایه کد اصلی C# است و آن را به Python تبدیل می‌کند:

import aspose.pdf as pdf

# Create PdfFileEditor object
pdf_editor = pdf.facades.PdfFileEditor()

# Set left and right pages
left_pages = [1, 5]
right_pages = [2, 3]

# Make booklet
pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5,
    left_pages,
    right_pages
)

print("PDF booklet created successfully.")

توضیح کد

بیایید کد را تجزیه کنیم.

ابتدا بسته Aspose.PDF را وارد کنید:

import aspose.pdf as pdf

سپس یک نمونه از PdfFileEditor ایجاد کنید:

pdf_editor = pdf.facades.PdfFileEditor()

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

سپس، ترتیب صفحه را تعریف کنید:

left_pages = [1, 5]
right_pages = [2, 3]

لیست left_pages صفحات را تعریف می‌کند که در سمت چپ صفحه‌گروه ظاهر می‌شوند. لیست right_pages صفحات را تعریف می‌کند که در سمت راست ظاهر می‌شوند.

در نهایت، متد make_booklet() را فراخوانی کنید:

pdf_editor.make_booklet(
    "input.pdf",
    "booklet.pdf",
    pdf.PageSize.a5,
    left_pages,
    right_pages
)

این کتابچه را ایجاد می‌کند و آن را به‌عنوان booklet.pdf ذخیره می‌نماید.

کد کامل پایتون

در اینجا مثال کامل کد برای ایجاد یک کتابچه PDF در پایتون آورده شده است:

import aspose.pdf as pdf

def create_pdf_booklet(input_pdf: str, output_pdf: str) -> None:
    """
    Create a PDF booklet from an existing PDF file using Aspose.PDF for Python via .NET.

Args:
        input_pdf: Path to the source PDF file.
        output_pdf: Path where the generated booklet PDF will be saved.
    """

# Create PdfFileEditor object
    pdf_editor = pdf.facades.PdfFileEditor()

# Set left and right pages
    left_pages = [1, 5]
    right_pages = [2, 3]

# Make booklet
    pdf_editor.make_booklet(
        input_pdf,
        output_pdf,
        pdf.PageSize.a5,
        left_pages,
        right_pages
    )

if __name__ == "__main__":
    create_pdf_booklet(
        input_pdf="input.pdf",
        output_pdf="booklet.pdf"
    )

print("PDF booklet created successfully.")

مرحله 5: افزودن نشانک‌های اختیاری به کتابچه

پس از ایجاد دفترچه، ممکن است بخواهید نشانک‌ها را اضافه کنید تا ناوبری آسان‌تر شود. نشانک‌ها برای گزارش‌ها، راهنماها، کاتالوگ‌ها، راهنمایی‌های آموزشی و سایر اسناد طولانی مفید هستند.

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

import aspose.pdf as pdf

def create_pdf_booklet(input_pdf: str, output_pdf: str) -> None:
    """
    Create a PDF booklet from an existing PDF file.
    """

pdf_editor = pdf.facades.PdfFileEditor()

left_pages = [1, 5]
    right_pages = [2, 3]

pdf_editor.make_booklet(
        input_pdf,
        output_pdf,
        pdf.PageSize.a5,
        left_pages,
        right_pages
    )

def add_bookmarks(input_pdf: str, output_pdf: str) -> None:
    """
    Add bookmarks to an existing PDF document.
    """

# Open generated booklet PDF
    document = pdf.Document(input_pdf)

# Add bookmark for first page
    first_bookmark = pdf.OutlineItemCollection(document.outlines)
    first_bookmark.title = "Booklet Start"
    first_bookmark.bold = True
    first_bookmark.action = pdf.annotations.GoToAction(document.pages[1])
    document.outlines.append(first_bookmark)

# Add bookmark for second page, if available
    if len(document.pages) >= 2:
        second_bookmark = pdf.OutlineItemCollection(document.outlines)
        second_bookmark.title = "Second Spread"
        second_bookmark.action = pdf.annotations.GoToAction(document.pages[2])
        document.outlines.append(second_bookmark)

# Save PDF with bookmarks
    document.save(output_pdf)

if __name__ == "__main__":
    create_pdf_booklet(
        input_pdf="input.pdf",
        output_pdf="booklet.pdf"
    )

add_bookmarks(
        input_pdf="booklet.pdf",
        output_pdf="booklet-with-bookmarks.pdf"
    )

print("PDF booklet with bookmarks created successfully.")

این کد دو فایل خروجی ایجاد می‌کند:

booklet.pdf
booklet-with-bookmarks.pdf

فایل اول شامل طرح بروشور است. فایل دوم شامل بروشور با نشانک‌های اضافه شده است.

انتخاب اندازه صفحه مناسب

در مثال‌های بالا، ما از اندازه صفحه A5 استفاده کردیم:

pdf.PageSize.a5

A5 به‌طور معمول برای کتابچه‌ها استفاده می‌شود زیرا جمع‌وجور است و برای دفترچه‌های چاپی، بروشورها و کاتالوگ‌های کوچک مناسب است.

می‌توانید بسته به نیازهای خروجی خود از اندازه‌های صفحه دیگری استفاده کنید. به عنوان مثال، اگر در حال ایجاد یک جزوه بزرگ‌تر هستید، می‌توانید از A4 استفاده کنید. اگر در حال تهیه یک راهنمای فشرده هستید، A5 ممکن است مناسب‌تر باشد.

موارد استفاده رایج دفترچه عبارتند از:

بهترین روش‌ها برای ایجاد جزوات PDF

هنگام تولید بروشورها به‌صورت برنامه‌نویسی، نکات زیر را در نظر بگیرید.

1. استفاده از یک PDF منبع تمیز

PDF ورودی شما باید از پیش به‌درستی قالب‌بندی شده باشد. تولید کتابچه صفحات را بازآرایی می‌کند، اما محتوای داخلی هر صفحه را بازنویسی نمی‌کند.

قبل از ایجاد دفترچه، بررسی کنید:

• حاشیه‌های صفحه
• مکان‌گذاری سرصفحه و پاورقی
• جاسازی قلم
• کیفیت تصویر
• جهت صفحه
• حاشیه یا مناطق ایمن چاپ

2. بررسی تعداد صفحات

کتابچه‌ها زمانی بهترین عملکرد را دارند که تعداد صفحات برای تا کردن و چاپ مناسب باشد. اگر تعداد صفحات به‌طور دقیق هم‌راستا نباشد، ممکن است نیاز به افزودن صفحات خالی داشته باشید.

به عنوان مثال، یک جزوه ممکن است به صفحات به مضارب چهار نیاز داشته باشد زیرا هر ورق تا شده چهار طرف صفحه تولید می‌کند.

3. چاپ آزمایشی قبل از چاپ انبوه

همیشه قبل از ارسال جزوه برای چاپ انبوه، یک نسخه آزمایشی چاپ کنید. نمایشگرهای PDF و تنظیمات پرینتر می‌توانند بر مقیاس‌بندی، حاشیه‌ها، حالت دوطرفه و جهت صفحه تأثیر بگذارند.

تنظیمات پیشنهادی چاپگر ممکن است شامل موارد زیر باشد:

• چاپ در هر دو طرف
• چرخش در لبه کوتاه یا لبه بلند، بسته به چاپگر
• اندازه واقعی
• بدون مقیاس‌گذاری خودکار
• اندازه صحیح کاغذ

4. افزودن نشانک‌ها برای نسخه‌های دیجیتال

اگر جزوه نیز به صورت دیجیتالی به اشتراک گذاشته شود، نشانک‌ها ناوبری را بهبود می‌بخشند. آن‌ها به خوانندگان کمک می‌کنند تا به سرعت به بخش‌های مهم پرش کنند.

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

• گزارش‌های طولانی
• راهنماهای فنی
• اسناد سیاستی
• کاتالوگ‌های محصول
• مطالب آموزشی

5. از نام‌های واضح برای فایل‌ها استفاده کنید

از نام‌های توصیفی برای فایل‌های خروجی استفاده کنید، به‌ویژه هنگام تولید اسناد به صورت دسته‌ای.

به عنوان مثال:

employee-handbook-booklet.pdf
product-catalog-booklet.pdf
training-manual-booklet.pdf

خطاهای رایج و راه‌حل‌ها

خطا: ModuleNotFoundError: ماژولی به نام ‘aspose’ یافت نشد

این به این معنی است که بسته Aspose.PDF در محیط فعلی پایتون شما نصب نشده است.

با این اصلاح کنید:

pip install aspose-pdf

اگر از یک محیط مجازی استفاده می‌کنید، قبل از نصب بسته مطمئن شوید که فعال باشد.

خطا: PDF ورودی یافت نشد

اگر اسکریپت شما نتواند فایل ورودی را پیدا کند، مسیر فایل را بررسی کنید.

به جای:

"input.pdf"

از مسیر مطلق استفاده کنید:

"C:/Users/YourName/Documents/input.pdf"

یا در Linux/macOS:

"/home/user/documents/input.pdf"

خطا: خروجی دفترچه به ترتیب مورد انتظار نیست

اگر از آرایه‌های سفارشی صفحه چپ و راست استفاده می‌کنید، اطمینان حاصل کنید که شماره‌های صفحات با صفحات موجود در PDF منبع مطابقت داشته باشند.

مثال:

left_pages = [1, 5]
right_pages = [2, 3]

این مقادیر باید بر اساس ترتیب دلخواه صفحه‌بندی کتابچه شما انتخاب شوند.

خطا: نشانک‌ها ظاهر نمی‌شوند

اگر نشانک‌ها در برنامه‌نمایشگر PDF شما ظاهر نمی‌شوند، بررسی کنید که آیا پنل نشانک در برنامه فعال است یا خیر. برخی برنامه‌های نمایش PDF به‌طور پیش‌فرض نشانک‌ها را مخفی می‌کنند.

همچنین می‌توانید حالت صفحه سند را برای نمایش طرح کلی تنظیم کنید:

document.page_mode = pdf.PageMode.USE_OUTLINES

قبل از ذخیره‌سازی PDF این را اضافه کنید:

document.save(output_pdf)

ایجاد کتابچه PDF در پایتون: کد نهایی

کد نهایی زیر یک کتابچه PDF ایجاد می‌کند، نشانک‌ها را اضافه می‌کند و نتیجه را ذخیره می‌کند:

import aspose.pdf as pdf

def create_pdf_booklet(input_pdf: str, booklet_pdf: str) -> None:
    """
    Create a custom PDF booklet using Aspose.PDF for Python via .NET.
    """

pdf_editor = pdf.facades.PdfFileEditor()

left_pages = [1, 5]
    right_pages = [2, 3]

pdf_editor.make_booklet(
        input_pdf,
        booklet_pdf,
        pdf.PageSize.a5,
        left_pages,
        right_pages
    )

def add_bookmarks_to_booklet(booklet_pdf: str, output_pdf: str) -> None:
    """
    Add bookmarks to the generated booklet PDF.
    """

document = pdf.Document(booklet_pdf)

start_bookmark = pdf.OutlineItemCollection(document.outlines)
    start_bookmark.title = "Booklet Start"
    start_bookmark.bold = True
    start_bookmark.action = pdf.annotations.GoToAction(document.pages[1])
    document.outlines.append(start_bookmark)

if len(document.pages) >= 2:
        second_bookmark = pdf.OutlineItemCollection(document.outlines)
        second_bookmark.title = "Second Spread"
        second_bookmark.action = pdf.annotations.GoToAction(document.pages[2])
        document.outlines.append(second_bookmark)

document.page_mode = pdf.PageMode.USE_OUTLINES
    document.save(output_pdf)

if __name__ == "__main__":
    input_pdf = "input.pdf"
    booklet_pdf = "booklet.pdf"
    final_pdf = "booklet-with-bookmarks.pdf"

create_pdf_booklet(input_pdf, booklet_pdf)
    add_bookmarks_to_booklet(booklet_pdf, final_pdf)

print("PDF booklet created successfully:", final_pdf)

نتیجه‌گیری

در این آموزش، شما یاد گرفتید که چگونه یک کتابچه PDF را در پایتون با استفاده از Aspose.PDF for Python via .NET ایجاد کنید. شما SDK را نصب کردید، یک کتابچه از یک PDF موجود ایجاد کردید، قرارگیری صفحات چپ و راست را پیکربندی کردید، نشانک‌های اختیاری را اضافه کردید، و کتابچه نهایی را به عنوان یک فایل PDF ذخیره کردید.

متد PdfFileEditor.make_booklet() زمانی مفید است که نیاز به خودکارسازی تولید کتابچه برای گزارش‌ها، کاتالوگ‌ها، راهنماها، بروشورها و مستندات قابل چاپ دارید. با ترکیب ایجاد کتابچه با نشانک‌ها، می‌توانید فایل‌های PDF تولید کنید که برای توزیع چاپی و دیجیتال مناسب باشند.

بیشتر بخوانید

• حذف صفحات از PDF در Python
• استخراج صفحات از PDF در Python
• حذف تصاویر از PDF با استفاده از Python