Master PDF Modifikasyonu: Python ile PDF Alt Bilgisine Resim ve Metin Nasıl Eklenir

PDF altbilgi bölümüne resim ve metin eklemek, belgelere markalama veya yasal bilgiler eklemek gibi çeşitli senaryolarda yararlı olabilir. Birçok sektörde, bir belgenin her sayfasının altına bir şirket logosu veya feragatname eklemek yaygın bir gerekliliktir. Diğer durumlarda, belgeyi düzenlemeye veya tanımlamaya yardımcı olmak için sayfa numaraları veya diğer meta veriler ekleme ihtiyacı olabilir. Belirli kullanım durumu ne olursa olsun, bir PDF belgesinin altbilgi bölümüne resim ve metin ekleme yeteneği birçok işletme ve kuruluş için önemli bir özelliktir. Bu makalede, Python Cloud SDK kullanarak bir PDF belgesinin altbilgi bölümüne resim ve metin eklemenin nasıl yapılacağını inceleyeceğiz.

Altbilgi için kullanılan bir diğer terim koşu ayağıdır. Yayıncılık sektöründe çok kullanılır ve bu şekilde adlandırılmasının sebebi, makalenin kısaltılmış bir versiyonunu veya makale hakkında başka bilgi parçalarını içermesidir.

Python Cloud SDK’sı
Python kullanarak PDF’ye Metin Alt Bilgisi Ekleme
Python kullanarak PDF’ye Resim Alt Bilgisi Ekleme
cURL Komutunu Kullanarak PDF’ye Metin Alt Bilgisi Ekleme
cURL Komutunu Kullanarak PDF’e Resim Alt Bilgisi Ekleme

Python Cloud SDK’sı

Aspose.PDF for Python Cloud SDK, PDF belgeleriyle çalışmak için bir dizi güçlü özellik sunar; bunlar arasında PDF belgesinin altbilgi bölümüne resim ve metin ekleme yeteneği de bulunur. Bu SDK, çeşitli PDF ile ilgili görevleri programatik olarak gerçekleştirmeyi kolaylaştıran basit ve sezgisel bir arayüz sunar. Bu SDK’yı kullanarak, herhangi bir PDF belgesinin altbilgisine hızlı ve kolay bir şekilde özel metin veya resim ekleyebilir, belgelerinize profesyonel ve özelleştirilmiş bir görünüm kazandırabilirsiniz.

SDK PIP ve GitHub deposu üzerinden indirilebilir. Ancak, sisteme en son SDK sürümünü yüklemek için terminal/komut isteminde aşağıdaki komutu çalıştırabilirsiniz.

pip install asposepdfcloud

Bir sonraki önemli adım, Cloud panosundan istemci kimlik bilgilerini edinmektir. GitHub veya Google hesabınız varsa, sadece Kaydolun veya Yeni Hesap Oluştur düğmesine tıklayın ve gerekli bilgileri sağlayın.

Müşteri kimlik bilgileri — Resim 1:- Aspose.Cloud Pano’sunda İstemci Kimlik Bilgileri.

Python kullanarak PDF’ye Metin Alt Bilgisi Ekleme

Python kod parçacığını kullanarak PDF belgesine metin alt bilgisi eklemek için lütfen aşağıda verilen adımları izleyin.

İlk adım, argüman olarak İstemci Kimliği İstemci Gizli Anahtarını gerektiren bir ApiClient sınıfı örneği oluşturmaktır.
İkinci olarak, giriş argümanı olarak ApiClient nesnesini gerektiren bir PdfApi sınıfı örneği oluşturun.
Üçüncüsü, yatay hizalamayı Center, Opacity değerini 0.7, döndürme açısını 356 ve alt kenar boşluğunu 5 olarak belirlediğimiz bir TextFooter nesnesi oluşturalım.
TextFooter 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.
Şimdi PDF belgesinin başlangıç ve bitiş sayfasını tanımlayan iki isteğe bağlı parametrenin değerlerini ayarlayarak Metin Altbilgisi’ni yerleştirmemiz gerekiyor.
Son olarak, PDF belgesine Metin Altbilgisi eklemek ve ortaya çıkan dosyayı Cloud depolamasına kaydetmek için postdocumenttextfooter(..) yöntemini çağırın.

def addTextFooter():
    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)

        # PDF dosyasını girin
        input_file = 'marketing.pdf'

        # TextFooter örneği oluştur
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # Altbilgi için yatay hizalamayı Orta olarak ayarla
        textFooter.horizontal_alignment = 'Center'
        # altbilginin opaklığını 0.7 olarak ayarlayın
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # döndürme açısını 5 derece olarak ayarlayın
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # Altbilgi bölümünde görüntülenecek metinsel değer
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # metnin biçimlendirmesini tanımlayan bir TextState örneği oluşturun
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 66,
              "G": 111,
              "B": 245},
              background_color= {
              "A": 10,
              "R": 179,
              "G": 245,
              "B": 66},
              font_style=1)
        # TextState nesnesini TextFooter'a atayın
        textFooter.text_state = textState
        
        # PDF'nin Footer için başlangıç sayfası
        startPage = 2
        # PDF'nin Altbilgi için son sayfası
        endPage = 3

        # PDF dosyasının 2. ve 3. sayfasına Metin altbilgisi eklemek için API'yi çağırın
        response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
        
        # konsolda yanıt kodunu yazdır
        print(response)
        
        # konsolda mesajı yazdır (isteğe bağlı)
        print('Text Footer 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)

Metin Altbilgisi önizlemesi — Resim 2:- PDF’e eklenen TextFooter’ın önizlemesi.

Lütfen girdiyi marketing.pdf ve ortaya çıkan marketing-TextFooter.pdf dosyasını indirmek için aşağıdaki bağlantıyı ziyaret edin.

API ayrıca bir PDF dosyasına Resim altbilgisi ekleme olanağı da sağlar. Bu gereksinimi karşılamak için lütfen aşağıda verilen talimatları izleyin.

İlk adım, argüman olarak İstemci Kimliği İstemci Gizli Anahtarını gerektiren bir ApiClient sınıfı örneği oluşturmaktır.
İkinci olarak, giriş argümanı olarak ApiClient nesnesini gerektiren bir PdfApi sınıfı örneği oluşturun.
Üçüncüsü, yatay hizalamayı Center, Opacity değerini 0.7, döndürme açısını 10 olarak belirlediğimiz, resim dosya adını, kenar boşluğu ayrıntılarını ve diğer özellikleri belirttiğimiz bir ImageFooter nesnesi oluşturun.
Sadece belgenin ilk sayfasına Altbilgi eklememiz gerektiğinden, başlangıçsayfanumarası ve bitişsayfanumarası için isteğe bağlı parametrelere değerler ayarladık.
Son olarak, PDF belgesine Metin Altbilgisi eklemek ve ortaya çıkan dosyayı Cloud depolamasına kaydetmek için postdocumentimagefooter(..) yöntemini çağırın.

def addImageFooter():
    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)

        # PDF belgesini girin
        input_file = 'marketing.pdf'
        
        # ImageFooter örneği oluştur
        imageFooter = asposepdfcloud.ImageFooter()
        
        # PDF içeriğinin üstünde başlığı göster
        imageFooter.background = False
        # hizalamayı sola ayarla
        imageFooter.horizontal_alignment = 'Left'
        # opaklığı %70 olarak ayarla
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # giriş resim dosyası
        imageFooter.file_name = 'Koala.jpg'
        # resim genişliği ve yükseklik ayrıntılarını ayarlayın
        imageFooter.width = 100
        imageFooter.height = 100
        # altbilgi görseli için kenar boşluğu ayrıntılarını belirtin
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # Altbilgi eklemek için belgenin başlangıç sayfası
        startPage = 1
        # Altbilgi eklemek için belgenin başlangıç sayfası
        endPage = 1

        # PDF dosyasında resim alt bilgisini oluşturmak için API'yi çağırın
        response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
        
        # konsolda yanıt kodunu yazdır
        print(response)
        
        # konsolda mesajı yazdır (isteğe bağlı)
        print('Image Footer 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)

PDF'de Resim Alt Bilgisi — Resim 3:- PDF formatında Resim Alt Bilgisinin Önizlemesi.

Yukarıdaki örnekle oluşturulan sonuç dosyası marketing-ImageFooter.pdf adresinden indirilebilir.

cURL Komutunu Kullanarak PDF’ye Metin Alt Bilgisi Ekleme

cURL komutlarının ve Aspose.PDF Cloud’un PDF alt bilgisine metin ve resim eklemek için kullanılması çeşitli avantajlar sunar. İlk olarak, zaman alıcı ve hatalara açık olabilen PDF belgelerinin manuel olarak düzenlenmesi ihtiyacını ortadan kaldırır. İkinci olarak, yazı tipini, boyutunu, rengini ve metnin konumunu değiştirme olanağıyla başlık metninin kolayca özelleştirilmesine olanak tanır. Üçüncüsü, kullanıcıların aynı anda birden fazla PDF belgesine metin eklemesini sağlayarak zamandan tasarruf sağlar ve verimliliği artırır. Son olarak, bu yaklaşım PDF başlığına metin eklemek için güvenli ve güvenilir bir yöntem sunar ve tüm veriler güvenli bir bağlantı üzerinden iletilir ve güvenli sunucularda işlenir.

Şimdi ön koşul olarak aşağıdaki komutu çalıştırarak bir JSON Web Token (JWT) oluşturun.

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"

Artık JWT token’ını ürettiğimize göre, PDF dosyasına TextFooter eklemek için aşağıdaki komutu çalıştırmamız gerekiyor.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/text?startPageNumber=2&endPageNumber=3" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"Center\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 5,  \"XIndent\": 100,  \"YIndent\": 100,  \"Zoom\": 0.8,  \"Value\": \"Aspose.PDF Cloud SDK for Python\",  \"TextState\": {    \"FontSize\": 15,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 66,      \"G\": 111,      \"B\": 245    },    \"BackgroundColor\": {      \"A\": 10,      \"R\": 179,      \"G\": 245,      \"B\": 66    },    \"FontStyle\": \"Regular\"  },  \"BottomMargin\": 3,  \"LeftMargin\": 3,  \"RightMargin\": 3}"

PDF dosyasına resim başlığını eklemek için cURL komutunu kullanarak lütfen aşağıdaki komutu çalıştırın.

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

Çözüm

Sonuç olarak, bir PDF belgesinin altbilgi bölümüne resim ve metin eklemek, markalama, yasal uyumluluk ve belge organizasyonu gibi çeşitli amaçlar için yararlı bir özellik olabilir. Aspose.PDF for Python Cloud SDK, bu özelliği Python uygulamanızda uygulamak için kullanışlı ve güçlü bir yol sağlar. Öte yandan, cURL komutlarını Aspose.PDF Cloud API ile kullanmak, özelliği çeşitli programlama dillerine ve ortamlara entegre etmek için esneklik ve basitlik sunabilir. Seçtiğiniz yaklaşım ne olursa olsun, Aspose.PDF Cloud, PDF belgelerinizin altbilgi bölümüne resim ve metin eklemek için sağlam ve güvenilir araçlar sunar.

Faydalı Bağlantılar

Ürün dokümantasyonu

API Başvurusu

SDK’nın tam kaynak kodu

Ücretsiz teknik destek forumu

İlgili Makaleler

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

Python Cloud SDK’sı#

Python kullanarak PDF’ye Metin Alt Bilgisi Ekleme#

Python kullanarak PDF’ye Resim Alt Bilgisi Ekleme#

cURL Komutunu Kullanarak PDF’ye Metin Alt Bilgisi Ekleme#

cURL Komutunu Kullanarak PDF’e Resim Alt Bilgisi Ekleme#

Çözüm#

Faydalı Bağlantılar#

İlgili Makaleler#