PDF의 바닥글

PDF 푸터 섹션에 이미지와 텍스트를 추가하는 것은 브랜딩이나 법적 정보를 문서에 추가하는 것과 같은 다양한 시나리오에서 유용할 수 있습니다. 많은 산업에서 문서의 각 페이지 하단에 회사 로고나 면책 조항을 추가하는 것은 일반적인 요구 사항입니다. 다른 경우에는 문서를 구성하거나 식별하는 데 도움이 되는 페이지 번호나 기타 메타데이터를 추가해야 할 수도 있습니다. 특정 사용 사례와 관계없이 PDF 문서의 푸터 섹션에 이미지와 텍스트를 추가하는 기능은 많은 기업과 조직에 중요한 기능입니다. 이 문서에서는 Python Cloud SDK를 사용하여 PDF 문서의 푸터 섹션에 이미지와 텍스트를 추가하는 방법을 살펴보겠습니다.

푸터에 사용되는 또 다른 용어는 런닝 풋입니다. 출판 업계에서 많이 사용되며, 기사의 축약 버전이나 기사에 대한 다른 정보를 담고 있기 때문에 그렇게 불립니다.

파이썬 클라우드 SDK

Aspose.PDF Cloud SDK for Python는 PDF 문서 작업을 위한 강력한 기능 세트를 제공하며 여기에는 PDF 문서의 푸터 섹션에 이미지와 텍스트를 추가하는 기능이 포함됩니다. 이 SDK는 간단하고 직관적인 인터페이스를 제공하여 다양한 PDF 관련 작업을 프로그래밍 방식으로 쉽게 수행할 수 있습니다. 이 SDK를 사용하면 모든 PDF 문서의 푸터에 사용자 정의 텍스트나 이미지를 빠르고 쉽게 추가하여 문서에 전문적이고 사용자 정의된 모양을 제공할 수 있습니다.

SDK는 PIPGitHub 저장소에서 다운로드할 수 있습니다. 그러나 터미널/명령 프롬프트에서 다음 명령을 실행하기만 하면 시스템에 최신 버전의 SDK를 설치할 수 있습니다.

pip install asposepdfcloud

다음 중요한 단계는 클라우드 대시보드에서 클라이언트 자격 증명을 얻는 것입니다. GitHub 또는 Google 계정이 있는 경우 간단히 가입하거나 새 계정 만들기 버튼을 클릭하고 필요한 정보를 제공하세요.

클라이언트 자격 증명

이미지 1: Aspose.Cloud 대시보드의 클라이언트 자격 증명.

Python 코드 조각을 사용하여 PDF 문서에 텍스트 바닥글을 추가하려면 아래 단계를 따르세요.

  • 첫 번째 단계는 클라이언트 ID와 클라이언트 비밀번호를 인수로 요구하는 ApiClient 클래스의 인스턴스를 만드는 것입니다.
  • 둘째, 입력 인수로 ApiClient 객체를 필요로 하는 PdfApi 클래스의 인스턴스를 생성합니다.
  • 셋째, 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)

        # PdfApiClient를 인수로 전달하면서 PdfApi 인스턴스를 생성합니다.
        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
        # Footer 섹션에 표시할 텍스트 값
        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)
        # TextFooter에 TextState 객체를 할당합니다.
        textFooter.text_state = textState
        
        # PDF의 Footer 시작 페이지
        startPage = 2
        # PDF의 끝 페이지 Footer
        endPage = 3

        # PDF 파일의 2번째와 3번째 페이지에 텍스트 바닥글을 추가하기 위해 API를 호출합니다.
        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 파일에 이미지 푸터를 추가하는 기능을 제공합니다. 이 요구 사항을 달성하려면 아래에 제공된 지침을 따르십시오.

  • 첫 번째 단계는 클라이언트 ID와 클라이언트 비밀번호를 인수로 요구하는 ApiClient 클래스의 인스턴스를 만드는 것입니다.
  • 둘째, 입력 인수로 ApiClient 객체를 필요로 하는 PdfApi 클래스의 인스턴스를 생성합니다.
  • 셋째, 가로 정렬을 가운데로, 불투명도를 0.7로, 회전 각도를 10으로 설정한 ImageFooter 객체를 생성하고, 이미지 파일 이름, 여백 세부 정보 및 기타 속성을 지정합니다.
  • 문서의 첫 페이지에만 푸터를 추가하면 되므로 시작 페이지 번호와 끝 페이지 번호라는 선택적 매개변수에 값을 설정했습니다.
  • 마지막으로 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)

        # PdfApiClient를 인수로 전달하면서 PdfApi 인스턴스를 생성합니다.
        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

        # PDF 파일에서 이미지 푸터를 렌더링하기 위해 API 호출
        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 웹 토큰(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}"

cURL 명령을 사용하여 PDF 파일에 이미지 헤더를 추가하려면 다음 명령을 실행하세요.

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 for Python Cloud SDK는 Python 애플리케이션에서 이 기능을 구현하는 편리하고 강력한 방법을 제공합니다. 반면, Aspose.PDF Cloud API와 함께 cURL 명령을 사용하면 다양한 프로그래밍 언어와 환경에 기능을 통합하는 데 유연성과 단순성을 제공할 수 있습니다. 어떤 접근 방식을 선택하든 Aspose.PDF Cloud는 PDF 문서의 푸터 섹션에 이미지와 텍스트를 추가하기 위한 강력하고 안정적인 도구를 제공합니다.

유용한 링크

관련기사

자세한 내용은 다음 기사를 참조하세요.