Основна модифікація PDF: як додати зображення та текст до нижнього колонтитула PDF за допомогою Python

Додавання зображень і тексту до розділу нижнього колонтитула PDF може бути корисним у різних сценаріях, як-от додавання фірмової символіки чи юридичної інформації до документів. У багатьох галузях промисловості поширеною вимогою є додавання логотипу компанії або застереження внизу кожної сторінки документа. В інших випадках може знадобитися додати номери сторінок або інші метадані, щоб допомогти впорядкувати або ідентифікувати документ. Незалежно від конкретного випадку використання можливість додавати зображення та текст до нижнього колонтитула PDF-документа є важливою функцією для багатьох підприємств і організацій. У цій статті ми розглянемо, як додати зображення та текст до нижнього колонтитула документа PDF за допомогою Python Cloud SDK.

Інший термін, який використовується для нижнього колонтитула, називається «бігова нога». Він широко використовується у видавничій галузі і називається так тому, що містить скорочену версію статті або іншу інформацію про неї.

Python Cloud SDK
Додайте текстовий нижній колонтитул у PDF за допомогою Python
Додайте нижній колонтитул зображення в PDF за допомогою Python
Додавання текстового нижнього колонтитула до PDF за допомогою команди cURL
Додавання нижнього колонтитула зображення до PDF за допомогою команди cURL

Python Cloud SDK

Aspose.PDF Cloud SDK для Python надає набір потужних функцій для роботи з PDF-документами, включаючи можливість додавати зображення та текст до нижнього колонтитула документа PDF. Цей пакет SDK пропонує простий та інтуїтивно зрозумілий інтерфейс, який дозволяє легко виконувати різноманітні завдання, пов’язані з PDF-файлами, програмно. Використовуючи цей SDK, ви можете швидко та легко додавати спеціальний текст або зображення до нижнього колонтитула будь-якого PDF-документа, надаючи своїм документам професійний та індивідуальний вигляд.

SDK доступний для завантаження через PIP і GitHub репозиторій. Однак ви можете просто виконати наступну команду в терміналі/командному рядку, щоб інсталювати останню версію SDK у системі.

pip install asposepdfcloud

Наступним важливим кроком є отримання облікових даних клієнта з панелі інструментів Cloud. Якщо у вас є обліковий запис GitHub або Google, просто зареєструйтеся або натисніть кнопку Створити новий обліковий запис і надайте необхідну інформацію.

Облікові дані клієнта — Зображення 1: облікові дані клієнта на інформаційній панелі Aspose.Cloud.

Додайте текстовий нижній колонтитул у PDF за допомогою Python

Виконайте наведені нижче кроки, щоб додати текстовий нижній колонтитул у PDF-документ за допомогою фрагмента коду Python.

Першим кроком є створення екземпляра класу ApiClient, для якого в якості аргументів потрібен Client ID Client Secret.
По-друге, створіть екземпляр класу PdfApi, який вимагає об’єкт ApiClient як вхідний аргумент.
По-третє, створіть об’єкт TextFooter, де ми встановили горизонтальне вирівнювання як Center, Opacity як 0,7, кут повороту як 356 і вказали нижнє поле як 5.
Щоб налаштувати форматування тексту для TextFooter, створіть об’єкт TextState, де ми визначаємо колір переднього плану, розмір шрифту, назву шрифту тощо.
Тепер нам потрібно встановити значення для двох додаткових параметрів, що визначають початкову та кінцеву сторінки PDF-документа, щоб розмістити текстовий колонтитул.
Нарешті, викличте метод postdocumenttextfooter(..), щоб додати текстовий нижній колонтитул до документа PDF і зберегти отриманий файл у хмарному сховищі.

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: - Попередній перегляд TextFooter додано до PDF.

Перейдіть за наведеним нижче посиланням, щоб завантажити вхідні дані marketing.pdf і результуючий marketing-TextFooter.pdf.

API також надає можливість додавати нижній колонтитул зображення до файлу PDF. Дотримуйтеся наведених нижче інструкцій, щоб виконати цю вимогу.

Першим кроком є створення екземпляра класу ApiClient, для якого в якості аргументів потрібен Client ID Client Secret.
По-друге, створіть екземпляр класу PdfApi, який вимагає об’єкт ApiClient як вхідний аргумент.
По-третє, створіть об’єкт ImageFooter, де ми встановили горизонтальне вирівнювання як Center, Opacity як 0,7, кут повороту як 10, назву файлу зображення, деталі полів та інші властивості.
Оскільки нам потрібно лише додати нижній колонтитул до першої сторінки документа, ми встановили значення для параметрів startpagenumber і endpagenumber.
Нарешті, викличте метод postdocumentimagefooter(..), щоб додати текстовий нижній колонтитул до документа PDF і зберегти отриманий файл у хмарному сховищі.

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.

Додавання текстового нижнього колонтитула до PDF за допомогою команди cURL

Використання команд 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-документів.

Корисні посилання

Документація продукту

Довідка по API

Повний вихідний код SDK

Безкоштовний форум технічної підтримки

Схожі статті

Рекомендуємо переглянути такі статті, щоб дізнатися про:

Python Cloud SDK#

Додайте текстовий нижній колонтитул у PDF за допомогою Python#

Додайте нижній колонтитул зображення в PDF за допомогою Python#

Додавання текстового нижнього колонтитула до PDF за допомогою команди cURL#

Додавання нижнього колонтитула зображення до PDF за допомогою команди cURL#

Висновок#

Корисні посилання#

Схожі статті#