IRONSOFTWAREHOME
PYTHON용 IRONPDF 사용하기

Python을 사용하여 PDF에 페이지 번호를 추가하는 방법

Curtis Chau
Curtis Chau
Updated: 2026년 6월 20일

끊임없이 진화하는 디지털 문서 환경에서 PDF는 데이터를 공유하고, 문서를 저장하고, 발표하는 데 있어 핵심적인 형식으로 자리 잡았습니다. 하지만 PDF에 대한 의존도가 계속 증가함에 따라 개발자들은 이러한 파일을 프로그램적으로 조작해야 하는 여러 시나리오에 자주 직면하게 됩니다. 그러한 일반적인 요구 사항 중 하나는 모든 페이지에 페이지 번호를 추가하는 것인데, 이는 파일 탐색 및 정리에 매우 중요한 요소입니다. 이 종합 가이드의 첫 페이지에서는 IronPDF 사용하여 PDF에 페이지 번호를 추가하는 복잡한 과정을 자세히 살펴보겠습니다.

IronPDF 대하여 PDF

IronPDF PDF 파일을 프로그래밍 방식으로 다룰 때 발생하는 복잡성을 단순화하는 강력한 Python 라이브러리의 대표적인 예입니다. 다양한 기능을 갖춘 이 도구는 Python PDF를 원활하게 조작하려는 개발자에게 다재다능한 도구가 됩니다. 이 튜토리얼에서는 IronPDF의 기능을 활용하여 기존 PDF에 페이지 번호, 글꼴 및 이미지를 추가하는 방법을 중점적으로 살펴보겠습니다.

더 자세한 정보와 문서는 Python IronPDF 페이지를 참조하십시오.

필수 조건

기존 PDF 파일에 페이지 번호를 추가하는 작업을 시작하기 전에 IronPDF 라이브러리가 설치되어 있는지 반드시 확인해야 합니다. 이는 아래의 명령줄을 실행함으로써 달성할 수 있습니다.

pip install ironpdf

렌더러 인스턴스화

IronPDF에서 HTML과 CSS를 렌더링하여 PDF 파일로 출력하는 데 중요한 구성 요소인 ChromePdfRenderer 클래스 입니다. 우리의 스크립트에서, 이 새로운 PDF 렌더러 함수를 인스턴스화하여 다음 단계에 대비합니다.

# Import IronPDF module
from ironpdf import ChromePdfRenderer

# Instantiate the PDF renderer
renderer = ChromePdfRenderer()
Python

PDF 불러오는 중

PdfDocument.FromFile 메소드는 작성하고 페이지 번호로 향상시키고자 하는 기존 PDF 문서 파일 형식을 로드하는 데 사용되는 함수입니다.

# Import PdfDocument from IronPDF
from ironpdf import PdfDocument

# Load the existing PDF document
document = PdfDocument.FromFile("example.pdf")
Python

페이지 번호를 추가하는 HTML 푸터 생성

IronPDF 사용하면 원하는 페이지 수와 사용자 지정 HTML 머리글 및 바닥글을 포함하는 페이지를 선택적으로 생성할 수 있어 동적 콘텐츠를 포함하는 페이지를 유연하게 만들 수 있습니다. 저희의 경우, 페이지 번호가 포함된 HTML 푸터를 사용하여 페이지를 만듭니다.

# Import HtmlHeaderFooter from IronPDF
from ironpdf import HtmlHeaderFooter

# Create an HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15  # Set the maximum height of the footer
footer.DrawDividerLine = True  # Draw a dividing line in the footer
footer.HtmlFragment = "<center><i>{page}</i></center>"  # HTML for page number
Python

PDF에 페이지 번호 추가하기

AddHtmlFooters 메소드는 이 과정에서 중요한 단계입니다. 이 기능은 리더를 통합하여 PDF 문서 출력 파일에 사용자 지정 HTML 바닥글을 작성함으로써 각 출력 PDF 페이지에 페이지 번호를 추가합니다.

# Add the HTML footers to the PDF document
document.AddHtmlFooters(footer)
Python

수정된 PDF 저장하기

마지막으로, 수정된 출력 PDF 파일을 새로 생성되고 추가된 모든 페이지 번호와 함께 저장하기 위해 SaveAs 메소드를 사용합니다.

# Save the modified PDF document with page numbers
document.SaveAs("Modified_Output.pdf")
Python

전반적인 구현

지금까지 우리는 위의 PDF 파일 형식으로 PDF를 생성하고 가져오기 위해 페이지 번호를 추가하는 데 사용한 기능들을 살펴보았습니다. 아래 코드는 페이지 번호를 페이지 하단 중앙에 추가하는 Python 구현 전체를 보여줍니다.

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

다음 이미지는 PDF 파일에서 페이지 번호를 가운데 정렬하는 출력 파일입니다.

 Python에서 PDF에 페이지 번호 추가: 그림 1 - 페이지 번호가 중앙에 있는 이미지

페이지 번호는 오른쪽에 있습니다.

페이지 번호를 바닥글 오른쪽에 표시하려면 다음 코드를 사용하십시오.

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<div style='text-align: right;'><i>{page} of {total-pages}</i></div>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

아래 이미지는 페이지 번호를 바닥글 오른쪽에 배치했을 때의 결과물을 보여줍니다.

 Python에서 PDF에 페이지 번호 추가: 그림 2 - 페이지 번호가 오른쪽에 있는 이미지

왼쪽에 페이지 번호가 있습니다.

마찬가지로, 페이지 번호를 바닥글의 왼쪽에 배치하려면 다음 코드를 사용하십시오.

from ironpdf import ChromePdfRenderer, PdfDocument, HtmlHeaderFooter

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Load PDF document
document = PdfDocument.FromFile("example.pdf")
print(f"Number of pages in the document: {document.PageCount}")

# Create HTML footer for page numbers
footer = HtmlHeaderFooter()
footer.MaxHeight = 15
footer.DrawDividerLine = True
footer.HtmlFragment = "<div style='text-align: left;'><i>{page} of {total-pages}</i></div>"

# Add page numbers to the PDF
document.AddHtmlFooters(footer)

# Save the modified PDF
document.SaveAs("Modified.pdf")
Python

아래 이미지는 페이지 번호를 바닥글 왼쪽에 배치했을 때의 결과물을 보여줍니다.

 Python에서 PDF에 페이지 번호 추가: 그림 3 - 페이지 번호가 왼쪽에 있는 이미지

실제 활용 사례

페이지 번호를 프로그래밍 방식으로 추가하는 것이 매우 유용해지는 다양한 실제 사례와 활용 사례를 살펴보겠습니다.

보고서 생성

비즈니스 애플리케이션에서 자동 보고서 파일 생성은 흔히 요구되는 사항입니다. 페이지 번호를 추가하면 보고서가 체계적이고 전문적으로 보이게 됩니다.

학술 문서

예를 들어 학술 기관이나 연구자의 경우, 연구 논문이나 학술 문서에 페이지 번호를 동적으로 추가하면 읽기 및 참조 프로세스가 간소화됩니다.

법률 문서

법률 분야에서는 버전 관리를 유지하고 적절한 파일 페이지 매김 및 파일 이름 지정을 보장하는 것이 매우 중요합니다. 페이지 번호 추가를 자동화하면 프로세스가 간소화됩니다.

전자책 및 출판물

디지털 출판물이나 전자책을 다룰 때는 일관된 읽기 경험을 제공하는 것이 가장 중요합니다. 페이지 번호와 글꼴은 모두 문서의 전반적인 가독성과 페이지 탐색 편의성에 영향을 미칩니다.

결론

이 상세한 탐구 기사에서는 Python의 IronPDF 사용하여 PDF 문서 출력에 페이지 번호를 매끄럽게 통합함으로써 문서 품질을 향상시키는 복잡한 과정을 자세히 살펴보았습니다. 제공된 코드는 출력에 체계적인 접근 방식을 취하여 경로, 출력 및 이해의 용이성을 명확히 합니다.

이 가이드는 기본 틀을 제공하는 것이며, 개발자는 제공된 코드를 특정 요구 사항에 맞게 수정하는 것이 좋습니다. 또한 IronPDF 구매 전에 평가해 볼 수 있도록 개발 목적의 무료 평가판을 제공합니다. 라이선스 세부 정보, 고급 기능 및 지원에 대한 자세한 내용은 IronPDF 공식 웹사이트를 방문하십시오.

PDF 파일 조작 도구 시장이 지속적으로 발전함에 따라, IronPDF PDF 파일 및 이미지 관련 워크플로우를 자동화하고 개선하고자 하는 개발자들에게 매우 유용한 도구로 자리매김하고 있습니다. Python에서 IronPDF 에 대해 더 자세히 알아보려면 여기 링크를 따라가시면 라이선스 세부 정보 및 추가 정보를 확인할 수 있습니다.

페이지 나누기 후 HTML에 페이지 번호를 추가하는 방법을 알고 싶다면 여기에서 예시를 확인할 수 있습니다.

즐거운 PDF 파일 코딩 되세요!

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...
더 읽어보기

관련 기사

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.