დაამატეთ ტექსტი და სურათი PDF სათაურში

რაც შეეხება პროფესიონალური და ვიზუალურად მიმზიდველი PDF დოკუმენტების შექმნას, სათაურში სურათებისა და ტექსტის დამატების შესაძლებლობა აუცილებელი ფუნქციაა. სათაურის განყოფილება არის დოკუმენტის ერთ-ერთი ყველაზე მნიშვნელოვანი სფერო, რადგან ის მკითხველს აწვდის აუცილებელ ინფორმაციას, როგორიცაა სათაური, ავტორი და თარიღი. მიუხედავად იმისა, რომ სათაურში ტექსტის დამატება შედარებით მარტივი პროცესია, სურათების დამატება შეიძლება უფრო რთული იყოს, განსაკუთრებით Python-ის დეველოპერებისთვის, რომლებიც ახალი არიან PDF დოკუმენტების გენერირებაში. ამ სტატიაში ჩვენ განვიხილავთ, თუ როგორ დავამატოთ სურათი და ტექსტი PDF დოკუმენტის სათაურში Python Cloud SDK-ის გამოყენებით.

PDF სათაურში შეგიძლიათ დაამატოთ სურათები, ლოგოები, დოკუმენტის შექმნის თარიღი და დრო, დოკუმენტის სათაური, ვერსიის ან რევიზიის ნომერი, მონახაზი, ავტორის სახელი და თავების სახელები.

REST API PDF დოკუმენტის ასამბლეისთვის

Aspose.PDF Cloud SDK for Python გთავაზობთ მრავალფეროვან ფუნქციებსა და მეთოდებს, რომლებიც დეველოპერებს საშუალებას აძლევს PDF ფაილებით პროგრამულად მანიპულირება. ის ასევე უზრუნველყოფს ინსტრუმენტების მძლავრ და მოქნილ კომპლექტს PDF დოკუმენტის სათაურებში სურათების და ტექსტის დასამატებლად და ადვილად შეიძლება იყოს ინტეგრირებული პითონის აპლიკაციებში PDF დოკუმენტების ავტომატური დამუშავებისთვის. რაც შეეხება სათაურში გამოსახულების დამატების პროცესს, ის გულისხმობს სურათის ადგილმდებარეობისა და ზომების დაზუსტებას, ასევე გვერდის ნომრის მითითებას, რომელზეც სურათი უნდა გამოჩნდეს. ანალოგიურად, სათაურში ტექსტის დამატება მოითხოვს ტექსტის შინაარსის, შრიფტის ზომისა და ფორმატირების სხვა ვარიანტების მითითებას. SDK ასევე გთავაზობთ ვარიანტებს სათაურის შინაარსის გასწორებისა და პოზიციონირების გასაკონტროლებლად, ასევე სათაურის ფონის ფერის მითითებისთვის.

ახლა, ჯერ ჩვენ უნდა დავაყენოთ SDK, რომელიც თავისუფლად არის ხელმისაწვდომი PIP და GitHub საცავიდან ჩამოსატვირთად. უბრალოდ შეასრულეთ შემდეგი ბრძანება SDK-ის უახლესი ვერსიის დასაყენებლად.

pip install asposepdfcloud

REST API-ზე წვდომისთვის, თქვენ უნდა დარეგისტრირდეთ და მიიღოთ თქვენი პირადი რწმუნებათა სიგელები. გთხოვთ, გადახედოთ სწრაფი დაწყების სახელმძღვანელო შესაბამისი ინფორმაციისთვის.

დაამატეთ ტექსტი PDF სათაურში პითონის გამოყენებით

SDK გაძლევთ საშუალებას დაამატოთ ტექსტის სტრიქონები დოკუმენტის სათაურის განყოფილებაში და ეს მოთხოვნა შეიძლება შესრულდეს შემდეგი ნაბიჯების გამოყენებით.

  • უპირველეს ყოვლისა, შექმენით ApiClient კლასის ინსტანცია არგუმენტებად Client ID Client Secret-ის მიწოდებისას.
  • მეორეც, შექმენით PdfApi კლასის ობიექტი, რომელიც შეყვანის არგუმენტად იღებს ApiClient ობიექტს.
  • მესამე, შექმენით TextHeader-ის ობიექტი, რომელიც განსაზღვრავს TextHeader ინსტანციის თვისებებს.
  • იმისათვის, რომ დააყენოთ ტექსტის ფორმატირება TextHeader-ისთვის, შექმენით TextState ობიექტი, სადაც განვსაზღვრავთ წინა პლანის ფერს, შრიფტის ზომას, შრიფტის სახელს და ა.შ.
  • და ბოლოს, დარეკეთ postdocumenttextheader(..) მეთოდს, რათა დაამატოთ ტექსტის სათაური PDF დოკუმენტში და შეინახოთ შედეგიანი ფაილი Cloud საცავში.
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)

        # შექმენით PdfApi ინსტანცია PdfApiClient-ის არგუმენტად გადაცემისას
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # შექმენით ობიექტი, რომელიც განსაზღვრავს ტექსტის სათაურს
        textHeader = asposepdfcloud.TextHeader()
        # დააყენეთ მნიშვნელობა სათაურის ფონზე გამოსატანად
        textHeader.background = False
        # დააყენეთ ტექსტის სათაურის ჰორიზონტალური გასწორება ცენტრში
        textHeader.horizontal_alignment = 'Center'
        # დააყენეთ სათაურის გამჭვირვალობა 0.5-ად
        textHeader.opacity = 0.5
        # ბრუნვის კუთხე არ არის
        textHeader.rotate = None
        textHeader.rotate_angle = 0
        # დააყენეთ X და Y შეწევის მნიშვნელობა
        textHeader.x_indent = 100
        textHeader.y_indent = 100
        # დააყენეთ მასშტაბის კოეფიციენტი 1.0
        textHeader.zoom = 1.0
        # სათაურის შიგნით გამოსატანი ტექსტის მნიშვნელობა
        textHeader.value = 'Aspose.PDF Cloud'

        # შექმენით TextState-ის მაგალითი, რომელიც განსაზღვრავს ტექსტის ფორმატირებას
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 252,
              "G": 173,
              "B": 3},font_style=2)
        # გადასცეს TextState ობიექტი TextHeader-ს
        textHeader.text_state = textState

        # დაურეკეთ API-ს, რათა დაამატოთ ტექსტის სათაური PDF დოკუმენტში
        response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
        
        # დაბეჭდეთ პასუხის კოდი კონსოლში
        print(response)
        # შეტყობინების დაბეჭდვა კონსოლში (სურვილისამებრ)
        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)
ტექსტის სათაური PDF-ში

სურათი 2: - ტექსტის სათაურის გადახედვა PDF დოკუმენტში.

შეყვანის და შედეგად მიღებული PDF ფაილების ჩამოტვირთვა შესაძლებელია awesomeTable.pdf-დან და awecomeTable-TextHeader.pdf-დან.

დაამატეთ სურათი PDF სათაურში Python-ის გამოყენებით

გთხოვთ, მიჰყევით ქვემოთ მოცემულ ინსტრუქციას, რომ დაამატოთ Image ობიექტი PDF სათაურის განყოფილებაში. შედეგად მიღებული ფაილი იტვირთება ღრუბლოვან საცავში.

  • უპირველეს ყოვლისა, შექმენით ApiClient კლასის ინსტანცია არგუმენტებად Client ID Client Secret-ის მიწოდებისას.
  • მეორეც, შექმენით PdfApi კლასის ობიექტი, რომელიც შეყვანის არგუმენტად იღებს ApiClient ობიექტს.
  • ახლა შექმენით ImageHeader-ის ობიექტი, რომელიც განსაზღვრავს ImageHeader-ის თვისებებს.
  • გარკვეულ გვერდებზე სათაურის რენდერის გასაკონტროლებლად, მნიშვნელობები ენიჭება startpagenumber და endpagenumber არასავალდებულო პარამეტრებს.
  • დაბოლოს, გამოიძახეთ postdocumentimageheader(..) მეთოდი, რომ დაამატოთ Image Header PDF დოკუმენტში და შეინახოთ შედეგიანი ფაილი Cloud საცავში. გაითვალისწინეთ, რომ სათაური ემატება მხოლოდ დოკუმენტის პირველ ორ გვერდს (როგორც მითითებულია კოდში).
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)

        # შექმენით PdfApi ინსტანცია PdfApiClient-ის არგუმენტად გადაცემისას
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # შექმენით ImageHeader მაგალითი
        imageHeader = asposepdfcloud.ImageHeader()
        # დააყენეთ ფონის თვისება, როგორც true
        imageHeader.background = True
        # დააყენეთ ჰორიზონტალური გასწორება, როგორც მარჯვნივ
        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
        # სათაურში დასამატებელი გამოსახულების ფაილის სახელი, რომელიც ხელმისაწვდომია ღრუბლოვან საცავში
        imageHeader.file_name = 'Koala.jpg'
        # სურათის სიგანე სათაურში
        imageHeader.width = 120
        # სურათის სიმაღლე სათაურში
        imageHeader.height = 120
        imageHeader.left_margin = 0
        imageHeader.top_margin = 10
        imageHeader.right_margin = 10
        
        # სათაურის დასამატებლად დოკუმენტის საწყისი გვერდი
        startPage = 1
        # სათაურის დასამატებლად დოკუმენტის ბოლო გვერდი
        endPage = 2

        # დაურეკეთ API-ს, რომ დაამატოთ გამოსახულების სათაური PDF დოკუმენტში და შეინახოთ მიღებული ფაილი ღრუბლოვან საცავში
        response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
        
        # pritn პასუხის კოდი კონსოლში
        print(response)
        
        # შეტყობინების დაბეჭდვა კონსოლში (სურვილისამებრ)
        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)
წარწერა

Image 3:- Preview of Image Header added in PDF.

ზემოთ მოყვანილ მაგალითში გენერირებული საწყისი ფაილები და შედეგიანი ფაილი შეიძლება გადმოწეროთ

ტექსტის სათაურის დამატება PDF-ში cURL ბრძანების გამოყენებით

cURL ბრძანებები უზრუნველყოფს მოსახერხებელ მექანიზმს REST API-ებზე წვდომისთვის ბრძანების ხაზის ტერმინალების მეშვეობით. ვინაიდან Aspose.PDF Cloud ასევე შემუშავებულია REST არქიტექტურის მიხედვით, ასე რომ, ჩვენ ასევე შეგვიძლია წვდომა API-ზე cURL ბრძანებების გამოყენებით. ეს მიდგომა შეიძლება სასარგებლო იყოს დეველოპერებისთვის, რომლებსაც ურჩევნიათ იმუშაონ ბრძანების ხაზის ინსტრუმენტებთან ან ვისაც სჭირდება PDF სათაურის რედაქტირების ინტეგრირება უფრო დიდ ავტომატიზაციის სამუშაო ნაკადში.

ახლა იმისათვის, რომ გამოვიყენოთ REST API, ჩვენ უნდა შევქმნათ JSON Web accessToken (JWT) თქვენი კლიენტის რწმუნებათა სიგელის საფუძველზე შემდეგი ბრძანების შესრულებით.

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"

მას შემდეგ, რაც ჩვენ გვაქვს JWT Token, გთხოვთ, გამოიყენოთ შემდეგი ბრძანება, რომ დაამატოთ ტექსტი დოკუმენტის სათაურის განყოფილებაში პირველ და მე-2 გვერდებზე.

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}"

სურათის სათაურის დამატება PDF-ში cURL ბრძანების გამოყენებით

გთხოვთ, გამოიყენოთ შემდეგი cURL ბრძანება, რომ დაამატოთ გამოსახულების სათაური PDF დოკუმენტში და შეინახოთ მიღებული ფაილი ღრუბლოვან საცავში. შემდეგ ბრძანებაში გამოსახულების სათაური დოკუმენტის 1-ლი და მე-2 გვერდებზე, სადაც გამჭვირვალობა განისაზღვრება როგორც 0.7, მასშტაბის კოეფიციენტი არის 0.5 და გამოსახულების სიმაღლისა და სიგანის თვისებები განისაზღვრება როგორც 120 ქულა.

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}"

დასკვნა

დასასრულს, PDF დოკუმენტის სათაურში გამოსახულების და ტექსტის დამატება სასარგებლო ფუნქციაა, რომელსაც შეუძლია გააუმჯობესოს თქვენი დოკუმენტების ვიზუალური მიმზიდველობა და ბრენდინგი. Python-ისთვის Aspose.PDF Cloud SDK-ით, ეს მარტივი დავალებაა, რომელიც შესრულდება მხოლოდ რამდენიმე ხაზის კოდით. მიუხედავად იმისა, ქმნით ინვოისებს, ანგარიშებს ან ნებისმიერ სხვა დოკუმენტს, რომელიც საჭიროებს სათაურს, ამ ფუნქციას შეუძლია დაზოგოს თქვენი დრო და ძალისხმევა და გააუმჯობესოს თქვენი პროდუქტის ხარისხი. Python-ისთვის Aspose.PDF Cloud SDK-ის გამოყენების გარდა, ჩვენ ასევე ვისწავლეთ, რომ ასევე შესაძლებელია სურათების და ტექსტის დამატება PDF სათაურებში cURL ბრძანებების გამოყენებით.

ვიმედოვნებთ, რომ ამ სტატიამ მოგაწოდეთ ყველა საჭირო მითითება და შთაგონება ამ ფუნქციის დასამატებლად თქვენს Python აპლიკაციაში.

სასარგებლო ლინკები

დაკავშირებული სტატიები

ჩვენ გირჩევთ ეწვიოთ შემდეგ სტატიებს, რომ გაეცნოთ: