Birden fazla sayfadan kompakt, yazdırılabilir PDF’ler oluşturmak, raporlar, kataloglar ve kılavuzlar için sıkça ihtiyaç duyulan bir durumdur. Aspose.PDF for Python via .NET programatik olarak Python’da ince ayarlı kontrol ile PDF Kitapçığı oluşturmanıza olanak tanıyan sağlam bir SDK sağlar. Bu rehberde ortamı nasıl kuracağınızı, bir kitapçık oluşturmayı, isteğe bağlı olarak yer imleri eklemeyi ve son belgeyi dışa aktarmayı göreceksiniz.

PDF Broşürü Nedir?

PDF kitapçığı, birden fazla sayfanın yazdırılıp katlanarak küçük bir kitap, kılavuz, broşür veya katalog gibi okunabilecek şekilde düzenlenen bir belgedir. Sayfalar normal sıralı düzeninde tutulmak yerine, kitapçık oluşturma sayfaları yeniden düzenleyerek doğru sayfaların yazdırma ve katlama sonrasında yan yana görünmesini sağlar.

Örneğin, bir kitapçık düzeni bir sayfayı bir yaprağın sol tarafına ve diğer sayfayı sağ tarafına yerleştirebilir. Çift taraflı olarak basıldığında ve katlandığında, sayfalar doğru okuma sırasıyla görünür.

Kitapçıklar genellikle şu amaçlarla kullanılır:

  • Ürün katalogları
  • Etkinlik programları
  • Eğitim kılavuzları
  • Raporlar
  • Talimat kılavuzları
  • Şirket profilleri
  • Broşürler
  • Küçük basılabilir kitaplar

Python’da, PDF düzenleyicisinde sayfaları manuel olarak yeniden düzenlemek yerine bu süreci otomatikleştirebilirsiniz.

Python PDF Kitapçık Oluşturucu API

Python’da bir PDF kitapçığı oluşturmak için Aspose.PDF for Python via .NET kullanacağız. Bu, Python geliştiricilerinin PDF dosyalarını programlı olarak oluşturmasına, düzenlemesine, dönüştürmesine, bölmesine, birleştirmesine, güvenli hale getirmesine, açıklama eklemesine ve manipüle etmesine olanak tanıyan bir PDF işleme API’sidir.

Broşür oluşturma için ana sınıf şudur:

pdf.facades.PdfFileEditor()

PdfFileEditor sınıfı yüksek seviyeli PDF dosya manipülasyonu özellikleri sağlar. Bu öğreticide, mevcut bir PDF’i kitapçık düzenine dönüştürmek için make_booklet() metodunu kullanacağız.

Adım 1: Aspose.PDF SDK kurun

İlk olarak, pip kullanarak Aspose.PDF for Python via .NET’i kurun:

pip install aspose-pdf

Adım 2: Giriş PDF’sini Hazırlayın

Bir kitapçık oluşturmadan önce, zaten bir kaynak PDF dosyanızın olduğundan emin olun. Bu öğreticide, aşağıdaki dosya adını kullanacağız:

input.pdf

Çıktı kitapçığı şu şekilde kaydedilecektir:

booklet.pdf

Girdi PDF dosyasını Python betiğinizle aynı dizine koyun veya tam dosya yolunu sağlayın.

Example:

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

Adım 3: Python’da Basit Bir PDF Kitapçığı Oluşturun

Bir kitapçık oluşturmanın en basit yolu, giriş dosyası, çıkış dosyası ve hedef sayfa boyutu ile make_booklet() fonksiyonunu çağırmaktır.

Aşağıdaki Python kodu, A5 sayfa boyutunu kullanarak bir kitapçık oluşturur:

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.")

Bu kod input.pdf dosyasını yükler, sayfalarını bir kitapçık düzenine yerleştirir ve sonucu booklet.pdf olarak kaydeder.

Adım 4: Sol ve Sağ Sayfalarla Özel bir PDF Kitapçığı Oluşturun

Birçok durumda, broşür düzeninde hangi sayfaların sol tarafta ve hangi sayfaların sağ tarafta görüneceğini kontrol etmek isteyebilirsiniz.

Aşağıdaki örnek, orijinal C# koduna dayanmakta ve bunu Python’a dönüştürür.

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.")

Kod Açıklaması

Kodun detaylarını inceleyelim.

İlk olarak, Aspose.PDF paketini içe aktarın:

import aspose.pdf as pdf

Ardından PdfFileEditor sınıfının bir örneğini oluşturun:

pdf_editor = pdf.facades.PdfFileEditor()

Bu nesne, kitapçık oluşturma dahil olmak üzere yüksek seviyeli PDF düzenleme özelliklerine erişim sağlar.

Sonra, sayfa düzenini tanımlayın:

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

left_pages listesi, kitapçık yayınının sol tarafında görünecek sayfaları tanımlar. right_pages listesi ise sağ tarafta görünecek sayfaları tanımlar.

Son olarak, make_booklet() yöntemini çağırın:

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

Bu, kitapçığı oluşturur ve booklet.pdf olarak kaydeder.

Complete Python Code

Python’da PDF kitapçığı oluşturmak için tam kod örneği aşağıdadır:

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.")

Adım 5: Kitaba İsteğe Bağlı Yer İmleri Ekle

Kitapçığı oluşturduktan sonra, gezinmeyi kolaylaştırmak için yer imleri eklemek isteyebilirsiniz. Yer imleri raporlar, kılavuzlar, kataloglar, eğitim rehberleri ve diğer uzun belgeler için faydalıdır.

Aşağıdaki örnek önce bir kitapçık oluşturur ve ardından oluşturulan PDF’ye yer imleri ekler:

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.")

Bu kod iki çıktı dosyası oluşturur:

booklet.pdf
booklet-with-bookmarks.pdf

İlk dosya broşür düzenini içerir. İkinci dosya eklenmiş yer imleriyle broşürü içerir.

Doğru Sayfa Boyutunu Seçmek

Yukarıdaki örneklerde A5 sayfa boyutunu kullandık:

pdf.PageSize.a5

A5, kompakt olması ve basılı kılavuzlar, broşürler ve küçük kataloglar için uygun olması nedeniyle genellikle kitapçıklar için kullanılır.

Çıktı gereksinimlerinize bağlı olarak diğer sayfa boyutlarını da kullanabilirsiniz. Örneğin, daha büyük bir kitapçık oluşturuyorsanız A4 kullanabilirsiniz. Daha kompakt bir kılavuz hazırlıyorsanız A5 daha uygun olabilir.

Broşürün yaygın kullanım durumları şunlardır:

Kullanım DurumuÖnerilen Sayfa Boyutu
Küçük kılavuzA5
Ürün kataloğuA5 veya A4
Etkinlik programıA5
Eğitim el kitabıA4 veya A5
Şirket broşürüA5

PDF Kitapçıkları Oluşturma İçin En İyi Uygulamalar

Programatik olarak kitapçıklar oluştururken, aşağıdaki noktalara dikkat edin.

1. Temiz Bir Kaynak PDF Kullan

Girdi PDF’niz zaten düzgün bir şekilde biçimlendirilmiş olmalıdır. Broşür oluşturma sayfaları yeniden düzenler, ancak her sayfanın içeriğini yeniden yazmaz.

Broşürü oluşturmadan önce, kontrol edin:

  • Sayfa kenar boşlukları
  • Başlık ve altbilgi yerleşimi
  • Yazı tipi gömme
  • Görüntü kalitesi
  • Sayfa yönlendirmesi
  • Taşma veya baskı güvenli alanları

2. Sayfa Sayısını Kontrol Et

Kitapçıklar, sayfa sayısı katlama ve baskı için uygun olduğunda en iyi şekilde çalışır. Sayfa sayısı mükemmel bir şekilde hizalanmazsa, boş sayfalar eklemeniz gerekebilir.

Örneğin, bir kitapçık, her katlanmış sayfanın dört sayfa yüzü üretmesi nedeniyle sayfaları dörtün katları şeklinde gerektirebilir.

3. Toplu Yazdırmadan Önce Test Yazdırma

Broşürü toplu baskıya göndermeden önce her zaman bir test kopyası yazdırın. PDF görüntüleyicileri ve yazıcı ayarları ölçekleme, kenar boşlukları, çift taraflı mod ve sayfa yönlendirmesini etkileyebilir.

Önerilen yazıcı ayarları şunları içerebilir:

  • Her iki tarafı da yazdır
  • Kısa kenar veya uzun kenara göre çevir, yazıcıya bağlı olarak
  • Gerçek boyut
  • Otomatik ölçekleme yok
  • Doğru kağıt boyutu

4. Dijital Kopyalar İçin Yer İmleri Ekle

Eğer kitapçık dijital olarak da paylaşılacaksa, yer imleri gezinmeyi iyileştirir. Okuyucuların önemli bölümlere hızlıca atlamasına yardımcı olurlar.

Yer imleri özellikle şunlar için faydalıdır:

  • Uzun raporlar
  • Teknik kılavuzlar
  • Politika belgeleri
  • Ürün katalogları
  • Eğitim materyalleri

5. Açık Dosya Adları Kullanın

Çıktı dosyaları için açıklayıcı adlar kullanın, özellikle toplu modda belge oluştururken.

Örneğin:

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

Yaygın Hatalar ve Çözümler

Hata: ModuleNotFoundError: No module named ‘aspose’

Bu, Aspose.PDF paketinin mevcut Python ortamınızda yüklü olmadığı anlamına gelir.

Bunu şu şekilde düzeltin:

pip install aspose-pdf

Sanal bir ortam kullanıyorsanız, paketi kurmadan önce etkinleştirildiğinden emin olun.

Hata: Giriş PDF’si Bulunamadı

Betik giriş dosyasını bulamıyorsa, dosya yolunu kontrol edin.

Bunun yerine:

"input.pdf"

Mutlak bir yol kullanın:

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

Veya Linux/macOS’ta:

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

Hata: Kitapçık Çıktısı Beklenen Sırada Değil

Özel sol ve sağ sayfa dizilerini kullanıyorsanız, sayfa numaralarının kaynak PDF’teki sayfalarla eşleştiğinden emin olun.

Example:

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

Bu değerler, istediğiniz kitapçık sayfa düzenine göre seçilmelidir.

Hata: Yer İşaretleri Görünmüyor

Yer imleri PDF görüntüleyicinizde görünmüyorsa, görüntüleyicinin yer imi panelinin etkin olup olmadığını kontrol edin. Bazı PDF görüntüleyicileri varsayılan olarak yer imlerini gizler.

Ayrıca belge sayfa modunu anahatları gösterecek şekilde ayarlayabilirsiniz:

document.page_mode = pdf.PageMode.USE_OUTLINES

PDF’yi kaydetmeden önce bunu ekleyin:

document.save(output_pdf)

Python’da PDF Broşür Oluşturma: Son Kod

Aşağıdaki son kod bir PDF kitapçığı oluşturur, yer imleri ekler ve sonucu kaydeder:

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)

Sonuç

Bu öğreticide, Aspose.PDF for Python via .NET kullanarak Python’da bir PDF kitapçığı oluşturmayı öğrendiniz. SDK’yı kurdunuz, mevcut bir PDF’den bir kitapçık oluşturdunuz, sol ve sağ sayfa yerleşimini yapılandırdınız, isteğe bağlı yer imleri eklediniz ve son kitapçığı bir PDF dosyası olarak kaydettiniz.

PdfFileEditor.make_booklet() yöntemi, raporlar, kataloglar, kılavuzlar, broşürler ve yazdırılabilir belgeler için kitapçık oluşturmayı otomatikleştirmeniz gerektiğinde kullanışlıdır. Kitapçık oluşturmayı yer imleriyle birleştirerek, hem basılı hem de dijital dağıtım için uygun PDF dosyaları oluşturabilirsiniz.

Read More