ქვედა კოლონტიტული PDF-ში

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

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

Python Cloud SDK

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

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

pip install asposepdfcloud

შემდეგი მნიშვნელოვანი ნაბიჯი არის კლიენტის სერთიფიკატების მიღება Cloud dashboard-დან. თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით ან დააწკაპუნეთ ღილაკზე Create a new Account და მიაწოდეთ საჭირო ინფორმაცია.

კლიენტის რწმუნებათა სიგელები

სურათი 1: - კლიენტის სერთიფიკატები Aspose.Cloud Dashboard-ზე.

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

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

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

        # შეიყვანეთ PDF ფაილი
        input_file = 'marketing.pdf'

        # შექმენით TextFooter მაგალითი
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # დააყენეთ ჰორიზონტალური გასწორება ქვედა კოლონტიტულისთვის, როგორც ცენტრში
        textFooter.horizontal_alignment = 'Center'
        # დააყენეთ ქვედა კოლონტიტულის გამჭვირვალობა 0.7
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # დააყენეთ ბრუნვის კუთხე 5 გრადუსად
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # ტექსტური მნიშვნელობა უნდა იყოს ნაჩვენები ქვედა კოლონტიტულის განყოფილებაში
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # შექმენით TextState-ის მაგალითი, რომელიც განსაზღვრავს ტექსტის ფორმატირებას
        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 ობიექტის მინიჭება TextFooter-ს
        textFooter.text_state = textState
        
        # PDF-ის საწყისი გვერდი ქვედა კოლონტიტულისთვის
        startPage = 2
        # PDF-ის ბოლო გვერდი ქვედა კოლონტიტულისთვის
        endPage = 3

        # დაურეკეთ API-ს, რომ დაამატოთ ტექსტის ქვედა კოლონტიტული PDF ფაილში მე-2 და მე-3 გვერდზე
        response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
        
        # დაბეჭდეთ პასუხის კოდი კონსოლში
        print(response)
        
        # შეტყობინების დაბეჭდვა კონსოლში (სურვილისამებრ)
        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)
ტექსტის ქვედა კოლონტიტულის გადახედვა

სურათი 2:- PDF-ში დამატებული TextFooter-ის გადახედვა.

გთხოვთ, ეწვიოთ შემდეგ ბმულს, რომ ჩამოტვირთოთ შეყვანის marketing.pdf და შედეგის marketing-TextFooter.pdf.

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

  • პირველი ნაბიჯი არის ApiClient კლასის ინსტანციის შექმნა, რომელიც არგუმენტად მოითხოვს Client ID Client Secret-ს.
  • მეორეც, შექმენით PdfApi კლასის მაგალითი, რომელიც მოითხოვს ApiClient ობიექტს, როგორც შეყვანის არგუმენტს.
  • მესამე, შექმენით ImageFooter-ის ობიექტი, სადაც დავაყენეთ ჰორიზონტალური განლაგება ცენტრში, გამჭვირვალობა - 0.7, როტაციის კუთხე 10, სურათის ფაილის სახელი, მინდვრის დეტალები და სხვა თვისებები მითითებულია.
  • ვინაიდან ჩვენ გვჭირდება მხოლოდ ქვედა კოლონტიტულის დამატება დოკუმენტის პირველ გვერდზე, ამიტომ დავაყენეთ მნიშვნელობები startpagenumber და endpagenumber არჩევითი პარამეტრებისთვის.
  • და ბოლოს, დარეკეთ postdocumentimagefooter(..) მეთოდს, რათა დაამატოთ ტექსტური ქვედა კოლონტიტული PDF დოკუმენტში და შეინახოთ შედეგიანი ფაილი Cloud საცავში.
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)

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

        # PDF დოკუმენტის შეყვანა
        input_file = 'marketing.pdf'
        
        # შექმენით ImageFooter მაგალითი
        imageFooter = asposepdfcloud.ImageFooter()
        
        # რენდერი სათაური PDF შინაარსის თავზე
        imageFooter.background = False
        # დააყენეთ გასწორება მარცხნივ
        imageFooter.horizontal_alignment = 'Left'
        # დააყენეთ გამჭვირვალობა 70%
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # სურათის შეყვანის ფაილი
        imageFooter.file_name = 'Koala.jpg'
        # დააყენეთ სურათის სიგანე და სიმაღლე დეტალები
        imageFooter.width = 100
        imageFooter.height = 100
        # მიუთითეთ მინდვრის დეტალები ქვედა კოლონტიტულის სურათისთვის
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # დოკუმენტის საწყისი გვერდი ქვედა კოლონტიტულის დასამატებლად
        startPage = 1
        # დოკუმენტის საწყისი გვერდი ქვედა კოლონტიტულის დასამატებლად
        endPage = 1

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

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

ზემოაღნიშნული მაგალითით გენერირებული შედეგის ფაილი შეგიძლიათ ჩამოტვირთოთ marketing-ImageFooter.pdf-დან.

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

ახლა, როგორც წინაპირობა, შექმენით JSON Web Token (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 ჟეტონი, უნდა შევასრულოთ შემდეგი ბრძანება TextFooter PDF ფაილში დასამატებლად.

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 ფაილში cURL ბრძანების გამოყენებით.

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

დასკვნა

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

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

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

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