Documentation – Travailler avec les liens PDF en Python

Python-Net: Créer des liens PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Liens dans les documents PDF

Selon la spécification PDF 1.7 (ISO 32000-1:2008), une annotation de lien peut déclencher plusieurs types d’actions qui définissent ce qui se passe lorsque l’annotation est activée. Voici les actions principales prises en charge :

GoTo – Navigue vers une destination dans le même document.
GoToR – Saute vers une destination dans un autre fichier PDF (go‑to distant).
URI – Ouvre un identifiant uniforme de ressource, généralement un lien web.
Launch – Lance une application ou ouvre un fichier (dépendant de la plateforme et souvent restreint pour des raisons de sécurité).
Named – Exécute une action prédéfinie, telle que passer à la page suivante ou imprimer le document.
JavaScript – Exécute du code JavaScript intégré (utilisé avec précaution en raison de problèmes de sécurité).
SubmitForm – Envoie les données du formulaire à une URL spécifiée.
ResetForm – Réinitialise les champs du formulaire à leurs valeurs par défaut.
ImportData – Importe des données dans le document depuis un fichier externe.

En ajoutant un lien vers une application dans un document, il est possible de créer des liens vers des applications depuis un document. Cela est utile lorsque vous souhaitez que les lecteurs effectuent une action précise à un moment donné d’un didacticiel, par exemple, ou pour créer un document riche en fonctionnalités.

Pour créer un lien d’application avec ‘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)

Créer un lien de document PDF dans un fichier PDF

Utilisation de GoToRemoteAction

Cet extrait de code montre comment ajouter une annotation de lien à une page spécifique d’un document PDF à l’aide d’une bibliothèque PDF Python.

Ouvrez le document PDF
Sélectionnez la deuxième page du document (indice 1)
Créez une annotation de lien :
Positionné aux coordonnées (10, 580, 120, 600)
Coloré en vert
Liens vers ‘sample.pdf’ sur sa première page
Ajouter l’annotation de lien à la page
Enregistrez le document modifié vers le chemin du fichier de sortie

Pour créer un lien de document PDF en utilisant ‘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)

Utilisation de GoToAction

Ce code montre comment ajouter une annotation de lien à une page spécifique d’un document PDF à l’aide d’Aspose.PDF for Python. Le lien apparaît sous la forme d’un rectangle vert bordé de tirets et permet à l’utilisateur de naviguer vers une autre page du même PDF. Pour créer un lien de document PDF en utilisant ‘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)

Appliquer GoToURIAction

L’exemple suivant montre comment ajouter une annotation de lien à un document PDF en utilisant Aspose.PDF for Python. Le lien apparaît sous la forme d’une zone cliquable verte sur la première page et, lorsqu’on clique dessus, il ouvre la documentation Aspose.PDF for Python dans un navigateur web via une GoToURIAction.

Cette fonctionnalité est utile pour intégrer des références externes utiles, de la documentation ou des liens d’assistance directement dans vos PDF.

Chargez le Document PDF. Ouvrez le fichier PDF existant en utilisant ap.Document.
Accédez à la première page. Utilisez document.pages[1] pour accéder à la première page (Aspose utilise un indice basé sur 1).
Créez une annotation de lien. Créez un objet LinkAnnotation et spécifiez la zone rectangulaire cliquable en utilisant ap.Rectangle.
Définir l’apparence de l’annotation. Définir la couleur de l’annotation sur vert en utilisant link.color = ap.Color.green.
Attribuer une action URI. Utiliser GoToURIAction pour lier l’annotation à une URL externe.
Ajouter l’annotation à la page. Ajouter l’annotation de lien configurée à la collection d’annotations de la première page.
Enregistrer le document modifié. Enregistrer le document PDF mis à jour vers le chemin de sortie spécifié.

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)

Sujets liés aux liens

Python-Net: Mettre à jour les liens PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Mettre à jour la couleur du texte LinkAnnotation

Cet exemple montre comment détecter toutes les annotations de lien sur la première page d’un PDF en utilisant Aspose.PDF for Python, puis surligner le texte près de chaque lien en changeant la couleur de la police en rouge. Il utilise TextFragmentAbsorber avec une zone légèrement élargie autour de chaque rectangle de lien pour trouver et modifier le texte à proximité.

Cela peut être utilisé pour:

Marquer visuellement les liens dans un document
Améliorer l’accessibilité en mettant en évidence le contenu lié
Prétraitement des fichiers PDF avant la révision ou l’exportation

Pour chacune de ces annotations de lien, le script récupère sa frontière rectangulaire et étend légèrement cette région pour inclure le texte voisin, permettant une identification visuelle plus large. Il applique ensuite un TextFragmentAbsorber sur cette zone agrandie afin d’extraire les fragments de texte qui s’y trouvent. Ces fragments capturés sont modifiés en changeant leur couleur de police en rouge, marquant ainsi le texte environnant pour mettre en évidence et réviser. Après avoir appliqué toutes ces modifications, le document modifié est enregistré dans le chemin de sortie, en conservant les annotations mises en surbrillance et leur texte associé.

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)

Mettre à jour la bordure

Le script se concentre sur la première page du document et filtre toutes les annotations, ne sélectionnant que celles de type LINK — ces dernières représentent généralement des éléments interactifs, tels que des hyperliens ou des déclencheurs de navigation. Pour chacune de ces annotations de lien, le code les convertit en type LinkAnnotation et met à jour leur propriété couleur en rouge, les mettant en évidence visuellement afin qu’elles se distinguent du reste du contenu. Après que toutes les annotations de lien ont été modifiées, le document mis à jour est enregistré à l’emplacement de sortie défini, en conservant le nouveau style.

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)

Mettre à jour la destination Web

Une fois les chemins en place, le document original est chargé à l’aide de la bibliothèque Aspose.PDF, rendant son contenu accessible à la modification. Le script se concentre ensuite sur la première page du document, en filtrant toutes les annotations et en ne sélectionnant que celles de type lien, représentant généralement des zones cliquables ou des hyperliens. Pour éviter les erreurs de type et garantir une manipulation sûre, chaque annotation est vérifiée avec is_assignable puis convertie en type LinkAnnotation approprié. Si le lien est associé à une GoToURIAction, signifiant qu’il pointe vers une adresse web, le script met à jour cette URI pour rediriger les utilisateurs vers “https://www.aspose.com”. Enfin, après que toutes les modifications souhaitées ont été appliquées, le document modifié est enregistré à l’emplacement de sortie spécifié.

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)

Sujets liés aux liens

Python-Net: Extraire les liens PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Extraire les liens du fichier PDF

Cet exemple montre comment parcourir toutes les annotations de lien sur la première page d’un PDF en utilisant Aspose.PDF for Python. Il filtre les annotations pour identifier celles de type LinkAnnotation, les convertit en toute sécurité, puis affiche leur indice de page et leur position rectangulaire sur la page.

Cela peut être utilisé pour le débogage, l’analyse, ou les mises à jour automatisées des annotations de lien existantes dans un PDF.

Chargez le document PDF. Utilisez ap.Document(path_infile) pour ouvrir le fichier.
Accédez aux annotations de la première page. Utilisez document.pages[1].annotations pour récupérer toutes les annotations.
Filtrez uniquement les types LinkAnnotation. Vérifiez l’annotation_type de chaque annotation.
Convertissez et traitez les LinkAnnotations. Utilisez is_assignable() et cast() pour garantir un accès sécurisé aux propriétés de LinkAnnotation.
Imprimer les détails de l’annotation. Afficher l’indice de page et le rectangle (emplacement) de chaque lien.

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

Extraire les hyperliens du fichier PDF

Ce code montre comment extraire tous les objets LinkAnnotation de la première page d’un document PDF à l’aide d’Aspose.PDF for Python, puis identifier ceux qui contiennent une GoToURIAction. Pour chaque lien de ce type, il affiche l’indice de page et l’URI cible.

Ceci est utile pour des tâches telles que :

Audit des liens externes dans un PDF
Extraction des URL de documentation ou de support
Détection des hyperliens cassés ou obsolètes

Chargez le document PDF. Ouvrez le fichier en utilisant ap.Document.
Obtenez toutes les annotations de lien de la première page. Filtrez les annotations pour n’inclure que celles de type AnnotationType.LINK.
Vérifiez le type et effectuez le cast en LinkAnnotation. Assurez-vous que chaque annotation soit bien une LinkAnnotation avant d’accéder à ses propriétés.
Vérifiez le type d’action du lien. Filtrez les liens qui utilisent un GoToURIAction (c’est‑à‑dire les liens vers une URL web).
Extrayez et affichez l’URI et l’indice de page. Utilisez .uri pour obtenir le lien externe et .page_index pour le contexte.

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