Documentation – 파이썬에서 PDF 링크로 작업하기

Python-Net: 파이썬으로 PDF 링크 만들기

Wed, 10 Jun 2026 00:00:00 +0000

PDF 문서의 링크

PDF 1.7 사양 (ISO 32000-1:2008) 에 따르면링크 주석은 주석이 활성화될 때 발생하는 상황을 정의하는 여러 유형의 작업을 트리거할 수 있습니다.지원되는 기본 작업은 다음과 같습니다.

GoTo — 동일한 문서 내에서 목적지로 이동합니다.
GoTor — 다른 PDF 파일의 목적지로 이동합니다 (원격 이동).
URI — 통일 리소스 식별자 (일반적으로 웹 링크) 를 엽니다.
Launch — 애플리케이션을 시작하거나 파일을 엽니다 (플랫폼에 따라 다르며 보안을 위해 제한되는 경우가 많음).
이름 — 다음 페이지로 이동하거나 문서를 인쇄하는 등 미리 정의된 작업을 실행합니다.
JavaScript — 내장된 자바스크립트 코드를 실행합니다 (보안 문제로 인해 주의해서 사용).
제출양식 — 지정된 URL에 양식 데이터를 제출합니다.
resetForm — 양식 필드를 기본값으로 재설정합니다.
ImportData — 외부 파일에서 문서로 데이터를 가져옵니다.

문서에 응용 프로그램 링크를 추가하면 문서에서 응용 프로그램으로 연결할 수 있습니다.예를 들어 독자가 자습서의 특정 시점에서 특정 작업을 수행하도록 하거나 기능이 풍부한 문서를 만들고자 할 때 유용합니다.

‘LaunchAction’을 사용하여 애플리케이션 링크를 생성하려면:

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_launch_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    link.action = ap.annotations.LaunchAction(document, "sample.pdf")
    page.annotations.append(link)
    document.save(outfile)

PDF 파일에 PDF 문서 링크 만들기

GoToToRemoteAction 사용

이 코드 스니펫은 Python PDF 라이브러리를 사용하여 PDF 문서의 특정 페이지에 링크 주석을 추가하는 방법을 보여줍니다.

PDF 문서 열기
문서의 두 번째 페이지 선택 (색인 1)
링크 주석 만들기:
좌표 (10, 580, 120, 600) 에 위치 지정
컬러 그린
첫 페이지에 있는 ‘sample.pdf’ 링크
페이지에 링크 주석 추가
수정된 문서를 출력 파일 경로에 저장

‘GoToRemoteAction’을 사용하여 PDF 문서 링크를 만들려면:

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_go_to_remote_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToRemoteAction("sample.pdf", 1)
    page.annotations.append(link)
    document.save(outfile)

GoToAction 사용

이 코드는 Python용 Aspose.PDF 를 사용하여 PDF 문서의 특정 페이지에 링크 주석을 추가하는 방법을 보여줍니다.링크는 대시 테두리가 있는 녹색 사각형으로 표시되며, 이를 통해 사용자는 동일한 PDF 내에서 다른 페이지로 이동할 수 있습니다.‘GoToAction’을 사용하여 PDF 문서 링크를 만들려면:

import aspose.pdf as ap
from os import path
import sys

def create_link_annotation_go_to_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    if document.pages.length >= 4:
        link.action = ap.annotations.GoToAction(document.pages[4])
    else:
        link.action = ap.annotations.GoToAction(document.pages[document.pages.length])
    page.annotations.append(link)
    document.save(outfile)

고투어액션 적용

다음 예제는 Python용 Aspose.PDF 를 사용하여 PDF 문서에 링크 주석을 추가하는 방법을 보여줍니다.링크는 첫 페이지에 녹색 클릭 가능 영역으로 표시되며, 클릭하면 GoTouriAction을 통해 웹 브라우저에서 Python용 Aspose.PDF 문서가 열립니다.

이 기능은 유용한 외부 참조, 문서 또는 지원 링크를 PDF에 직접 포함시키는 데 유용합니다.

PDF 문서를 로드합니다.AP.Document를 사용하여 기존 PDF 파일을 엽니다.
첫 페이지에 접속하세요.document.pages [1] 를 사용하여 첫 페이지에 액세스합니다 (Aspose는 1 기반 인덱싱을 사용합니다).
링크 주석 만들기LinkAnnotation 객체를 만들고 ap.Rectangle 을 사용하여 클릭 가능한 사각형 영역을 지정합니다.
주석 모양을 설정합니다.link.color = ap.Color.Green을 사용하여 주석의 색상을 녹색으로 설정합니다.
URI 작업을 할당합니다.GoTouriAction을 사용하여 주석을 외부 URL에 연결할 수 있습니다.
페이지에 주석을 추가합니다.구성된 링크 주석을 첫 페이지의 주석 컬렉션에 추가합니다.
수정된 문서를 저장합니다.업데이트된 PDF 문서를 지정된 출력 경로에 저장합니다.

import aspose.pdf as ap
from os import path
import sys
    
def create_link_annotation_go_to_URI_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToURIAction("https://docs.aspose.com/pdf/python")
    page.annotations.append(link)
    document.save(outfile)

Python-Net: 파이썬에서 PDF 링크 업데이트

Wed, 10 Jun 2026 00:00:00 +0000

링크 주석 텍스트 색상 업데이트

이 예제에서는 Python용 Aspose.PDF 를 사용하여 PDF의 첫 페이지에서 모든 링크 주석을 감지한 다음 글꼴 색상을 빨간색으로 변경하여 각 링크 근처의 텍스트를 강조 표시하는 방법을 보여줍니다.각 링크 사각형 주위의 영역이 약간 확장된 TextFragmentAbsorber를 사용하여 근처에 있는 텍스트를 찾아 수정합니다.

다음과 같은 용도로 사용할 수 있습니다.

문서에 링크를 시각적으로 표시하기
연계 콘텐츠 강조를 통한 접근성 강화
검토 또는 내보내기 전 PDF 파일 사전 처리

스크립트는 각 링크 주석에 대해 사각형 경계를 검색하고 주변 텍스트를 포함하도록 해당 영역을 약간 확장하여 더 넓은 시각적 식별을 가능하게 합니다.그런 다음 이 확장된 영역에 TextFragmentAbsorber를 적용하여 해당 영역 내에 있는 텍스트 조각을 추출합니다.캡처된 이러한 조각은 글꼴 색상을 빨간색으로 변경하여 수정되므로 주변 텍스트를 강조하고 검토할 수 있도록 효과적으로 표시할 수 있습니다.이러한 업데이트를 모두 적용한 후에는 강조 표시된 주석과 관련 텍스트가 보존되어 수정된 문서가 출력 경로에 저장됩니다.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_text_color(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        ta = ap.text.TextFragmentAbsorber()
        rect = la.rect
        rect.llx -= 2
        rect.lly -= 2
        rect.urx += 2
        rect.ury += 2
        ta.text_search_options = ap.text.TextSearchOptions(rect)
        ta.visit(document.pages[1])
        for textFragment in ta.text_fragments:
            textFragment.text_state.foreground_color = ap.Color.red

    document.save(outfile)

테두리 업데이트

스크립트는 문서의 첫 페이지에 초점을 맞추고 모든 주석을 필터링하여 LINK 유형의 주석만 선택합니다. 이러한 주석은 일반적으로 하이퍼링크나 탐색 트리거와 같은 대화형 요소를 나타냅니다.코드는 이러한 각 링크 주석에 대해 LinkAnnotation 유형으로 캐스팅하고 색상 속성을 빨간색으로 업데이트하여 다른 내용과 차별화되도록 시각적으로 강조 표시합니다.모든 링크 주석을 수정한 후 업데이트된 문서는 새 스타일을 유지하면서 정의된 출력 위치에 저장됩니다.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_border(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        link_annotation = cast(ap.annotations.LinkAnnotation, la)
        link_annotation.color = ap.Color.red

    document.save(outfile)

웹 대상 업데이트

경로가 정해지면 Aspose.PDF 라이브러리를 사용하여 원본 문서를 로드하여 내용을 수정할 수 있습니다.그런 다음 스크립트는 문서의 첫 페이지에 초점을 맞추어 모든 주석을 필터링하고 일반적으로 클릭 가능한 영역이나 하이퍼링크를 나타내는 링크 유형의 주석만 선택합니다.유형 오류를 방지하고 안전한 처리를 위해 is_assignable로 각 주석을 검사한 다음 적절한 링크 주석 유형으로 캐스팅합니다.링크가 GoTouriAction과 연결된 경우, 즉 웹 주소를 가리키는 경우 스크립트는 사용자를 “로 리디렉션하도록 해당 URI를 업데이트합니다.”https://www.aspose.com". 마지막으로 원하는 변경 사항이 모두 적용된 후 수정된 문서가 지정된 출력 경로에 저장됩니다.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_web_destination(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                action.uri = "https://www.aspose.com"
    document.save(outfile)

Python-Net: 파이썬에서 PDF 링크 추출하기

Wed, 10 Jun 2026 00:00:00 +0000

PDF 파일에서 링크 추출

이 예제에서는 Python용 Aspose.PDF 를 사용하여 PDF의 첫 페이지에 있는 모든 링크 주석을 반복하는 방법을 보여줍니다.주석을 필터링하여 LinkAnnotation 유형의 주석을 식별하고 안전하게 캐스팅한 다음 페이지 색인과 페이지의 사각형 위치를 인쇄합니다.

이는 PDF의 기존 링크 주석에 대한 디버깅, 분석 또는 자동 업데이트에 사용할 수 있습니다.

PDF 문서를 로드합니다..문서 (path_infile) 를 사용하여 파일을 엽니다.
첫 페이지에서 주석에 액세스할 수 있습니다.문서.pages [1] .주석을 사용하여 모든 주석을 검색하십시오.
링크 주석 유형만 필터링합니다.각 주석의 annotation_type을 확인하세요.
링크 주석을 캐스팅하고 처리합니다.is_assignable () 및 cast () 를 사용하여 링크 주석 속성에 안전하게 액세스할 수 있도록 하세요.
주석 세부 정보를 인쇄합니다.각 링크의 페이지 색인과 사각형 (위치) 을 출력합니다.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_link_annotation(infile):

    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            print(f"Page: {annotation.page_index}, location: {annotation.rect}")

PDF 파일에서 하이퍼링크 추출

이 코드는 Python용 Aspose.PDF 를 사용하여 PDF 문서의 첫 페이지에서 모든 링크 주석 객체를 추출한 다음 GoTouriAction이 포함된 링크 주석 객체를 식별하는 방법을 보여줍니다.이러한 각 링크에 대해 페이지 색인과 대상 URI를 출력합니다.

이는 다음과 같은 작업에 유용합니다.

PDF의 외부 링크 감사
문서 또는 지원 URL 추출
깨지거나 오래된 하이퍼링크 감지

PDF 문서를 로드합니다..Document를 사용하여 파일을 엽니다.
첫 페이지에서 모든 링크 주석을 가져옵니다.AnnotationType.link 유형의 주석만 포함하도록 주석을 필터링합니다.
검사를 입력하고 링크 주석으로 변환하십시오.속성에 액세스하기 전에 각 주석이 실제로 링크 어노테이션인지 확인하세요.
링크의 작업 유형을 확인합니다.GoTouriAction을 사용하는 링크 (예: 웹 URL로 연결되는 링크) 를 필터링합니다.
URI 및 페이지 색인을 추출하고 인쇄합니다..uri를 사용하여 외부 링크를 가져오고 컨텍스트에는.page_index를 사용하세요.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_hyperlinks(infile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                print(f"Page {annotation.page_index}, URI:{action.uri}")

Documentation – 파이썬에서 PDF 링크로 작업하기

Python-Net: 파이썬으로 PDF 링크 만들기

PDF 문서의 링크

PDF 파일에 PDF 문서 링크 만들기

GoToToRemoteAction 사용

GoToAction 사용

고투어액션 적용

관련 링크 주제

Python-Net: 파이썬에서 PDF 링크 업데이트

링크 주석 텍스트 색상 업데이트

테두리 업데이트

웹 대상 업데이트

관련 링크 주제

Python-Net: 파이썬에서 PDF 링크 추출하기

PDF 파일에서 링크 추출

PDF 파일에서 하이퍼링크 추출

관련 링크 주제