Maîtriser la modification PDF : comment ajouter une image et du texte au pied de page PDF avec Python

L’ajout d’images et de texte à la section de pied de page PDF peut être utile dans divers scénarios, comme l’ajout d’informations de marque ou juridiques aux documents. Dans de nombreux secteurs, il est courant d’ajouter un logo d’entreprise ou une clause de non-responsabilité au bas de chaque page d’un document. Dans d’autres cas, il peut être nécessaire d’ajouter des numéros de page ou d’autres métadonnées pour aider à organiser ou à identifier le document. Quel que soit le cas d’utilisation spécifique, la possibilité d’ajouter des images et du texte à la section de pied de page d’un document PDF est une fonctionnalité importante pour de nombreuses entreprises et organisations. Dans cet article, nous allons découvrir comment ajouter des images et du texte à la section de pied de page d’un document PDF à l’aide de Python Cloud SDK.

Un autre terme utilisé pour le pied de page est appelé « pied courant ». Il est très utilisé dans le secteur de l’édition et est appelé ainsi car il contient une version abrégée de l’article ou d’autres informations le concernant.

Kit de développement logiciel Python Cloud
Ajouter un pied de page de texte dans un PDF à l’aide de Python
Ajouter un pied de page d’image dans un PDF à l’aide de Python
Ajout d’un pied de page de texte au PDF à l’aide de la commande cURL
Ajout d’un pied de page d’image au PDF à l’aide de la commande cURL

Kit de développement logiciel Python Cloud

Aspose.PDF Cloud SDK for Python fournit un ensemble de fonctionnalités puissantes pour travailler avec des documents PDF, notamment la possibilité d’ajouter une image et du texte à la section de pied de page d’un document PDF. Ce SDK offre une interface simple et intuitive qui facilite l’exécution de diverses tâches liées aux PDF par programmation. Grâce à ce SDK, vous pouvez ajouter rapidement et facilement du texte ou des images personnalisés au pied de page de n’importe quel document PDF, offrant ainsi un aspect professionnel et personnalisé à vos documents.

Le SDK est disponible en téléchargement sur les référentiels PIP et GitHub. Cependant, vous pouvez simplement exécuter la commande suivante sur le terminal/l’invite de commande pour installer la dernière version du SDK sur le système.

pip install asposepdfcloud

L’étape suivante consiste à obtenir les informations d’identification du client à partir du tableau de bord Cloud. Si vous avez un compte GitHub ou Google, inscrivez-vous simplement ou cliquez sur le bouton Créer un nouveau compte et fournissez les informations requises.

Ajouter un pied de page de texte dans un PDF à l’aide de Python

Veuillez suivre les étapes ci-dessous pour ajouter un pied de page de texte dans un document PDF à l’aide d’un extrait de code Python.

La première étape consiste à créer une instance de la classe ApiClient qui nécessite l’ID client et le secret client comme arguments.
Deuxièmement, créez une instance de la classe PdfApi qui nécessite l’objet ApiClient comme argument d’entrée.
Troisièmement, créez un objet TextFooter où nous avons défini l’alignement horizontal comme Centre, l’opacité comme 0,7, l’angle de rotation comme 356 et avons spécifié la marge inférieure comme 5.
Afin de définir la mise en forme du texte pour TextFooter, créez un objet TextState dans lequel nous définissons la couleur de premier plan, la taille de la police, le nom de la police, etc.
Nous devons maintenant définir des valeurs pour deux paramètres facultatifs définissant la page de début et de fin du document PDF pour placer le pied de page de texte.
Enfin, appelez la méthode postdocumenttextfooter(..) pour ajouter un pied de page de texte au document PDF et enregistrer le fichier résultant sur le stockage Cloud.

def addTextFooter():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # créer une instance PdfApi en passant PdfApiClient comme argument
        pdf_api = PdfApi(pdf_api_client)

        # fichier PDF d'entrée
        input_file = 'marketing.pdf'

        # Créer une instance de TextFooter
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # Définir l'alignement horizontal du pied de page comme étant centré
        textFooter.horizontal_alignment = 'Center'
        # définir l'opacité du pied de page à 0,7
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # définir l'angle de rotation à 5 degrés
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # Valeur textuelle à afficher dans la section Pied de page
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # créer une instance de TextState définissant le formatage du texte
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 66,
              "G": 111,
              "B": 245},
              background_color= {
              "A": 10,
              "R": 179,
              "G": 245,
              "B": 66},
              font_style=1)
        # attribuer un objet TextState à TextFooter
        textFooter.text_state = textState
        
        # page de démarrage du PDF pour le pied de page
        startPage = 2
        # page de fin du PDF pour le pied de page
        endPage = 3

        # appeler l'API pour ajouter un pied de page de texte dans le fichier PDF sur la 2e et la 3e page
        response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
        
        # imprimer le code de réponse dans la console
        print(response)
        
        # imprimer un message dans la console (facultatif)
        print('Text Footer successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

Aperçu du pied de page du texte — Image 2 : Aperçu du texteFooter ajouté au PDF.

Veuillez visiter le lien suivant pour télécharger l’entrée marketing.pdf et le résultat marketing-TextFooter.pdf.

L’API permet également d’ajouter un pied de page d’image à un fichier PDF. Veuillez suivre les instructions ci-dessous pour répondre à cette exigence.

La première étape consiste à créer une instance de la classe ApiClient qui nécessite l’ID client et le secret client comme arguments.
Deuxièmement, créez une instance de la classe PdfApi qui nécessite l’objet ApiClient comme argument d’entrée.
Troisièmement, créez un objet ImageFooter où nous avons défini l’alignement horizontal comme Centre, l’opacité comme 0,7, l’angle de rotation comme 10, le nom du fichier image, les détails de la marge et d’autres propriétés sont spécifiés.
Étant donné que nous devons uniquement ajouter le pied de page à la première page du document, nous avons défini des valeurs pour les paramètres facultatifs startpagenumber et endpagenumber.
Enfin, appelez la méthode postdocumentimagefooter(..) pour ajouter un pied de page de texte au document PDF et enregistrer le fichier résultant sur le stockage Cloud.

def addImageFooter():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # créer une instance PdfApi en passant PdfApiClient comme argument
        pdf_api = PdfApi(pdf_api_client)

        # document PDF d'entrée
        input_file = 'marketing.pdf'
        
        # Créer une instance ImageFooter
        imageFooter = asposepdfcloud.ImageFooter()
        
        # rendre l'en-tête au-dessus du contenu PDF
        imageFooter.background = False
        # définir l'alignement à gauche
        imageFooter.horizontal_alignment = 'Left'
        # définir l'opacité à 70 %
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # fichier image d'entrée
        imageFooter.file_name = 'Koala.jpg'
        # définir les détails de la largeur et de la hauteur de l'image
        imageFooter.width = 100
        imageFooter.height = 100
        # spécifier les détails de marge pour l'image de pied de page
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # page de démarrage du document pour ajouter un pied de page
        startPage = 1
        # page de démarrage du document pour ajouter un pied de page
        endPage = 1

        # appeler l'API pour afficher le pied de page de l'image dans le fichier PDF
        response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
        
        # imprimer le code de réponse dans la console
        print(response)
        
        # imprimer un message dans la console (facultatif)
        print('Image Footer successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

Pied de page de l'image dans le PDF — Image 3 : Aperçu du pied de page de l’image au format PDF.

Le fichier résultant généré par l’exemple ci-dessus peut être téléchargé à partir de marketing-ImageFooter.pdf.

Ajout d’un pied de page de texte au PDF à l’aide de la commande cURL

L’utilisation des commandes cURL et d’Aspose.PDF Cloud pour ajouter du texte et des images dans le pied de page d’un PDF offre plusieurs avantages. Tout d’abord, elle élimine le besoin d’édition manuelle des documents PDF, qui peut prendre du temps et être sujette à des erreurs. Ensuite, elle permet de personnaliser facilement le texte de l’en-tête, avec la possibilité de modifier la police, la taille, la couleur et la position du texte. Troisièmement, elle permet aux utilisateurs d’ajouter du texte à plusieurs documents PDF simultanément, ce qui permet de gagner du temps et d’augmenter l’efficacité. Enfin, cette approche fournit une méthode sûre et fiable pour ajouter du texte à l’en-tête du PDF, toutes les données étant transmises via une connexion sécurisée et traitées sur des serveurs sécurisés.

Maintenant, comme prérequis, générez un jeton Web JSON (JWT) en exécutant la commande suivante.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Maintenant que nous avons généré le jeton JWT, nous devons exécuter la commande suivante pour ajouter TextFooter au fichier PDF.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/text?startPageNumber=2&endPageNumber=3" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"Center\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 5,  \"XIndent\": 100,  \"YIndent\": 100,  \"Zoom\": 0.8,  \"Value\": \"Aspose.PDF Cloud SDK for Python\",  \"TextState\": {    \"FontSize\": 15,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 66,      \"G\": 111,      \"B\": 245    },    \"BackgroundColor\": {      \"A\": 10,      \"R\": 179,      \"G\": 245,      \"B\": 66    },    \"FontStyle\": \"Regular\"  },  \"BottomMargin\": 3,  \"LeftMargin\": 3,  \"RightMargin\": 3}"

Veuillez exécuter la commande suivante pour ajouter l’en-tête de l’image au fichier PDF à l’aide de la commande cURL.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/image?startPageNumber=1&endPageNumber=1" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": false,  \"HorizontalAlignment\": \"Left\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 10,  \"XIndent\": 10,  \"YIndent\": 10,  \"Zoom\": 0.7,  \"FileName\": \"Koala.jpg\",  \"Width\": 100,  \"Height\": 100,  \"BottomMargin\": 2,  \"LeftMargin\": 1,  \"RightMargin\": 10}"

Conclusion

En conclusion, l’ajout d’images et de texte à la section de pied de page d’un document PDF peut être une fonctionnalité utile à diverses fins, notamment la valorisation de la marque, la conformité juridique et l’organisation des documents. Aspose.PDF Cloud SDK pour Python offre un moyen pratique et puissant d’implémenter cette fonctionnalité dans votre application Python. D’autre part, l’utilisation des commandes cURL avec l’API Aspose.PDF Cloud peut offrir flexibilité et simplicité pour intégrer la fonctionnalité dans divers langages et environnements de programmation. Quelle que soit l’approche que vous choisissez, Aspose.PDF Cloud propose des outils robustes et fiables pour ajouter des images et du texte à la section de pied de page de vos documents PDF.

Liens utiles

Documentation produit

Référence API

Code source complet du SDK

Forum d’assistance technique gratuit

Articles connexes

Nous vous recommandons de consulter les articles suivants pour en savoir plus sur :

Kit de développement logiciel Python Cloud#

Ajouter un pied de page de texte dans un PDF à l’aide de Python#

Ajouter un pied de page d’image dans un PDF à l’aide de Python#

Ajout d’un pied de page de texte au PDF à l’aide de la commande cURL#

Ajout d’un pied de page d’image au PDF à l’aide de la commande cURL#

Conclusion#

Liens utiles#

Articles connexes#