IronPDF를 사용하여 Python으로 PDF에 쉽게 주석을 다는 방법

필수 조건

IronPDF 사용하여 PDF에 주석을 달기 전에 다음 필수 사항을 준비했는지 확인하십시오.

1. Python: 컴퓨터에 Python이 설치되어 있는지 확인하십시오. 최신 버전을 다운로드하려면 Python 공식 웹사이트를 방문하세요.
2. IDE 설치: IronPDF 사용하여 PDF 작업을 시작하기 전에 IDE를 설치해야 합니다. Python용으로 널리 사용되는 통합 개발 환경(IDE)으로는 PyCharm을 추천합니다. 또는 PyCharm을 사용하고 싶지 않다면 원하는 다른 IDE를 사용해도 됩니다.

3. IronPDF 라이브러리: 터미널에서 다음 명령어를 사용하여 IronPDF 라이브러리를 설치하십시오.

   pip install IronPDF

   pip install IronPDF

   SHELL

   IronPDF 패키지를 설치하세요

4. .NET 6.0 런타임: Python용 IronPDF 제대로 작동하기 위해 .NET 6.0 기술에 의존합니다. 즉, Python용 IronPDF 효과적으로 사용하려면 컴퓨터에 .NET 6.0 런타임이 설치되어 있어야 합니다. 프로젝트 실행 시 IronPDF 종속성과 함께 자동으로 설치될 가능성이 높습니다.

참고: pip(Python 패키지 관리자)를 사용하여 IronPDF 설치할 경우, IronPDF 설치 경로가 시스템의 PATH 환경 변수에 포함되어 있는지 확인하는 것이 중요합니다. 이 단계는 pip가 설치 및 사용 중에 IronPDF 패키지와 관련 구성 요소를 찾을 수 있도록 보장하는 데 매우 중요합니다.

1단계: IronPDF 라이브러리 가져오기

첫 번째 줄은 IronPDF 라이브러리에서 필요한 모듈을 가져와 PDF 조작 및 주석에 필요한 클래스와 함수에 접근할 수 있도록 합니다.

from ironpdf import PdfDocument, TextAnnotation

from ironpdf import PdfDocument, TextAnnotation

2단계: 기존 PDF 문서 불러오기

이 단계에서는 PdfDocument 클래스를 사용하여 "existing.pdf"라는 기존 PDF 파일을 불러옵니다. 이 문서는 주석을 추가하는 데 기본 자료로 사용될 것입니다. 또한 지원되는 주석 유형이 추가될 페이지 인덱스를 설정하십시오.

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

3단계: 주석 매개변수 설정

다음 코드는 PDF에 추가될 텍스트 주석의 다양한 속성을 정의합니다. 이러한 속성은 주석의 모양과 동작에 대한 정보를 제공합니다.

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

각 속성이 나타내는 의미는 다음과 같습니다.

• 주석: 주석 변수를 설정하고 주석 유형을 선언합니다.
• 제목: 새 주석의 주요 제목.
• 제목: 주석에 대한 부제목 또는 추가 정보.
• 내용: 주석의 주요 내용은 "포스트잇" 메모와 유사합니다.
• 아이콘: 주석과 관련된 시각적 아이콘(이 경우 도움말 아이콘).
• X 및 Y: 페이지에서 주석의 왼쪽 상단 모서리의 좌표입니다.
• 너비 및 높이: 주석의 경계 상자 크기입니다.
• 불투명도: 주석의 불투명도 수준(0~1 사이).
• 인쇄 가능 여부: 주석을 인쇄할지 여부.
• 숨김 여부: 주석이 처음부터 숨겨져 있는지 여부.
• OpenByDefault: 주석을 기본적으로 열도록 할지 여부.
• ReadOnly: 주석이 읽기 전용인지 여부.
• 회전 가능 여부: 주석을 회전할 수 있는지 여부.

더 많은 어노테이션 유형 및 속성을 보려면 이 코드 예제 페이지를 참조하세요.

4단계: PDF에 주석 추가

다음 코드는 생성된 텍스트 주석을 PDF 문서 내의 특정 페이지에 추가합니다.

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

5단계: 주석이 달린 PDF 저장하기

마지막으로, 주석이 추가된 업데이트된 PDF 문서는 SaveAs 메서드를 사용하여 저장됩니다.

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

6단계: 스크립트 실행

자, 이제 모든 코드를 합쳐서 앞서 생성한 PyCharm 프로젝트에서 스크립트를 실행해 보겠습니다.

1. PyCharm 내에서 스크립트를 실행하려면 스크립트 편집기 내 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 "annotatePDF 실행"을 선택하십시오.
2. PyCharm이 스크립트를 실행하고, IDE 하단의 실행 콘솔에서 출력 결과와 발생 가능한 오류를 확인할 수 있습니다.
3. 스크립트 실행이 완료되면 프로젝트 파일이 있는 동일한 디렉토리에서 주석이 추가된 PDF 파일("annotated.pdf")을 찾을 수 있습니다.

출력:

출력 PDF 파일