Мастер модификации 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 dashboard. Если у вас есть учетная запись GitHub или Google, просто зарегистрируйтесь или нажмите кнопку Create a new Account и укажите необходимую информацию.

Добавить текстовый нижний колонтитул в PDF с помощью Python

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

Первым шагом является создание экземпляра класса ApiClient, которому в качестве аргументов требуются Client ID и Client Secret.
Во-вторых, создайте экземпляр класса PdfApi, которому в качестве входного аргумента требуется объект ApiClient.
В-третьих, создайте объект TextFooter, где мы установили горизонтальное выравнивание по центру, непрозрачность 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, в котором мы установили горизонтальное выравнивание по центру, непрозрачность — 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 с API Aspose.PDF Cloud может обеспечить гибкость и простоту интеграции функции в различные языки программирования и среды. Независимо от выбранного вами подхода, Aspose.PDF Cloud предлагает надежные и надежные инструменты для добавления изображения и текста в раздел нижнего колонтитула ваших документов PDF.

Полезные ссылки

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

Справочник API

Полный исходный код SDK

Бесплатный форум технической поддержки

Python Cloud SDK#

Добавить текстовый нижний колонтитул в PDF с помощью Python#

Добавить нижний колонтитул изображения в PDF с помощью Python#

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

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

Заключение#

Полезные ссылки#

Похожие статьи#

Python Cloud SDK

Добавить текстовый нижний колонтитул в PDF с помощью Python

Добавить нижний колонтитул изображения в PDF с помощью Python

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

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

Заключение

Полезные ссылки

Похожие статьи