Chân trang trong PDF

Thêm hình ảnh và văn bản vào phần chân trang PDF có thể hữu ích trong nhiều tình huống khác nhau, chẳng hạn như thêm thông tin thương hiệu hoặc pháp lý vào tài liệu. Trong nhiều ngành, việc thêm logo công ty hoặc tuyên bố từ chối trách nhiệm ở cuối mỗi trang của tài liệu là yêu cầu phổ biến. Trong những trường hợp khác, có thể cần thêm số trang hoặc siêu dữ liệu khác để giúp sắp xếp hoặc nhận dạng tài liệu. Bất kể trường hợp sử dụng cụ thể nào, khả năng thêm hình ảnh và văn bản vào phần chân trang của tài liệu PDF là một tính năng quan trọng đối với nhiều doanh nghiệp và tổ chức. Trong bài viết này, chúng ta sẽ khám phá cách thêm hình ảnh và văn bản vào phần chân trang của tài liệu PDF bằng Python Cloud SDK.

Một thuật ngữ khác được sử dụng cho phần chân trang là chân chạy. Nó được sử dụng rất nhiều trong ngành xuất bản và được gọi như vậy vì nó chứa phiên bản rút gọn của bài viết hoặc các thông tin khác về bài viết đó.

SDK đám mây Python

Aspose.PDF Cloud SDK for Python cung cấp một bộ tính năng mạnh mẽ để làm việc với các tài liệu PDF, bao gồm khả năng thêm hình ảnh và văn bản vào phần chân trang của tài liệu PDF. SDK này cung cấp giao diện đơn giản và trực quan giúp bạn dễ dàng thực hiện nhiều tác vụ liên quan đến PDF theo chương trình. Sử dụng SDK này, bạn có thể nhanh chóng và dễ dàng thêm văn bản hoặc hình ảnh tùy chỉnh vào phần chân trang của bất kỳ tài liệu PDF nào, mang đến giao diện chuyên nghiệp và tùy chỉnh cho tài liệu của bạn.

SDK có sẵn để tải xuống qua kho lưu trữ PIPGitHub. Tuy nhiên, bạn có thể chỉ cần thực hiện lệnh sau trên terminal/dấu nhắc lệnh để cài đặt phiên bản SDK mới nhất trên hệ thống.

pip install asposepdfcloud

Bước quan trọng tiếp theo là lấy thông tin xác thực của khách hàng từ Bảng điều khiển đám mây. Nếu bạn có tài khoản GitHub hoặc Google, chỉ cần Đăng ký hoặc nhấp vào nút Tạo tài khoản mới và cung cấp thông tin bắt buộc.

Thông tin khách hàng

Hình ảnh 1: - Thông tin xác thực của khách hàng trên Bảng điều khiển Aspose.Cloud.

Vui lòng làm theo các bước dưới đây để thêm văn bản chân trang vào tài liệu PDF bằng đoạn mã Python.

  • Bước đầu tiên là tạo một thể hiện của lớp ApiClient yêu cầu Client ID và Client Secret làm đối số.
  • Thứ hai, tạo một thể hiện của lớp PdfApi yêu cầu đối tượng ApiClient làm đối số đầu vào.
  • Thứ ba, tạo đối tượng TextFooter trong đó chúng ta thiết lập căn chỉnh theo chiều ngang là Center, Opacity là 0.7, góc xoay là 356 và chỉ định lề dưới là 5.
  • Để thiết lập định dạng văn bản cho TextFooter, hãy tạo một đối tượng TextState trong đó chúng ta xác định màu nền, kích thước phông chữ, tên phông chữ, v.v.
  • Bây giờ chúng ta cần thiết lập giá trị cho hai tham số tùy chọn xác định trang bắt đầu và kết thúc của tài liệu PDF để đặt Chân trang văn bản.
  • Cuối cùng, gọi phương thức postdocumenttextfooter(..) để thêm Text Footer vào tài liệu PDF và lưu tệp kết quả vào bộ nhớ đám mây.
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)

        # tạo phiên bản PdfApi trong khi truyền PdfApiClient làm đối số
        pdf_api = PdfApi(pdf_api_client)

        # nhập tệp PDF
        input_file = 'marketing.pdf'

        # Tạo phiên bản TextFooter
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # Đặt căn chỉnh theo chiều ngang cho Footer thành Center
        textFooter.horizontal_alignment = 'Center'
        # đặt độ mờ đục của chân trang là 0,7
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # đặt góc quay là 5 độ
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # Giá trị văn bản sẽ được hiển thị trong phần Chân trang
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # tạo một thể hiện của TextState xác định định dạng của văn bản
        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)
        # gán đối tượng TextState cho TextFooter
        textFooter.text_state = textState
        
        # trang bắt đầu của PDF cho Footer
        startPage = 2
        # trang cuối của PDF cho Footer
        endPage = 3

        # gọi API để thêm chân trang Văn bản vào tệp PDF ở trang thứ 2 và thứ 3
        response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
        
        # in mã phản hồi trong bảng điều khiển
        print(response)
        
        # in tin nhắn trong bảng điều khiển (tùy chọn)
        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)
Xem trước chân trang văn bản

Hình ảnh 2: - Xem trước TextFooter được thêm vào PDF.

Vui lòng truy cập liên kết sau để tải xuống dữ liệu đầu vào marketing.pdf và dữ liệu kết quả marketing-TextFooter.pdf.

API cũng cung cấp khả năng thêm chân trang Hình ảnh vào tệp PDF. Vui lòng làm theo hướng dẫn bên dưới để thực hiện yêu cầu này.

  • Bước đầu tiên là tạo một thể hiện của lớp ApiClient yêu cầu Client ID và Client Secret làm đối số.
  • Thứ hai, tạo một thể hiện của lớp PdfApi yêu cầu đối tượng ApiClient làm đối số đầu vào.
  • Thứ ba, tạo một đối tượng ImageFooter trong đó chúng ta thiết lập căn chỉnh theo chiều ngang là Center, Opacity là 0,7, góc xoay là 10, tên tệp hình ảnh, chi tiết lề và các thuộc tính khác được chỉ định.
  • Vì chúng ta chỉ cần thêm Footer vào trang đầu tiên của tài liệu nên chúng ta đã thiết lập các giá trị cho các tham số tùy chọn startpagenumber và endpagenumber.
  • Cuối cùng, gọi phương thức postdocumentimagefooter(..) để thêm Text Footer vào tài liệu PDF và lưu tệp kết quả vào bộ nhớ đám mây.
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)

        # tạo phiên bản PdfApi trong khi truyền PdfApiClient làm đối số
        pdf_api = PdfApi(pdf_api_client)

        # nhập tài liệu PDF
        input_file = 'marketing.pdf'
        
        # Tạo phiên bản ImageFooter
        imageFooter = asposepdfcloud.ImageFooter()
        
        # hiển thị tiêu đề ở trên cùng của nội dung PDF
        imageFooter.background = False
        # đặt căn chỉnh là bên trái
        imageFooter.horizontal_alignment = 'Left'
        # đặt độ mờ đục là 70%
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # tập tin hình ảnh đầu vào
        imageFooter.file_name = 'Koala.jpg'
        # thiết lập chi tiết chiều rộng và chiều cao của hình ảnh
        imageFooter.width = 100
        imageFooter.height = 100
        # chỉ định chi tiết lề cho hình ảnh chân trang
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # trang bắt đầu của tài liệu để thêm Footer
        startPage = 1
        # trang bắt đầu của tài liệu để thêm Footer
        endPage = 1

        # gọi API để hiển thị hình ảnh chân trang trong tệp PDF
        response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
        
        # in mã phản hồi trong bảng điều khiển
        print(response)
        
        # in tin nhắn trong bảng điều khiển (tùy chọn)
        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)
Chân trang hình ảnh trong PDF

Hình ảnh 3: - Xem trước phần chân trang hình ảnh trong PDF.

Tệp kết quả được tạo ra bởi ví dụ trên có thể được tải xuống từ marketing-ImageFooter.pdf.

Việc sử dụng lệnh cURL và Aspose.PDF Cloud để thêm văn bản và Hình ảnh vào chân trang PDF mang lại một số lợi ích. Đầu tiên, nó loại bỏ nhu cầu chỉnh sửa thủ công các tài liệu PDF, có thể tốn thời gian và dễ xảy ra lỗi. Thứ hai, nó cho phép tùy chỉnh dễ dàng văn bản tiêu đề, với khả năng thay đổi phông chữ, kích thước, màu sắc và vị trí của văn bản. Thứ ba, nó cho phép người dùng thêm văn bản vào nhiều tài liệu PDF cùng lúc, tiết kiệm thời gian và tăng hiệu quả. Cuối cùng, phương pháp này cung cấp một phương pháp an toàn và đáng tin cậy để thêm văn bản vào tiêu đề PDF, với tất cả dữ liệu được truyền qua kết nối an toàn và được xử lý trên các máy chủ an toàn.

Bây giờ, trước tiên hãy tạo JSON Web Token (JWT) bằng cách thực hiện lệnh sau.

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"

Bây giờ chúng ta đã tạo được mã thông báo JWT, chúng ta cần thực hiện lệnh sau để thêm TextFooter vào tệp 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}"

Vui lòng thực hiện lệnh sau để thêm tiêu đề hình ảnh vào tệp PDF bằng lệnh 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}"

Phần kết luận

Tóm lại, việc thêm hình ảnh và văn bản vào phần chân trang của tài liệu PDF có thể là một tính năng hữu ích cho nhiều mục đích khác nhau, bao gồm xây dựng thương hiệu, tuân thủ pháp lý và tổ chức tài liệu. Aspose.PDF Cloud SDK for Python cung cấp một cách thuận tiện và mạnh mẽ để triển khai tính năng này trong ứng dụng Python của bạn. Mặt khác, sử dụng lệnh cURL với Aspose.PDF Cloud API có thể mang lại sự linh hoạt và đơn giản để tích hợp tính năng này vào nhiều ngôn ngữ lập trình và môi trường khác nhau. Bất kể bạn chọn cách tiếp cận nào, Aspose.PDF Cloud đều cung cấp các công cụ mạnh mẽ và đáng tin cậy để thêm hình ảnh và văn bản vào phần chân trang của tài liệu PDF của bạn.

Liên kết hữu ích

Bài viết liên quan

Chúng tôi khuyên bạn nên truy cập các bài viết sau để tìm hiểu về: