Når det kommer til at skabe professionelle og visuelt tiltalende PDF-dokumenter, er muligheden for at tilføje billeder og tekst til overskriften en must-have-funktion. Overskriftssektionen er et af de vigtigste områder i et dokument, da det giver læserne væsentlige oplysninger såsom titel, forfatter og dato. Selvom tilføjelse af tekst til overskriften er en forholdsvis ligetil proces, kan tilføjelse af billeder være mere udfordrende, især for Python-udviklere, der er nye til PDF-dokumentgenerering. I denne artikel vil vi undersøge, hvordan du tilføjer billede og tekst til overskriften på et PDF-dokument ved hjælp af Python Cloud SDK.
Du kan tilføje billeder, logoer, datoen og klokkeslættet, du oprettede dokumentet, titlen på dokumentet, versions- eller revisionsnummer, udkast, forfatternavn og kapitelnavne i PDF-headeren.
- REST API til PDF-dokumentsamling
- Tilføj tekst til PDF-header ved hjælp af Python
- Tilføj billede til PDF-header ved hjælp af Python
- Tilføjelse af tekstoverskrift til PDF ved hjælp af cURL-kommando
- Tilføjelse af billedhoved til PDF ved hjælp af cURL-kommando
REST API til PDF-dokumentsamling
Aspose.PDF Cloud SDK for Python giver en række funktioner og metoder, der gør det muligt for udviklere at manipulere PDF-filer programmatisk. Det giver også et kraftfuldt og fleksibelt sæt værktøjer til at tilføje billeder og tekst til PDF-dokumenthoveder og kan nemt integreres i Python-applikationer til automatiseret PDF-dokumentbehandling. Hvad nu angår processen med at tilføje et billede til overskriften, involverer det at specificere billedets placering og dimensioner samt sidenummeret, som billedet skal vises på. Tilsvarende kræver tilføjelse af tekst til overskriften specificering af tekstindhold, skriftstørrelse og andre formateringsmuligheder. SDK’et giver også muligheder for at kontrollere justeringen og placeringen af overskriftsindholdet, samt for at angive baggrundsfarven for overskriften.
Nu skal vi først installere SDK’et, som er frit tilgængeligt for download over PIP og GitHub repository. Udfør blot følgende kommando for at installere den seneste version af SDK’et.
pip install asposepdfcloud
For at få adgang til REST API skal du registrere dig og få dine personlige legitimationsoplysninger. Tag et kig i Quick Start guide for at få relaterede oplysninger.
Tilføj tekst til PDF-header ved hjælp af Python
SDK’et giver dig mulighed for at tilføje tekststrenge til dokumentets overskriftssektion, og dette krav kan opfyldes ved at bruge følgende trin.
- For det første skal du oprette en forekomst af ApiClient-klassen, mens du angiver Client ID Client Secret som argumenter.
- For det andet skal du oprette et objekt af klassen PdfApi, som tager ApiClient-objektet som input-argument.
- For det tredje skal du oprette et objekt af TextHeader, der definerer egenskaberne for TextHeader-forekomsten.
- For at indstille tekstformatering for TextHeader skal du oprette et objekt af TextState, hvor vi definerer forgrundsfarve, skriftstørrelse, skrifttypenavn osv.
- Til sidst skal du kalde postdocumenttextheader(..)-metoden for at tilføje Text Header til PDF-dokument og gemme den resulterende fil til Cloud-lager.
def addTextHeader():
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)
# opret PdfApi-instans, mens du sender PdfApiClient som argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# Opret et objekt, der definerer tekstoverskrift
textHeader = asposepdfcloud.TextHeader()
# indstille værdien til at gengive header i baggrunden
textHeader.background = False
# indstil den vandrette justering for Tekstoverskrift som center
textHeader.horizontal_alignment = 'Center'
# sæt opaciteten af header til 0,5
textHeader.opacity = 0.5
# ingen rotationsvinkel
textHeader.rotate = None
textHeader.rotate_angle = 0
# sæt X- og Y-indrykningsværdier
textHeader.x_indent = 100
textHeader.y_indent = 100
# indstille zoomfaktoren til 1,0
textHeader.zoom = 1.0
# den tekstværdi, der skal gengives inde i overskriften
textHeader.value = 'Aspose.PDF Cloud'
# oprette en forekomst af TextState, der definerer formatering af tekst
textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
{"A": 0,
"R": 252,
"G": 173,
"B": 3},font_style=2)
# videregive TextState-objekt til TextHeader
textHeader.text_state = textState
# kalde API'et for at tilføje tekstoverskrift til PDF-dokument
response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
# udskrive svarkode i konsollen
print(response)
# udskriv besked i konsollen (valgfrit)
print('Text Header 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)
Billede 2:- Forhåndsvisning af teksthoved i PDF-dokument.
Inputtet og de resulterende PDF-filer kan downloades fra awesomeTable.pdf og awecomeTable-TextHeader.pdf.
Tilføj billede til PDF-header ved hjælp af Python
Følg venligst instruktionerne nedenfor for at tilføje et billedobjekt til PDF-hovedsektionen. Den resulterende fil uploades til skylageret.
- Først og fremmest skal du oprette en forekomst af ApiClient-klassen, mens du angiver Client ID Client Secret som argumenter.
- For det andet skal du oprette et objekt af klassen PdfApi, som tager ApiClient-objektet som input-argument.
- Opret nu et objekt af ImageHeader, der definerer egenskaberne for ImageHeader.
- For at kontrollere gengivelsen af header på visse sider, tildeles værdier til startsidenummer og slutsidenummer valgfrie parametre.
- Til sidst skal du kalde postdocumentimageheader(..)-metoden for at tilføje Image Header til PDF-dokument og gemme den resulterende fil til Cloud-lager. Bemærk, at header kun tilføjes til de første to sider af dokumentet (som angivet i koden).
def addImageHeader():
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)
# opret PdfApi-instans, mens du sender PdfApiClient som argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# oprette ImageHeader-forekomst
imageHeader = asposepdfcloud.ImageHeader()
# sæt baggrundsegenskaben som sand
imageHeader.background = True
# sæt vandret justering til højre
imageHeader.horizontal_alignment = 'Right'
imageHeader.opacity = 0.7
imageHeader.rotate = None
imageHeader.rotate_angle = 0
imageHeader.x_indent = 10
imageHeader.y_indent = 10
imageHeader.zoom = .5
# navn på billedfil, der er tilgængelig i skylageret, der skal tilføjes i overskriften
imageHeader.file_name = 'Koala.jpg'
# billedets bredde i sidehoved
imageHeader.width = 120
# højden af billedet i overskriften
imageHeader.height = 120
imageHeader.left_margin = 0
imageHeader.top_margin = 10
imageHeader.right_margin = 10
# startsiden af dokumentet for at tilføje sidehoved
startPage = 1
# slutside af dokument for at tilføje sidehoved
endPage = 2
# kald API'et for at tilføje billedoverskrift i PDF-dokument og gemme den resulterende fil i skylageret
response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
# pritn svarkode i konsollen
print(response)
# udskriv besked i konsollen (valgfrit)
print('Image Header 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)
Image 3:- Preview of Image Header added in PDF.
Kildefilerne og den resulterende fil genereret i ovenstående eksempel kan downloades fra
Tilføjelse af tekstoverskrift til PDF ved hjælp af cURL-kommando
cURL-kommandoerne giver en praktisk mekanisme til at få adgang til REST API’er gennem kommandolinjeterminaler. Da Aspose.PDF Cloud også er udviklet i henhold til REST-arkitektur, så kan vi også få adgang til API’et ved hjælp af cURL-kommandoer. Denne tilgang kan være nyttig for udviklere, der foretrækker at arbejde med kommandolinjeværktøjer, eller som har brug for at integrere PDF-headerredigering i en større automatiseringsworkflow.
For nu at bruge REST API’en skal vi generere et JSON Web accessToken (JWT) baseret på din klientoplysninger ved at udføre følgende kommando.
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"
Når vi har JWT-tokenet, prøv venligst at bruge følgende kommando til at tilføje tekst i dokumentets overskriftssektion på 1. og 2. side.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/text?startPageNumber=1&endPageNumber=2" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": false, \"HorizontalAlignment\": \"Center\", \"Opacity\": 0.5, \"Rotate\": \"None\", \"RotateAngle\": 0, \"XIndent\": 100, \"YIndent\": 10, \"Zoom\": 1.0, \"TextAlignment\": \"None\", \"Value\": \"Aspose.PDF Cloud\", \"TextState\": { \"FontSize\": 15, \"Font\": \"Arial\", \"ForegroundColor\": { \"A\": 0, \"R\": 252, \"G\": 173, \"B\": 3 }, \"BackgroundColor\": { \"A\": 10, \"R\": 0, \"G\": 0, \"B\": 0 } }, \"LeftMargin\": 0, \"TopMargin\": 0, \"RightMargin\": 0}"
Tilføjelse af billedhoved til PDF ved hjælp af cURL-kommandoen
Prøv venligst at bruge følgende cURL-kommando til at tilføje en billedoverskrift til et PDF-dokument og gemme den resulterende fil i skylageret. I den følgende kommando er billedoverskriften til 1. og 2. side i dokumentet, hvor opacitet er defineret som 0,7, zoomfaktor er 0,5, og billedhøjde og -breddeegenskaber er defineret som 120 punkter.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/header/image?startPageNumber=1&endPageNumber=2" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": true, \"HorizontalAlignment\": \"Right\", \"Opacity\": 0.7, \"Rotate\": \"None\", \"RotateAngle\": 0, \"XIndent\": 10, \"YIndent\": 10, \"Zoom\": .5, \"FileName\": \"Koala.jpg\", \"Width\": 120, \"Height\": 120, \"LeftMargin\": 0, \"TopMargin\": 10, \"RightMargin\": 10}"
Konklusion
Afslutningsvis er tilføjelse af et billede og tekst til overskriften på et PDF-dokument en nyttig funktion, der kan forbedre den visuelle appel og branding af dine dokumenter. Med Aspose.PDF Cloud SDK til Python er det en simpel opgave at udføre med blot et par linjer kode. Uanset om du opretter fakturaer, rapporter eller ethvert andet dokument, der kræver en sidehoved, kan denne funktion spare dig for tid og kræfter, mens du forbedrer kvaliteten af dit output. Udover at bruge Aspose.PDF Cloud SDK til Python, har vi også erfaret, at det også er muligt at tilføje billeder og tekst til PDF-headers ved hjælp af cURL-kommandoer.
Vi håber, at denne artikel har givet dig al den nødvendige vejledning og inspiration til at tilføje denne funktionalitet til din Python-applikation.
Nyttige links
Relaterede artikler
Vi anbefaler, at du besøger følgende artikler for at lære om: