Ha professzionális és tetszetős PDF-dokumentumokról van szó, a fejléchez képek és szövegek hozzáadásának képessége elengedhetetlen szolgáltatás. A fejléc a dokumentum egyik legfontosabb területe, mivel olyan lényeges információkat nyújt az olvasóknak, mint a cím, a szerző és a dátum. Míg a fejléchez szöveg hozzáadása viszonylag egyszerű folyamat, a képek hozzáadása nagyobb kihívást jelenthet, különösen azoknak a Python-fejlesztőknek, akik még nem ismerik a PDF-dokumentumok generálását. Ebben a cikkben megvizsgáljuk, hogyan lehet képet és szöveget hozzáadni egy PDF-dokumentum fejlécéhez a Python Cloud SDK használatával.
A PDF fejlécében képeket, logókat, a dokumentum létrehozásának dátumát és időpontját, a dokumentum címét, verzió- vagy revíziószámát, piszkozatot, szerző nevét és fejezetneveket adhatja hozzá.
- REST API PDF-dokumentum-összeállításhoz
- Szöveg hozzáadása a PDF fejléchez Python segítségével
- Kép hozzáadása a PDF fejléchez Python segítségével
- Szövegfejléc hozzáadása a PDF-hez a cURL paranccsal
- Képfejléc hozzáadása a PDF-hez a cURL paranccsal
REST API a PDF-dokumentum-összeállításhoz
Az Aspose.PDF Cloud SDK for Python számos olyan funkciót és módszert kínál, amelyek lehetővé teszik a fejlesztők számára a PDF-fájlok programozott kezelését. Hatékony és rugalmas eszközkészletet biztosít képek és szövegek PDF-dokumentumfejlécekhez való hozzáadásához, és könnyen integrálható Python-alkalmazásokba az automatizált PDF-dokumentum-feldolgozáshoz. Ami a kép fejléchez való hozzáadásának folyamatát illeti, meg kell adni a kép helyét és méretét, valamint azt az oldalszámot, amelyen a képnek megjelennie kell. Hasonlóképpen, ha szöveget ad hozzá a fejléchez, meg kell adni a szöveg tartalmát, betűméretét és egyéb formázási beállításokat. Az SDK lehetőséget biztosít a fejléctartalom igazításának és elhelyezésének szabályozására, valamint a fejléc háttérszínének megadására is.
Most először telepítenünk kell az SDK-t, amely ingyenesen letölthető PIP és GitHub tárolón keresztül. Egyszerűen hajtsa végre a következő parancsot az SDK legújabb verziójának telepítéséhez.
pip install asposepdfcloud
A REST API eléréséhez regisztrálnia kell, és meg kell szereznie személyes hitelesítő adatait. Kérjük, tekintse meg a Gyors kezdési útmutatót a kapcsolódó információkért.
Szöveg hozzáadása a PDF fejléchez Python segítségével
Az SDK lehetővé teszi szöveges karakterláncok hozzáadását a dokumentum fejlécrészéhez, és ez a követelmény a következő lépésekkel teljesíthető.
- Először is hozzon létre egy példányt az ApiClient osztályból, miközben argumentumként adja meg a Client ID Client Secretet.
- Másodszor, hozzon létre egy PdfApi osztályú objektumot, amely az ApiClient objektumot veszi be bemeneti argumentumként.
- Harmadszor, hozzon létre egy TextHeader objektumot, amely meghatározza a TextHeader példány tulajdonságait.
- A TextHeader szövegformázásának beállításához hozzon létre egy TextState objektumot, ahol meghatározzuk az előtér színét, a betűméretet, a betűtípus nevét stb.
- Végül hívja meg a postdocumenttextheader(..) metódust, hogy szöveges fejlécet adjon a PDF-dokumentumhoz, és mentse az eredményül kapott fájlt a felhőtárhelyre.
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)
# hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# Hozzon létre egy szövegfejlécet meghatározó objektumot
textHeader = asposepdfcloud.TextHeader()
# állítsa be az értéket, hogy a fejléc a háttérben jelenjen meg
textHeader.background = False
# állítsa be a szöveg fejléc vízszintes igazítását középre
textHeader.horizontal_alignment = 'Center'
# állítsa be a fejléc átlátszatlanságát 0,5-re
textHeader.opacity = 0.5
# nincs elforgatási szög
textHeader.rotate = None
textHeader.rotate_angle = 0
# állítsa be az X és Y behúzás értékét
textHeader.x_indent = 100
textHeader.y_indent = 100
# állítsa a zoom tényezőt 1,0-ra
textHeader.zoom = 1.0
# a fejlécben megjelenítendő szöveg érték
textHeader.value = 'Aspose.PDF Cloud'
# a szöveg formázását meghatározó TextState példány létrehozása
textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
{"A": 0,
"R": 252,
"G": 173,
"B": 3},font_style=2)
# adja át a TextState objektumot a TextHeadernek
textHeader.text_state = textState
# hívja meg az API-t, hogy szöveges fejlécet adjon a PDF-dokumentumhoz
response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
# válaszkód kinyomtatása a konzolban
print(response)
# üzenet nyomtatása a konzolon (opcionális)
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)
- kép: – Szövegfejléc előnézete a PDF dokumentumban.
A bemeneti és az eredményül kapott PDF-fájlok letölthetők az awesomeTable.pdf és az awecomeTable-TextHeader.pdf oldalról.
Kép hozzáadása a PDF fejléchez Python segítségével
Kérjük, kövesse az alábbi utasításokat, ha képobjektumot szeretne hozzáadni a PDF fejléc részéhez. Az eredményül kapott fájl feltöltődik a felhőtárhelyre.
- Először is hozzon létre egy ApiClient osztály példányt, miközben argumentumként adja meg a Client ID Client Secretet.
- Másodszor, hozzon létre egy PdfApi osztályú objektumot, amely az ApiClient objektumot veszi be bemeneti argumentumként.
- Most hozzon létre egy ImageHeader objektumot, amely meghatározza az ImageHeader tulajdonságait.
- A fejlécek megjelenítésének szabályozása érdekében bizonyos oldalakon értékeket rendelünk a startpagenumber és endpagenumber opcionális paraméterekhez.
- Végül hívja meg a postdocumentimageheader(..) metódust, hogy képfejlécet adjon a PDF-dokumentumhoz, és mentse az eredményül kapott fájlt a felhőtárhelyre. Figyelje meg, hogy a fejléc csak a dokumentum első két oldalához kerül hozzáadásra (a kódban meghatározottak szerint).
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)
# hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# hozzon létre ImageHeader példányt
imageHeader = asposepdfcloud.ImageHeader()
# állítsa be a háttértulajdonságot true-ra
imageHeader.background = True
# állítsa be a vízszintes igazítást Jobbra
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
# a felhőtárhelyen elérhető képfájl neve, amelyet a fejlécbe kell hozzáadni
imageHeader.file_name = 'Koala.jpg'
# kép szélessége a fejlécben
imageHeader.width = 120
# a kép magassága a fejlécben
imageHeader.height = 120
imageHeader.left_margin = 0
imageHeader.top_margin = 10
imageHeader.right_margin = 10
# a dokumentum kezdőoldala fejléc hozzáadásához
startPage = 1
# a dokumentum végoldala fejléc hozzáadásához
endPage = 2
# hívja meg az API-t a képfejléc hozzáadásához a PDF-dokumentumhoz, és az eredményül kapott fájlt felhőtárhelyre menti
response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
# válaszkód nyomtatása a konzolban
print(response)
# üzenet nyomtatása a konzolon (opcionális)
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.
A fenti példában generált forrásfájlok és eredményfájl letölthetők innen
Szövegfejléc hozzáadása a PDF-hez a cURL paranccsal
A cURL parancsok kényelmes mechanizmust biztosítanak a REST API-k eléréséhez parancssori terminálokon keresztül. Mivel az Aspose.PDF Cloud is REST architektúra szerint készül, így az API-t cURL parancsokkal is elérhetjük. Ez a megközelítés hasznos lehet azoknak a fejlesztőknek, akik inkább parancssori eszközökkel dolgoznak, vagy akiknek integrálniuk kell a PDF-fejlécek szerkesztését egy nagyobb automatizálási munkafolyamatba.
Most a REST API használatához létre kell hoznunk egy JSON Web accessTokent (JWT) az ügyfél hitelesítő adatai alapján a következő parancs végrehajtásával.
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"
Ha megvan a JWT Token, kérjük, próbálja meg a következő paranccsal szöveget hozzáadni a dokumentum fejlécéhez az 1. és a 2. oldalon.
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}"
Képfejléc hozzáadása a PDF-hez a cURL paranccsal
Kérjük, próbálja meg a következő cURL paranccsal hozzáadni egy képfejlécet egy PDF-dokumentumhoz, és mentse a kapott fájlt felhőtárhelyre. A következő parancsban a kép fejléce a dokumentum 1. és 2. oldalához, ahol az átlátszatlanság 0,7, a nagyítási tényező 0,5, a kép magassága és szélessége pedig 120 pont.
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}"
Következtetés
Összefoglalva, egy kép és szöveg hozzáadása a PDF-dokumentum fejlécéhez hasznos funkció, amely javíthatja a dokumentumok vizuális vonzerejét és márkajelzését. Az Aspose.PDF Cloud SDK for Python segítségével ez egy egyszerű feladat néhány sornyi kóddal. Függetlenül attól, hogy számlákat, jelentéseket vagy bármilyen más olyan dokumentumot hoz létre, amelyhez fejléc szükséges, ez a funkció időt és erőfeszítést takaríthat meg, miközben javítja a kimenet minőségét. A Pythonhoz készült Aspose.PDF Cloud SDK használata mellett azt is megtudtuk, hogy a cURL-parancsok segítségével képeket és szöveget is lehet hozzáadni a PDF-fejlécekhez.
Reméljük, hogy ez a cikk minden szükséges útmutatást és ihletet adott ahhoz, hogy ezt a funkciót hozzáadhassa Python-alkalmazásához.
Hasznos linkek
Kapcsolódó cikkek
Javasoljuk, hogy olvassa el a következő cikkeket, hogy többet megtudjon: