Documentation – Trabajar con enlaces PDF en Python

Python-Net: Crear enlaces PDF en Python

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

Enlaces en documentos PDF

Según la especificación PDF 1.7 (ISO 32000-1:2008), una Link annotation puede activar varios tipos de acciones que definen lo que ocurre cuando se activa la anotación. Aquí están las acciones principales admitidas:

GoTo – Navega a un destino dentro del mismo documento.
GoToR – Salta a un destino en otro archivo PDF (go-to remoto).
URI – Abre un identificador uniforme de recursos, típicamente un enlace web.
Launch – Lanza una aplicación o abre un archivo (dependiendo de la plataforma y a menudo restringido por motivos de seguridad).
Named – Ejecuta una acción predefinida, como ir a la página siguiente o imprimir el documento.
JavaScript – Ejecuta código JavaScript incrustado (se usa con precaución debido a preocupaciones de seguridad).
SubmitForm – Envía los datos del formulario a una URL especificada.
ResetForm – Restablece los campos del formulario a sus valores predeterminados.
ImportData – Importa datos al documento desde un archivo externo.

Al agregar un enlace a una aplicación dentro de un documento, es posible enlazar a aplicaciones desde un documento. Esto es útil cuando deseas que los lectores realicen una acción determinada en un punto específico de un tutorial, por ejemplo, o para crear un documento con muchas funciones.

Para crear un enlace a una aplicación con ‘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)

Crear enlace de documento PDF en un archivo PDF

Usando GoToRemoteAction

Este fragmento de código demuestra cómo agregar una anotación de enlace a una página específica de un documento PDF usando una biblioteca PDF de Python.

Abre el documento PDF
Selecciona la segunda página del documento (índice 1)
Crea una anotación de enlace:
Posicionado en las coordenadas (10, 580, 120, 600)
Coloreado verde
Enlaces a ‘sample.pdf’ en su primera página
Agregar la anotación de enlace a la página
Guardar el documento modificado en la ruta del archivo de salida

Para crear un enlace de documento PDF usando ‘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)

Usando GoToAction

Este código muestra cómo agregar una anotación de enlace a una página específica de un documento PDF usando Aspose.PDF for Python. El enlace aparece como un rectángulo verde con borde discontinuo y permite al usuario navegar a otra página dentro del mismo PDF. Para crear un enlace de documento PDF usando ‘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)

Aplicando GoToURIAction

El siguiente ejemplo muestra cómo agregar una anotación de enlace a un documento PDF usando Aspose.PDF for Python. El enlace aparece como un área verde clicable en la primera página, y al hacer clic, abre la documentación de Aspose.PDF for Python en un navegador web mediante una GoToURIAction.

Esta funcionalidad es útil para incrustar referencias externas útiles, documentación o enlaces de soporte directamente dentro de sus PDFs.

Cargue el documento PDF. Abra el archivo PDF existente usando ap.Document.
Acceda a la primera página. Use document.pages[1] para acceder a la primera página (Aspose usa indexación basada en 1).
Cree una anotación de enlace. Cree un objeto LinkAnnotation y especifique el área rectangular clicable usando ap.Rectangle.
Establecer apariencia de la anotación. Establecer el color de la anotación a verde usando link.color = ap.Color.green.
Asignar una acción URI. Utilizar GoToURIAction para vincular la anotación a una URL externa.
Agregar la anotación a la página. Añadir la anotación de enlace configurada a la colección de anotaciones de la primera página.
Guardar el documento modificado. Guardar el documento PDF actualizado en la ruta de salida especificada.

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)

Temas relacionados de enlaces

Python-Net: Actualizar enlaces PDF en Python

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

Actualizar color de texto de LinkAnnotation

Este ejemplo muestra cómo detectar todas las anotaciones de enlace en la primera página de un PDF usando Aspose.PDF for Python, y luego resaltar el texto cercano a cada enlace cambiando el color de su fuente a rojo. Utiliza TextFragmentAbsorber con un área ligeramente ampliada alrededor de cada rectángulo de enlace para encontrar y modificar el texto cercano.

Esto se puede usar para:

Marcar visualmente los enlaces en un documento
Mejorar la accesibilidad enfatizando el contenido enlazado
Preprocesamiento de archivos PDF antes de la revisión o exportación

Para cada una de estas anotaciones de enlace, el script recupera su límite rectangular y amplía ligeramente esa región para incluir texto cercano, lo que permite una identificación visual más amplia. Luego aplica un TextFragmentAbsorber sobre esta área ampliada para extraer cualquier fragmento de texto situado dentro de ella. Estos fragmentos capturados se modifican cambiando su color de fuente a rojo, marcando efectivamente el texto circundante para enfatizar y revisar. Después de aplicar todas estas actualizaciones, el documento modificado se guarda en la ruta de salida, preservando las anotaciones resaltadas y su texto asociado.

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)

Actualizar borde

El script se centra en la primera página del documento y filtra todas las anotaciones, seleccionando solo aquellas del tipo LINK—estas generalmente representan elementos interactivos, como hipervínculos o disparadores de navegación. Para cada una de estas anotaciones de enlace, el código las convierte al tipo LinkAnnotation y actualiza su propiedad de color a rojo, resaltándolas visualmente para que se destaquen del resto del contenido. Después de que todas las anotaciones de enlace hayan sido modificadas, el documento actualizado se guarda en la ubicación de salida definida, preservando el nuevo estilo.

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)

Actualizar destino web

Una vez que las rutas están en su lugar, el documento original se carga utilizando la biblioteca Aspose.PDF, lo que permite que su contenido sea accesible para su modificación. El script luego se centra en la primera página del documento, filtrando todas las anotaciones y seleccionando solo aquellas de tipo enlace, que normalmente representan áreas clicables o hipervínculos. Para evitar errores de tipo y garantizar un manejo seguro, cada anotación se verifica con is_assignable y luego se convierte al tipo LinkAnnotation apropiado. Si el enlace está asociado a una GoToURIAction, lo que significa que apunta a una dirección web, el script actualiza esa URI para redirigir a los usuarios ahttps://www.aspose.com". Finalmente, después de que se hayan aplicado todos los cambios deseados, el documento modificado se guarda en la ruta de salida especificada.

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)

Temas relacionados de enlaces

Python-Net: Extraer enlaces PDF en Python

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

Extraer enlaces del archivo PDF

Este ejemplo muestra cómo iterar a través de todas las anotaciones de enlace en la primera página de un PDF usando Aspose.PDF for Python. Filtra las anotaciones para identificar aquellas de tipo LinkAnnotation, las convierte de forma segura y luego imprime su índice de página y su posición rectangular en la página.

Esto puede usarse para depuración, análisis o actualizaciones automáticas de anotaciones de enlace existentes en un PDF.

Cargue el documento PDF. Use ap.Document(path_infile) para abrir el archivo.
Acceda a las anotaciones de la primera página. Use document.pages[1].annotations para obtener todas las anotaciones.
Filtre solo los tipos LinkAnnotation. Verifique el annotation_type de cada anotación.
Convierta y procese las LinkAnnotations. Use is_assignable() y cast() para garantizar un acceso seguro a las propiedades de LinkAnnotation.
Imprimir detalles de anotaciones. Salida del índice de página y del rectángulo (ubicación) de cada enlace.

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}")

Extraer hipervínculos del archivo PDF

Este código demuestra cómo extraer todos los objetos LinkAnnotation de la primera página de un documento PDF usando Aspose.PDF for Python, y luego identificar aquellos que contienen un GoToURIAction. Para cada uno de esos enlaces, imprime el índice de página y el URI de destino.

Esto es útil para tareas como:

Auditar enlaces externos en un PDF
Extraer URLs de documentación o soporte
Detectar hipervínculos rotos o desactualizados

Cargar el documento PDF. Abrir el archivo usando ap.Document.
Obtenga todas las anotaciones de enlace de la primera página. Filtre las anotaciones para incluir solo aquellas con el tipo AnnotationType.LINK.
Verifique el tipo y convierta a LinkAnnotation. Asegúrese de que cada anotación sea realmente una LinkAnnotation antes de acceder a sus propiedades.
Compruebe el tipo de acción del enlace. Filtre los enlaces que utilizan un GoToURIAction (es decir, enlaces a una URL web).
Extraiga e imprima el URI y el índice de página. Utilice .uri para obtener el enlace externo y .page_index para el contexto.

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}")