Προσθήκη κειμένου και εικόνας στην κεφαλίδα PDF

Όταν πρόκειται για τη δημιουργία επαγγελματικών και οπτικά ελκυστικών εγγράφων PDF, η δυνατότητα προσθήκης εικόνων και κειμένου στην κεφαλίδα είναι ένα απαραίτητο χαρακτηριστικό. Η ενότητα κεφαλίδας είναι μία από τις πιο σημαντικές περιοχές ενός εγγράφου, καθώς παρέχει στους αναγνώστες βασικές πληροφορίες όπως ο τίτλος, ο συγγραφέας και η ημερομηνία. Ενώ η προσθήκη κειμένου στην κεφαλίδα είναι μια σχετικά απλή διαδικασία, η προσθήκη εικόνων μπορεί να είναι πιο δύσκολη, ιδιαίτερα για προγραμματιστές Python που είναι νέοι στη δημιουργία εγγράφων PDF. Σε αυτό το άρθρο, θα διερευνήσουμε πώς να προσθέσετε εικόνα και κείμενο στην κεφαλίδα ενός εγγράφου PDF χρησιμοποιώντας το Python Cloud SDK.

Μπορείτε να προσθέσετε εικόνες, λογότυπα, την ημερομηνία και την ώρα που δημιουργήσατε το έγγραφο, τον τίτλο του εγγράφου, τον αριθμό έκδοσης ή αναθεώρησης, πρόχειρο, όνομα συγγραφέα και ονόματα κεφαλαίων στην κεφαλίδα PDF.

REST API για συναρμολόγηση εγγράφων PDF

Το Aspose.PDF Cloud SDK for Python παρέχει μια ποικιλία λειτουργιών και μεθόδων που επιτρέπουν στους προγραμματιστές να χειρίζονται αρχεία PDF μέσω προγραμματισμού. Παρέχει επίσης ένα ισχυρό και ευέλικτο σύνολο εργαλείων για την προσθήκη εικόνων και κειμένου σε κεφαλίδες εγγράφων PDF και μπορεί εύκολα να ενσωματωθεί σε εφαρμογές Python για αυτοματοποιημένη επεξεργασία εγγράφων PDF. Τώρα όσον αφορά τη διαδικασία προσθήκης μιας εικόνας στην κεφαλίδα, περιλαμβάνει τον καθορισμό της θέσης και των διαστάσεων της εικόνας, καθώς και του αριθμού σελίδας στον οποίο θα πρέπει να εμφανίζεται η εικόνα. Ομοίως, η προσθήκη κειμένου στην κεφαλίδα απαιτεί τον καθορισμό του περιεχομένου κειμένου, του μεγέθους της γραμματοσειράς και άλλων επιλογών μορφοποίησης. Το SDK παρέχει επίσης επιλογές για τον έλεγχο της στοίχισης και της τοποθέτησης του περιεχομένου της κεφαλίδας, καθώς και για τον καθορισμό του χρώματος φόντου της κεφαλίδας.

Τώρα, πρώτα πρέπει να εγκαταστήσουμε το SDK το οποίο είναι δωρεάν διαθέσιμο για λήψη μέσω του αποθετηρίου PIP και GitHub. Απλώς εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε την πιο πρόσφατη έκδοση του SDK.

pip install asposepdfcloud

Για να αποκτήσετε πρόσβαση στο REST API, πρέπει να εγγραφείτε και να λάβετε τα προσωπικά σας διαπιστευτήρια. Ρίξτε μια ματιά στον Οδηγό Γρήγορης Εκκίνησης για σχετικές πληροφορίες.

Προσθήκη κειμένου στην κεφαλίδα PDF χρησιμοποιώντας Python

Το SDK σάς δίνει τη δυνατότητα να προσθέσετε συμβολοσειρές κειμένου στην ενότητα κεφαλίδας του εγγράφου και αυτή η απαίτηση μπορεί να επιτευχθεί χρησιμοποιώντας τα ακόλουθα βήματα.

  • Πρώτον, δημιουργήστε μια παρουσία της κλάσης ApiClient ενώ παρέχετε ως ορίσματα Client ID Client Secret.
  • Δεύτερον, δημιουργήστε ένα αντικείμενο της κλάσης PdfApi που λαμβάνει ως όρισμα εισόδου το αντικείμενο ApiClient.
  • Τρίτον, δημιουργήστε ένα αντικείμενο του TextHeader που ορίζει τις ιδιότητες της παρουσίας TextHeader.
  • Για να ορίσετε τη μορφοποίηση κειμένου για το TextHeader, δημιουργήστε ένα αντικείμενο του TextState όπου ορίζουμε το χρώμα του προσκηνίου, το μέγεθος της γραμματοσειράς, το όνομα γραμματοσειράς κ.λπ.
  • Τέλος, καλέστε τη μέθοδο postdocumenttextheader(..) για να προσθέσετε το Text Header στο έγγραφο 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

Ακολουθήστε τις παρακάτω οδηγίες για να προσθέσετε ένα αντικείμενο Εικόνας στην ενότητα κεφαλίδας PDF. Το αρχείο που προκύπτει μεταφορτώνεται στον χώρο αποθήκευσης cloud.

  • Πρώτα απ ‘όλα, δημιουργήστε μια παρουσία της κλάσης ApiClient ενώ παρέχετε ως ορίσματα Client ID Client Secret.
  • Δεύτερον, δημιουργήστε ένα αντικείμενο της κλάσης PdfApi που λαμβάνει ως όρισμα εισόδου το αντικείμενο ApiClient.
  • Τώρα δημιουργήστε ένα αντικείμενο του ImageHeader που ορίζει τις ιδιότητες του ImageHeader.
  • Για τον έλεγχο της απόδοσης της κεφαλίδας σε ορισμένες σελίδες, οι τιμές εκχωρούνται στις προαιρετικές παραμέτρους startpagenumber και endpagenumber.
  • Τέλος, καλέστε τη μέθοδο postdocumentimageheader(..) για να προσθέσετε το Image Header σε έγγραφο PDF και να αποθηκεύσετε το αρχείο που προκύπτει στο Cloud storage. Σημειώστε ότι η κεφαλίδα προστίθεται μόνο στις δύο πρώτες σελίδες του εγγράφου (όπως καθορίζεται στον κώδικα).
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()
        # ορίστε την ιδιότητα φόντου ως αληθή
        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
        # όνομα αρχείου εικόνας που είναι διαθέσιμο στο χώρο αποθήκευσης cloud που θα προστεθεί στην κεφαλίδα
        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 και να αποθηκεύσετε το αρχείο που προκύπτει στο χώρο αποθήκευσης cloud
        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, δοκιμάστε να χρησιμοποιήσετε την ακόλουθη εντολή για να προσθέσετε κείμενο στην ενότητα κεφαλίδας του εγγράφου στην 1η και 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 και να αποθηκεύσετε το αρχείο που προκύπτει στον χώρο αποθήκευσης cloud. Στην ακόλουθη εντολή, η κεφαλίδα εικόνας στην 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 είναι μια χρήσιμη δυνατότητα που μπορεί να βελτιώσει την οπτική ελκυστικότητα και την επωνυμία των εγγράφων σας. Με το Aspose.PDF Cloud SDK για Python, είναι μια απλή εργασία που ολοκληρώνεται με λίγες μόνο γραμμές κώδικα. Είτε δημιουργείτε τιμολόγια, αναφορές ή οποιοδήποτε άλλο έγγραφο που απαιτεί κεφαλίδα, αυτή η δυνατότητα μπορεί να σας εξοικονομήσει χρόνο και προσπάθεια βελτιώνοντας παράλληλα την ποιότητα της παραγωγής σας. Εκτός από τη χρήση του Aspose.PDF Cloud SDK για Python, μάθαμε επίσης ότι είναι επίσης δυνατή η προσθήκη εικόνων και κειμένου σε κεφαλίδες PDF χρησιμοποιώντας εντολές cURL.

Ελπίζουμε ότι αυτό το άρθρο σας παρείχε όλη την απαραίτητη καθοδήγηση και έμπνευση για να προσθέσετε αυτήν τη λειτουργικότητα στην εφαρμογή Python σας.

Χρήσιμοι Σύνδεσμοι

Σχετικά Άρθρα

Συνιστούμε να επισκεφθείτε τα ακόλουθα άρθρα για να μάθετε σχετικά: