Python Cloud SDK'yı kullanarak PDF Başlığına Metin ve Resim Nasıl Eklenir

Profesyonel ve görsel olarak çekici PDF belgeleri oluşturmaya gelince, başlığa resim ve metin ekleme yeteneği olmazsa olmaz bir özelliktir. Başlık bölümü, okuyuculara başlık, yazar ve tarih gibi temel bilgileri sağladığı için bir belgenin en önemli alanlarından biridir. Başlığa metin eklemek nispeten basit bir işlem olsa da, özellikle PDF belge oluşturmaya yeni başlayan Python geliştiricileri için resim eklemek daha zorlayıcı olabilir. Bu makalede, Python Cloud SDK kullanarak bir PDF belgesinin başlığına resim ve metin eklemenin nasıl yapılacağını inceleyeceğiz.

PDF başlığına resim, logo, belgeyi oluşturduğunuz tarih ve saat, belge başlığı, sürüm veya revizyon numarası, taslak, yazar adı ve bölüm adlarını ekleyebilirsiniz.

• PDF Belge Derlemesi için REST API
• Python kullanarak PDF Başlığına Metin Ekleme
• Python kullanarak PDF Başlığına Resim Ekleme
• cURL Komutunu Kullanarak PDF’ye Metin Başlığı Ekleme
• cURL Komutunu Kullanarak PDF’ye Resim Başlığı Ekleme

PDF Belge Derlemesi için REST API

Aspose.PDF Cloud SDK for Python, geliştiricilerin PDF dosyalarını programatik olarak düzenlemelerine olanak tanıyan çeşitli işlevler ve yöntemler sunar. Ayrıca, PDF belge başlıklarına resim ve metin eklemek için güçlü ve esnek bir araç seti sunar ve otomatik PDF belge işleme için Python uygulamalarına kolayca entegre edilebilir. Şimdi başlığa resim ekleme süreciyle ilgili olarak, resmin konumunu ve boyutlarını ve resmin görünmesi gereken sayfa numarasını belirtmeyi içerir. Benzer şekilde, başlığa metin eklemek, metin içeriğini, yazı tipi boyutunu ve diğer biçimlendirme seçeneklerini belirtmeyi gerektirir. SDK ayrıca, başlık içeriğinin hizalamasını ve konumlandırılmasını kontrol etme ve başlığın arka plan rengini belirtme seçenekleri de sunar.

Şimdi, öncelikle PIP ve GitHub deposu üzerinden ücretsiz olarak indirilebilen SDK’yı yüklememiz gerekiyor. SDK’nın en son sürümünü yüklemek için aşağıdaki komutu çalıştırmanız yeterli.

pip install asposepdfcloud
Kopyala

REST API’ye erişmek için kayıt olmanız ve kişisel kimlik bilgilerinizi almanız gerekir. İlgili bilgiler için lütfen Hızlı Başlangıç kılavuzuna göz atın.

Python kullanarak PDF Başlığına Metin Ekleme

SDK, belgenin başlık bölümüne metin dizeleri eklemenize olanak tanır ve bu gereksinim aşağıdaki adımlar kullanılarak gerçekleştirilebilir.

• Öncelikle, Client ID Client Secret’ı argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturun.
• İkinci olarak, giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı nesnesi oluşturun.
• Üçüncüsü, TextHeader örneğinin özelliklerini tanımlayan bir TextHeader nesnesi oluşturun.
• TextHeader için metin biçimlendirmesini ayarlamak amacıyla, ön plan rengini, yazı tipi boyutunu, yazı tipi adını vb. tanımlayacağımız bir TextState nesnesi oluşturun.
• Son olarak, PDF belgesine Metin Başlığı eklemek ve ortaya çıkan dosyayı Cloud depolamasına kaydetmek için postdocumenttextheader(..) yöntemini çağırın.

def addTextHeader():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # Metin Başlığını tanımlayan bir nesne oluşturun
        textHeader = asposepdfcloud.TextHeader()
        # arka planda üstbilgiyi işlemek için değeri ayarlayın
        textHeader.background = False
        # Metin başlığı için yatay hizalamayı merkez olarak ayarla
        textHeader.horizontal_alignment = 'Center'
        # başlığın opaklığını 0,5 olarak ayarla
        textHeader.opacity = 0.5
        # dönüş açısı yok
        textHeader.rotate = None
        textHeader.rotate_angle = 0
        # X ve Y girinti değerini ayarla
        textHeader.x_indent = 100
        textHeader.y_indent = 100
        # yakınlaştırma faktörünü 1.0 olarak ayarlayın
        textHeader.zoom = 1.0
        # Başlık içinde işlenecek Metin değeri
        textHeader.value = 'Aspose.PDF Cloud'

        # metnin biçimlendirmesini tanımlayan bir TextState örneği oluşturun
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 252,
              "G": 173,
              "B": 3},font_style=2)
        # TextState nesnesini TextHeader'a geçirin
        textHeader.text_state = textState

        # PDF belgesine Metin Başlığı eklemek için API'yi çağırın
        response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
        
        # konsolda yanıt kodunu yazdır
        print(response)
        # konsolda mesajı yazdır (isteğe bağlı)
        print('Text Header successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
Kopyala

Girdi ve ortaya çıkan PDF dosyaları awesomeTable.pdf ve awecomeTable-TextHeader.pdf adreslerinden indirilebilir.

Python kullanarak PDF Başlığına Resim Ekleme

PDF başlık bölümüne bir Görüntü nesnesi eklemek için lütfen aşağıdaki talimatları izleyin. Ortaya çıkan dosya bulut depolama alanına yüklenir.

• Öncelikle Client ID Client Secret’ı argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturun.
• İkinci olarak, giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı nesnesi oluşturun.
• Şimdi ImageHeader’ın özelliklerini tanımlayan bir ImageHeader nesnesi oluşturalım.
• Belirli sayfalarda başlığın nasıl görüntüleneceğini kontrol etmek için, startpagenumber ve endpagenumber isteğe bağlı parametrelerine değerler atanır.
• Son olarak, PDF belgesine Resim Başlığı eklemek ve sonuç dosyasını Cloud depolamasına kaydetmek için postdocumentimageheader(..) yöntemini çağırın. Başlığın yalnızca belgenin ilk iki sayfasına eklendiğine dikkat edin (kodda belirtildiği gibi).

def addImageHeader():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # ImageHeader örneğini oluştur
        imageHeader = asposepdfcloud.ImageHeader()
        # arka plan özelliğini doğru olarak ayarlayın
        imageHeader.background = True
        # yatay hizalamayı Sağ olarak ayarla
        imageHeader.horizontal_alignment = 'Right'
        imageHeader.opacity = 0.7
        imageHeader.rotate = None
        imageHeader.rotate_angle = 0
        imageHeader.x_indent = 10
        imageHeader.y_indent = 10
        imageHeader.zoom = .5
        # bulut depolamada bulunan resim dosyasının adı başlığa eklenecek
        imageHeader.file_name = 'Koala.jpg'
        # Başlıktaki resmin genişliği
        imageHeader.width = 120
        # Başlıktaki resmin yüksekliği
        imageHeader.height = 120
        imageHeader.left_margin = 0
        imageHeader.top_margin = 10
        imageHeader.right_margin = 10
        
        # Başlık eklemek için belgenin başlangıç sayfası
        startPage = 1
        # Başlık eklemek için belgenin son sayfası
        endPage = 2

        # PDF belgesine Resim başlığı eklemek ve sonuç dosyasını bulut depolama alanına kaydetmek için API'yi çağırın
        response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
        
        # konsoldaki pritn yanıt kodu
        print(response)
        
        # konsolda mesajı yazdır (isteğe bağlı)
        print('Image Header successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
Kopyala

Yukarıdaki örnekte oluşturulan kaynak dosyaları ve sonuç dosyası şu adresten indirilebilir:

• harikaTablo.pdf
• Koala.jpg
• awesomeTable-ImageHeader.pdf

cURL Komutunu Kullanarak PDF’ye Metin Başlığı Ekleme

cURL komutları, komut satırı terminalleri aracılığıyla REST API’lerine erişmek için kullanışlı bir mekanizma sağlar. Aspose.PDF Cloud da REST mimarisine göre geliştirildiğinden, cURL komutlarını kullanarak API’ye erişebiliriz. Bu yaklaşım, komut satırı araçlarıyla çalışmayı tercih eden veya PDF başlık düzenlemeyi daha büyük bir otomasyon iş akışına entegre etmesi gereken geliştiriciler için yararlı olabilir.

Şimdi REST API’yi kullanabilmek için, aşağıdaki komutu çalıştırarak istemci kimlik bilgilerinize dayalı bir JSON Web erişim belirteci (JWT) üretmemiz gerekiyor.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Kopyala

JWT Token’ı aldıktan sonra, lütfen belgenin 1. ve 2. sayfalarındaki başlık bölümüne metin eklemek için aşağıdaki komutu kullanmayı deneyin.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/text?startPageNumber=1&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": false,  \"HorizontalAlignment\": \"Center\",  \"Opacity\": 0.5,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 100,  \"YIndent\": 10,  \"Zoom\": 1.0,  \"TextAlignment\": \"None\",  \"Value\": \"Aspose.PDF Cloud\",  \"TextState\": {    \"FontSize\": 15,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 252,      \"G\": 173,      \"B\": 3    },    \"BackgroundColor\": {      \"A\": 10,      \"R\": 0,      \"G\": 0,      \"B\": 0    }  },  \"LeftMargin\": 0,  \"TopMargin\": 0,  \"RightMargin\": 0}"
Kopyala

cURL Komutunu Kullanarak PDF’ye Resim Başlığı Ekleme

Lütfen bir PDF belgesine Resim Başlığı eklemek ve ortaya çıkan dosyayı bulut depolama alanına kaydetmek için aşağıdaki cURL komutunu kullanmayı deneyin. Aşağıdaki komutta, opaklığın 0,7, yakınlaştırma faktörünün 0,5 ve resim yüksekliği ve genişlik özelliklerinin 120 puan olarak tanımlandığı belgenin 1. ve 2. sayfasına resim başlığı eklenir.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/image?startPageNumber=1&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"Right\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 10,  \"YIndent\": 10,  \"Zoom\": .5,  \"FileName\": \"Koala.jpg\",  \"Width\": 120,  \"Height\": 120,  \"LeftMargin\": 0,  \"TopMargin\": 10,  \"RightMargin\": 10}"
Kopyala

Çözüm

Sonuç olarak, bir PDF belgesinin başlığına bir resim ve metin eklemek, belgelerinizin görsel çekiciliğini ve markasını artırabilecek kullanışlı bir özelliktir. Aspose.PDF for Python Cloud SDK ile, bu sadece birkaç satır kodla gerçekleştirilebilecek basit bir görevdir. Fatura, rapor veya başlık gerektiren başka bir belge oluşturuyor olun, bu özellik çıktınızın kalitesini artırırken size zaman ve emek kazandırabilir. Aspose.PDF for Python Cloud SDK’yı kullanmanın yanı sıra, cURL komutlarını kullanarak PDF başlıklarına resim ve metin eklemenin de mümkün olduğunu öğrendik.

Bu makalenin, bu işlevselliği Python uygulamanıza eklemek için gereken tüm rehberliği ve ilhamı sağladığını umuyoruz.

Faydalı Bağlantılar

• SDK’nın kaynak kodu

• Ücretsiz müşteri destek forumu

• Geliştirici Kılavuzu

• API Başvurusu

İlgili Makaleler

Aşağıdaki makaleleri ziyaret ederek şunları öğrenmenizi öneririz:

• Python REST API’yi kullanarak PDF’yi Excel Çalışma Kitabına Dönüştürün
• Python Cloud SDK kullanarak HTML’yi PDF’ye dönüştürme – Python’da URL’den PDF’ye
• Python Cloud SDK’yı kullanarak Word’ü JPG’ye nasıl dönüştürebilirsiniz
• Python REST API kullanarak PDF’ye Metin veya Resim filigranı ekleyin