IronPDF Kullanarak Python'da Kolaylıkla PDF'leri Açıklama

Önkoşullar

PDF'leri IronPDF kullanarak açıklamaya başlamadan önce, aşağıdaki ön koşulların yerinde olduğundan emin olun:

1. Python: Bilgisayarınızda Python'un yüklü olduğundan emin olun. En son sürümü indirmek için resmi Python web sitesini ziyaret edin.
2. IDE Yükleyin: IronPDF ile PDF'ler üzerinde çalışmaya başlamadan önce bir IDE yüklemeniz gerekecek. Python için popüler bir entegre geliştirme ortamı (IDE) olan PyCharm önerilir. Alternatif olarak, PyCharm kullanmak istemiyorsanız kendi tercihinize göre herhangi bir IDE kullanabilirsiniz.

3. IronPDF Kutuphanesi: Terminalde şu komutu kullanarak IronPDF kutuphanesini yükleyin:

   pip install IronPDF

   pip install IronPDF

   SHELL

   IronPDF paketini yükleyin

4. .NET 6.0 Çalışma Zamanı: IronPDF for Python, düzgün çalışabilmek için .NET 6.0 teknolojisine dayanır. Bu, IronPDF for Python'u etkili bir şekilde kullanmak için bilgisayarınıza .NET 6.0 runtime yüklemiş olmanız gerektiği anlamına gelir. Muhtemelen, proje yürütme sırasında IronPDF bağımlılıkları ile birlikte otomatik olarak yüklenecektir.

Not: IronPDF'i pip (Python Paket Yöneticisi) kullanarak yüklerken, IronPDF kurulum yolunun sistemin PATH değişkenine dahil edildiğinden emin olmak önemlidir. Bu adım, pip'in kurulum ve kullanım sırasında IronPDF paketini ve ilişkili bileşenlerini bulabilmesini sağlamak için kritiktir.

Adım 1: IronPDF Kutuphanesini İçe Aktarma

İlk satır, PDF manipülasyonu ve açıklama için gerekli sınıflara ve işlevlere erişim sağlayan IronPDF kutuphanesinden gerekli modüllerin içe aktarılmasını gerçekleştirir.

from ironpdf import PdfDocument, TextAnnotation

from ironpdf import PdfDocument, TextAnnotation

Adım 2: Mevcut Bir PDF Belgesini Yükleme

Bu adımda, mevcut bir 'existing.pdf' adlı PDF dosyası PdfDocument sınıfı kullanılarak yüklenir. Bu belge, açıklamalar eklemek için temel olarak kullanılacaktır. Ayrıca, desteklenen açıklama türlerinin ekleneceği sayfa dizinini ayarlayın.

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

Adım 3: Açıklama Parametrelerini Ayarlama

Aşağıdaki kod satırları, PDF'e eklenecek metin açıklaması için çeşitli özellikleri tanımlar. Bu özellikler, açıklamanın görünümü ve davranışı hakkında bilgi sağlar:

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

İşte her bir özelliğin neyi temsil ettiğini:

• Açıklama: Açıklama değişkenini ayarlama ve açıklama türünü tanımlama.
• Başlık: Yeni açıklamanın ana başlığı.
• Konu: Açıklama hakkında bir alt başlık veya ek bilgi.
• İçerik: Açıklamanın ana içeriği, "yapışkan not" yorumuna benzer.
• Simge: Açıklama ile ilişkilendirilen görsel simge (bu durumda, bir yardım simgesi).
• X ve Y: Sayfa üzerindeki açıklamanın sol üst köşesinin koordinatları.
• Genişlik ve Yükseklik: Açıklamanın sınır kutusunun boyutları.
• Opaklık: Açıklamanın opaklık seviyesi (0 ile 1 arasında değişir).
• Yazdırılabilir: Açıklamanın basılıp basılmayacağı.
• Gizli: Açıklamanın başlangıçta gizli olup olmadığı.
• Varsayılan Olarak Açık: Açıklamanın varsayılan olarak açık olup olmayacağı.
• Sadece Okunabilir: Açıklamanın yalnızca okunabilir olup olmadığı.
• Döndürülebilir: Açıklamanın döndürülebilir olup olmadığı.

Daha fazla açıklama türü ve özellikleri için bu kod örnekleri sayfasını ziyaret edin.

Adım 4: PDF'e Açıklama Ekleme

Aşağıdaki kod satırı, oluşturulan metin açıklamasını PDF belgesinin belirli bir sayfasına ekler:

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

Adım 5: Açıklamalı PDF'i Kaydetme

Son olarak, eklenen açıklamalarla güncellenen PDF belgesi SaveAs yöntemi kullanılarak kaydedilir:

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

Adım 6: Betiği Çalıştırma

Şimdi, tüm kodu birleştirelim ve önceki aşamada oluşturulan PyCharm projesinde betiği çalıştıralım.

1. Betiği PyCharm içinde çalıştırmak için, script editörünün herhangi bir yerine sağ tıklayın ve annotatePDF özelliğini çalıştırın.
2. PyCharm betiği çalıştıracak ve çıktıyı ve olası hataları IDE'nin altındaki Çalıştır konsolunda göreceksiniz.
3. Betik tamamlandığında, açıklamalı PDF'i ('annotated.pdf') projenizle aynı klasörde bulabilirsiniz.

Çıktı:

Çıkış PDF dosyası