Documentation – Работа с PDF‑ссылками в Python

Python-Net: Создать ссылки PDF в Python

Wed, 15 Apr 2026 00:00:00 +0000

Ссылки в PDF‑документах

Согласно спецификации PDF 1.7 (ISO 32000-1:2008), Link annotation может инициировать несколько типов действий, определяющих, что происходит при активации аннотации. Ниже перечислены поддерживаемые основные действия:

GoTo – Переходит к месту назначения в том же документе.
GoToR – Переходит к месту назначения в другом PDF‑файле (удалённый переход).
URI – Открывает универсальный идентификатор ресурса, как правило, веб‑ссылку.
Launch – Запускает приложение или открывает файл (зависит от платформы и часто ограничено по соображениям безопасности).
Named – Выполняет предопределённое действие, например переход к следующей странице или печать документа.
JavaScript – Выполняет встроенный код JavaScript (используется с осторожностью из‑за проблем безопасности).
SubmitForm – Отправляет данные формы на указанный 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‑файле

Использование GoToRemoteAction

Этот фрагмент кода демонстрирует, как добавить аннотацию ссылки на конкретную страницу PDF‑документа с использованием библиотеки PDF для Python.

Откройте PDF‑документ
Выберите вторую страницу документа (индекс 1)
Создайте аннотацию ссылки:
Размещено в координатах (10, 580, 120, 600)
Окрашен в зеленый
Ссылается на ‘sample.pdf’ на первой странице
Добавьте аннотацию ссылки на страницу
Сохраните измененный документ по пути выходного файла

Чтобы создать ссылку на PDF‑документ, используя ‘GoToRemoteAction’:

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

Этот код демонстрирует, как добавить аннотацию ссылки на конкретную страницу PDF‑документа с использованием Aspose.PDF for Python. Ссылка отображается в виде зеленого прямоугольника с пунктирной рамкой и позволяет пользователю переходить на другую страницу внутри того же PDF. Чтобы создать ссылку в PDF‑документе с использованием ‘GoToAction’:

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)

Применение GoToURIAction

Следующий пример демонстрирует, как добавить аннотацию ссылки в PDF-документ с помощью Aspose.PDF for Python. Ссылка отображается как зеленая кликабельная область на первой странице, и при нажатии открывает документацию Aspose.PDF for Python в веб-браузере через GoToURIAction.

Эта функция полезна для встраивания полезных внешних ссылок, документации или ссылок на поддержку непосредственно в ваши PDF-файлы.

Загрузите PDF‑документ. Откройте существующий PDF‑файл, используя ap.Document.
Получите доступ к первой странице. Используйте 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 в Python

Wed, 15 Apr 2026 00:00:00 +0000

Update LinkAnnotation Text Color

В этом примере показано, как обнаружить все аннотации ссылок на первой странице PDF с помощью Aspose.PDF for Python, а затем выделить текст рядом с каждой ссылкой, изменив цвет его шрифта на красный. Для поиска и изменения близлежащего текста используется 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)

Обновить границу

Скрипт ориентируется на первую страницу Document и фильтрует все аннотации, выбирая только те, которые имеют тип LINK — они обычно представляют интерактивные элементы, такие как гиперссылки или триггеры навигации. Для каждой из этих link annotations код приводит их к типу LinkAnnotation и обновляет их свойство color до красного, визуально выделяя их, чтобы они отличались от другого контента. После того как все link annotations были изменены, обновлённый Document сохраняется в указанное место вывода, сохраняя новое оформление.

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 и затем приводится к соответствующему типу LinkAnnotation. Если ссылка связана с 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 в Python

Wed, 15 Apr 2026 00:00:00 +0000

Извлечение ссылки из PDF‑файла

Этот пример демонстрирует, как перебрать все аннотации‑ссылки на первой странице PDF с использованием Aspose.PDF for Python. Он фильтрует аннотации, чтобы определить те, которые имеют тип LinkAnnotation, безопасно приводит их тип и затем выводит их индекс страницы и прямоугольную позицию на странице.

Это может использоваться для отладки, аналитики или автоматических обновлений существующих аннотаций‑ссылок в PDF.

Загрузите PDF‑документ. Используйте ap.Document(path_infile) для открытия файла.
Получите доступ к аннотациям первой страницы. Используйте document.pages[1].annotations для получения всех аннотаций.
Фильтруйте только типы LinkAnnotation. Проверьте поле annotation_type каждой аннотации.
Преобразуйте и обработайте LinkAnnotation. Используйте is_assignable() и cast() для безопасного доступа к свойствам LinkAnnotation.
Выведите детали аннотации. Выведите индекс страницы и прямоугольник (местоположение) каждой ссылки.

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‑файла

Этот код демонстрирует, как извлечь все объекты LinkAnnotation с первой страницы PDF‑документа с использованием Aspose.PDF for Python, а затем определить те, которые содержат действие GoToURIAction. Для каждой такой ссылки он выводит номер страницы и целевой URI.

Это полезно для таких задач, как:

Аудит внешних ссылок в PDF
Извлечение URL‑адресов документации или поддержки
Обнаружение битых или устаревших гиперссылок

Загрузите PDF‑документ. Откройте файл с помощью ap.Document.
Получите все аннотации ссылок с первой страницы. Отфильтруйте аннотации, оставив только те, у которых тип AnnotationType.LINK.
Проверьте тип и приведите к LinkAnnotation. Убедитесь, что каждая аннотация действительно является LinkAnnotation, прежде чем обращаться к её свойствам.
Проверьте тип действия ссылки. Отфильтруйте ссылки, использующие 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}")