Créer des liens PDF en Python

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

Mettre à jour les liens PDF en Python