Aggiungere immagini e testo alla sezione piè di pagina PDF può essere utile in vari scenari, come l’aggiunta di informazioni legali o di branding ai documenti. In molti settori, è un requisito comune aggiungere un logo aziendale o un disclaimer in fondo a ogni pagina di un documento. In altri casi, potrebbe essere necessario aggiungere numeri di pagina o altri metadati per aiutare a organizzare o identificare il documento. Indipendentemente dal caso d’uso specifico, la possibilità di aggiungere immagini e testo alla sezione piè di pagina di un documento PDF è una caratteristica importante per molte aziende e organizzazioni. In questo articolo, esploreremo come aggiungere immagini e testo alla sezione piè di pagina di un documento PDF utilizzando Python Cloud SDK.
Un altro termine usato per il footer è chiamato
running foot. È molto usato nel settore editoriale e viene chiamato così perché contiene una versione abbreviata dell’articolo o altre informazioni su di esso.
- Kit di sviluppo cloud Python
- Aggiungere il piè di pagina del testo in un PDF utilizzando Python
- Aggiungere il piè di pagina dell’immagine nel PDF utilizzando Python
- Aggiungere un piè di pagina di testo al PDF utilizzando il comando cURL
- Aggiungere un piè di pagina dell’immagine al PDF utilizzando il comando cURL
Kit di sviluppo cloud Python
Aspose.PDF Cloud SDK per Python fornisce un set di potenti funzionalità per lavorare con documenti PDF, tra cui la possibilità di aggiungere immagini e testo alla sezione del piè di pagina di un documento PDF. Questo SDK offre un’interfaccia semplice e intuitiva che semplifica l’esecuzione di varie attività correlate ai PDF a livello di programmazione. Utilizzando questo SDK, puoi aggiungere rapidamente e facilmente testo o immagini personalizzate al piè di pagina di qualsiasi documento PDF, conferendo un aspetto professionale e personalizzato ai tuoi documenti.
L’SDK è disponibile per il download tramite il repository PIP e GitHub. Tuttavia, puoi semplicemente eseguire il seguente comando sul terminale/prompt dei comandi per installare l’ultima versione dell’SDK sul sistema.
pip install asposepdfcloud
Il prossimo passo importante è ottenere le credenziali del cliente da Cloud dashboard. Se hai un account GitHub o Google, registrati semplicemente oppure clicca sul pulsante Crea un nuovo account e fornisci le informazioni richieste.
Immagine 1: Credenziali del cliente nella dashboard di Aspose.Cloud.
Aggiungere il piè di pagina del testo in un PDF utilizzando Python
Per aggiungere un piè di pagina di testo in un documento PDF utilizzando un frammento di codice Python, seguire i passaggi indicati di seguito.
- Il primo passo è creare un’istanza della classe ApiClient che richiede Client ID e Client Secret come argomenti.
- In secondo luogo, creare un’istanza della classe PdfApi che richieda l’oggetto ApiClient come argomento di input.
- In terzo luogo, creiamo un oggetto TextFooter in cui abbiamo impostato l’allineamento orizzontale su Centro, Opacità su 0,7, angolo di rotazione su 356 e abbiamo specificato il margine inferiore su 5.
- Per impostare la formattazione del testo per TextFooter, creiamo un oggetto TextState in cui definiamo il colore di primo piano, la dimensione del carattere, il nome del carattere, ecc.
- Ora dobbiamo impostare i valori per due parametri facoltativi che definiscono la pagina iniziale e finale del documento PDF in cui posizionare il piè di pagina del testo.
- Infine, chiama il metodo postdocumenttextfooter(..) per aggiungere il piè di pagina di testo al documento PDF e salvare il file risultante nell’archiviazione 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)
# crea un'istanza di PdfApi passando PdfApiClient come argomento
pdf_api = PdfApi(pdf_api_client)
# file PDF di input
input_file = 'marketing.pdf'
# Crea istanza TextFooter
textFooter = asposepdfcloud.TextFooter()
textFooter.background = True
# Imposta l'allineamento orizzontale per il piè di pagina come centro
textFooter.horizontal_alignment = 'Center'
# imposta l'opacità del piè di pagina su 0,7
textFooter.opacity = 0.7
textFooter.rotate = None
# imposta l'angolo di rotazione a 5 gradi
textFooter.rotate_angle = 5
textFooter.x_indent = 100
textFooter.y_indent = 100
textFooter.zoom = .8
# Valore testuale da visualizzare nella sezione Piè di pagina
textFooter.value = 'Aspose.PDF Cloud SDK for Python'
# crea un'istanza di TextState che definisce la formattazione del testo
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)
# assegna l'oggetto TextState a TextFooter
textFooter.text_state = textState
# pagina iniziale del PDF per il piè di pagina
startPage = 2
# fine pagina del PDF per piè di pagina
endPage = 3
# chiama l'API per aggiungere il piè di pagina del testo nel file PDF sulla seconda e terza pagina
response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
# stampa il codice di risposta nella console
print(response)
# stampa messaggio nella console (facoltativo)
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)
Immagine 2: Anteprima di TextFooter aggiunto al PDF.
Visitare il seguente link per scaricare l’input marketing.pdf e il risultante marketing-TextFooter.pdf.
Aggiungere il piè di pagina dell’immagine nel PDF utilizzando Python
L’API fornisce anche le capacità per aggiungere un footer Immagine a un file PDF. Seguire le istruzioni fornite di seguito per soddisfare questo requisito.
- Il primo passo è creare un’istanza della classe ApiClient che richiede Client ID e Client Secret come argomenti.
- In secondo luogo, creare un’istanza della classe PdfApi che richieda l’oggetto ApiClient come argomento di input.
- In terzo luogo, creiamo un oggetto ImageFooter in cui abbiamo impostato l’allineamento orizzontale su Centro, Opacità su 0,7, angolo di rotazione su 10, nome del file immagine, dettagli sui margini e altre proprietà sono specificate.
- Poiché dobbiamo aggiungere il piè di pagina solo alla prima pagina del documento, abbiamo impostato i valori per i parametri facoltativi startpagenumber ed endpagenumber.
- Infine, chiama il metodo postdocumentimagefooter(..) per aggiungere il piè di pagina di testo al documento PDF e salvare il file risultante nell’archiviazione 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)
# crea un'istanza di PdfApi passando PdfApiClient come argomento
pdf_api = PdfApi(pdf_api_client)
# documento PDF di input
input_file = 'marketing.pdf'
# Crea istanza ImageFooter
imageFooter = asposepdfcloud.ImageFooter()
# renderizza l'intestazione sopra il contenuto del PDF
imageFooter.background = False
# imposta l'allineamento a sinistra
imageFooter.horizontal_alignment = 'Left'
# imposta l'opacità al 70%
imageFooter.opacity = 0.7
imageFooter.rotate = None
imageFooter.rotate_angle = 10
imageFooter.x_indent = 10
imageFooter.y_indent = 10
imageFooter.zoom = .7
# file immagine di input
imageFooter.file_name = 'Koala.jpg'
# imposta i dettagli di larghezza e altezza dell'immagine
imageFooter.width = 100
imageFooter.height = 100
# specificare i dettagli del margine per l'immagine del piè di pagina
imageFooter.bottom_margin = 2
imageFooter.left_margin = 1
imageFooter.right_margin = 10
# pagina iniziale del documento a cui aggiungere il piè di pagina
startPage = 1
# pagina iniziale del documento a cui aggiungere il piè di pagina
endPage = 1
# chiama l'API per rendere il piè di pagina dell'immagine nel file PDF
response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
# stampa il codice di risposta nella console
print(response)
# stampa messaggio nella console (facoltativo)
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)
Immagine 3: Anteprima del piè di pagina dell’immagine nel PDF.
Il file risultante generato dall’esempio sopra riportato può essere scaricato da marketing-ImageFooter.pdf.
Aggiungere un piè di pagina di testo al PDF utilizzando il comando cURL
L’utilizzo dei comandi cURL e di Aspose.PDF Cloud per aggiungere testo e immagini nel piè di pagina PDF offre diversi vantaggi. Innanzitutto, elimina la necessità di modificare manualmente i documenti PDF, che può richiedere molto tempo ed essere soggetto a errori. In secondo luogo, consente una facile personalizzazione del testo dell’intestazione, con la possibilità di modificare il font, le dimensioni, il colore e la posizione del testo. In terzo luogo, consente agli utenti di aggiungere testo a più documenti PDF contemporaneamente, risparmiando tempo e aumentando l’efficienza. Infine, questo approccio fornisce un metodo sicuro e affidabile per aggiungere testo all’intestazione PDF, con tutti i dati trasmessi tramite una connessione sicura ed elaborati su server sicuri.
Ora, come prerequisito, generare un JSON Web Token (JWT) eseguendo il seguente comando.
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"
Ora che abbiamo generato il token JWT, dobbiamo eseguire il seguente comando per aggiungere TextFooter al file 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}"
Aggiungere un piè di pagina dell’immagine al PDF utilizzando il comando cURL
Eseguire il seguente comando per aggiungere l’intestazione dell’immagine al file PDF utilizzando il comando 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}"
Conclusione
In conclusione, aggiungere immagini e testo alla sezione piè di pagina di un documento PDF può essere una funzionalità utile per vari scopi, tra cui branding, conformità legale e organizzazione dei documenti. Aspose.PDF Cloud SDK per Python fornisce un modo comodo e potente per implementare questa funzionalità nella tua applicazione Python. D’altro canto, usare i comandi cURL con Aspose.PDF Cloud API può offrire flessibilità e semplicità per integrare la funzionalità in vari linguaggi di programmazione e ambienti. Indipendentemente dall’approccio scelto, Aspose.PDF Cloud offre strumenti robusti e affidabili per aggiungere immagini e testo alla sezione piè di pagina dei tuoi documenti PDF.
Link utili
Articoli correlati
Ti consigliamo di leggere i seguenti articoli per saperne di più: