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

Ön Koşullar

IronPDF kullanarak PDF'lere açıklama eklemeye başlamadan önce, aşağıdaki gereksinimleri karşıladığınızdan emin olun:

1. Python: Python'un bilgisayarınıza yüklü olduğundan emin olun. En son sürümü indirmek için resmi Python web sitesini ziyaret edin.
2. Bir IDE Yükleyin: IronPDF ile PDF'lerinizde çalışmaya başlamadan önce bir IDE yüklemeniz gerekecek. PyCharm, Python için popüler bir entegre geliştirme ortamı (IDE) olarak önerilir. Alternatif olarak, PyCharm kullanmak istemiyorsanız başka bir IDE seçebilirsiniz.

3. IronPDF Kütüphanesi: IronPDF kütüphanesini terminalde şu komutu kullanarak yükleyin:

   pip install ironpdf

   IronPDF paketini kurun

4. .NET 6.0 Runtime: IronPDF for Python, doğru çalışması için .NET 6.0 teknolojisine dayanır. Bu, bilgisayarınızda .NET 6.0 runtime yüklü olması gerektiği anlamına gelir. Çoğunlukla, proje çalıştırma sırasında IronPDF bağımlılıkları ile otomatik olarak yüklenecektir.

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

Adım 1: IronPDF Kütüphanesini İçe Aktarma

İlk satır, PDF işleme ve açıklama için gerekli sınıflara ve işlevlere erişim sağlayarak IronPDF kütüphanesinden gerekli modülleri içe aktarır.

from ironpdf import PdfDocument, TextAnnotation

from ironpdf import PdfDocument, TextAnnotation

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

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

# 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'ye eklenecek metin açıklaması için çeşitli özellikler 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

Her bir özelliğin temsil ettiği şey şudur:

• Açıklama: Açıklama değişkenini ayarlama ve açıklama türünü belirtme.
• 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, bir "yapışkan not" yorumunu andırır.
• Simge: Açıklamayla ilişkilendirilen görsel simge (bu durumda, bir yardım simgesi).
• X ve Y: Sayfanın sol üst köşesindeki açıklamanın koordinatları.
• Genişlik ve Yükseklik: Açıklamanın sınır kutusunun boyutları.
• Saydamlık: Açıklamanın opaklık seviyesi (0 ile 1 arasında değişir).
• Yazdırılabilir: Açıklamanın yazdırılıp yazdırılmaması gerektiği.
• Gizli: Açıklamanın başlangıçta gizli olup olmadığı.
• Varsayılan Olarak Açık: Açıklamanın varsayılan olarak açık olup olmadığı.
• Yalnızca Okunur: Açıklamanın 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: Açıklamayı PDF'ye 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'yi Kaydetme

Son olarak, eklenen açıklama ile 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: Scripti Çalıştırma

Şimdi, tüm kodu bir araya getirelim ve daha önce oluşturduğumuz PyCharm projesinde scripti çalıştıralım.

1. PyCharm içinde scripti çalıştırmak için, script düzenleyicinin herhangi bir yerinde sağ tıklayın ve annotatePDF Çalıştır seçeneğini seçin.
2. PyCharm scripti çalıştıracak ve olası hata mesajlarını IDE'nin altındaki Çalıştır konsolunda göreceksiniz.
3. Script tamamlandıktan sonra, açıklamalı PDF'yi ('annotated.pdf') projenizle aynı dizinde bulabilirsiniz.

Çıktı:

Çıktı PDF dosyası