Wenn Sie professionelle und optisch ansprechende PDF Dokumente erstellen möchten, ist die Möglichkeit, Bilder und Text zur Kopfzeile hinzuzufügen, ein unverzichtbares Feature. Der Kopfbereich ist einer der wichtigsten Bereiche eines Dokuments, da er den Lesern wichtige Informationen wie Titel, Autor und Datum liefert. Während das Hinzufügen von Text zur Kopfzeile relativ unkompliziert ist, kann das Hinzufügen von Bildern eine größere Herausforderung darstellen, insbesondere für Python-Entwickler, die neu in der PDF Dokumenterstellung sind. In diesem Artikel erfahren Sie, wie Sie mit Python Cloud SDK Bilder und Text zur Kopfzeile eines PDF Dokuments hinzufügen.
Sie können Bilder, Logos, das Datum und die Uhrzeit der Dokumenterstellung, den Titel des Dokuments, die Versions oder Revisionsnummer, den Entwurf, den Autorennamen und Kapitelnamen in die PDF-Kopfzeile einfügen.
- REST-API für die Zusammenstellung von PDF Dokumenten
- Mit Python Text zum PDF-Header hinzufügen
- Mit Python ein Bild zum PDF-Header hinzufügen
- Hinzufügen einer Textüberschrift zu einer PDF mit dem cURL-Befehl
- Hinzufügen eines Bildkopfs zu einer PDF mit dem cURL-Befehl
REST-API für die Zusammenstellung von PDF Dokumenten
Aspose.PDF Cloud SDK für Python bietet eine Vielzahl von Funktionen und Methoden, mit denen Entwickler PDF Dateien programmgesteuert bearbeiten können. Es bietet außerdem einen leistungsstarken und flexiblen Satz von Tools zum Hinzufügen von Bildern und Text zu PDF Dokumentkopfzeilen und kann problemlos in Python-Anwendungen zur automatisierten PDF Dokumentverarbeitung integriert werden. Beim Hinzufügen eines Bilds zur Kopfzeile müssen nun die Position und Abmessungen des Bilds sowie die Seitenzahl angegeben werden, auf der das Bild erscheinen soll. Ebenso müssen beim Hinzufügen von Text zur Kopfzeile der Textinhalt, die Schriftgröße und andere Formatierungsoptionen angegeben werden. Das SDK bietet auch Optionen zum Steuern der Ausrichtung und Positionierung des Kopfzeileninhalts sowie zum Festlegen der Hintergrundfarbe der Kopfzeile.
Nun müssen wir zunächst das SDK installieren, das kostenlos im PIP und GitHub-Repository zum Download bereitsteht. Führen Sie einfach den folgenden Befehl aus, um die neueste Version des SDK zu installieren.
pip install asposepdfcloud
Um auf die REST-API zugreifen zu können, müssen Sie sich registrieren und Ihre persönlichen Anmeldeinformationen erhalten. Weitere Informationen finden Sie in der Kurzanleitung.
Mit Python Text zum PDF-Header hinzufügen
Mit dem SDK können Sie dem Kopfbereich des Dokuments Textzeichenfolgen hinzufügen. Diese Anforderung kann mit den folgenden Schritten erfüllt werden.
- Erstellen Sie zunächst eine Instanz der Klasse ApiClient und geben Sie als Argumente die Client-ID und das Client-Geheimnis an.
- Zweitens erstellen Sie ein Objekt der PdfApi Klasse, das das ApiClient Objekt als Eingabeargument verwendet.
- Drittens: Erstellen Sie ein TextHeader Objekt, das die Eigenschaften der TextHeader-Instanz definiert.
- Um die Textformatierung für TextHeader festzulegen, erstellen Sie ein TextState Objekt, in dem wir Vordergrundfarbe, Schriftgröße, Schriftnamen usw. definieren.
- Rufen Sie abschließend die Methode postdocumenttextheader(..) auf, um dem PDF Dokument eine Textüberschrift hinzuzufügen und die resultierende Datei im Cloud-Speicher zu speichern.
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)
# Erstellen Sie eine PdfApi-Instanz und übergeben Sie dabei PdfApiClient als Argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# Erstellen Sie ein Objekt, das den Textheader definiert
textHeader = asposepdfcloud.TextHeader()
# Legen Sie den Wert fest, um den Header im Hintergrund darzustellen
textHeader.background = False
# Legen Sie die horizontale Ausrichtung für die Textüberschrift als Mitte fest
textHeader.horizontal_alignment = 'Center'
# Stellen Sie die Deckkraft der Kopfzeile auf 0,5 ein.
textHeader.opacity = 0.5
# kein Drehwinkel
textHeader.rotate = None
textHeader.rotate_angle = 0
# X und Y-Einrückungswert festlegen
textHeader.x_indent = 100
textHeader.y_indent = 100
# Stellen Sie den Zoomfaktor auf 1,0 ein
textHeader.zoom = 1.0
# der Textwert, der in der Kopfzeile dargestellt werden soll
textHeader.value = 'Aspose.PDF Cloud'
# Erstellen Sie eine Instanz von TextState, die die Formatierung des Textes definiert
textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
{"A": 0,
"R": 252,
"G": 173,
"B": 3},font_style=2)
# Übergeben Sie das TextState Objekt an den TextHeader.
textHeader.text_state = textState
# Rufen Sie die API auf, um Textkopfzeilen zum PDF Dokument hinzuzufügen
response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
# Antwortcode in der Konsole drucken
print(response)
# Nachricht in der Konsole drucken (optional)
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)
Bild 2: Vorschau der Textkopfzeile im PDF Dokument.
Die Eingabe und Ergebnis-PDF Dateien können von awesomeTable.pdf und awecomeTable-TextHeader.pdf heruntergeladen werden.
Mit Python ein Bild zum PDF-Header hinzufügen
Befolgen Sie die nachstehenden Anweisungen, um dem PDF-Headerabschnitt ein Bildobjekt hinzuzufügen. Die resultierende Datei wird in den Cloud-Speicher hochgeladen.
- Erstellen Sie zunächst eine Instanz der Klasse ApiClient und geben Sie als Argumente die Client-ID und das Client-Geheimnis an.
- Zweitens erstellen Sie ein Objekt der PdfApi Klasse, das das ApiClient Objekt als Eingabeargument verwendet.
- Erstellen Sie nun ein ImageHeader Objekt, das die Eigenschaften des ImageHeaders definiert.
- Um die Darstellung der Kopfzeile auf bestimmten Seiten zu steuern, werden den optionalen Parametern startpagenumber und endpagenumber Werte zugewiesen.
- Rufen Sie abschließend die Methode postdocumentimageheader(..) auf, um dem PDF Dokument eine Bildkopfzeile hinzuzufügen und die resultierende Datei im Cloud-Speicher zu speichern. Beachten Sie, dass die Kopfzeile nur den ersten beiden Seiten des Dokuments hinzugefügt wird (wie im Code angegeben).
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)
# Erstellen Sie eine PdfApi-Instanz und übergeben Sie dabei PdfApiClient als Argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'awesomeTable.pdf'
# ImageHeader-Instanz erstellen
imageHeader = asposepdfcloud.ImageHeader()
# Setzen Sie die Hintergrundeigenschaft auf „true“.
imageHeader.background = True
# Horizontale Ausrichtung auf Rechts setzen
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
# Name der im Cloud-Speicher verfügbaren Bilddatei, die im Header hinzugefügt werden soll
imageHeader.file_name = 'Koala.jpg'
# Breite des Bildes im Header
imageHeader.width = 120
# Höhe des Bildes im Header
imageHeader.height = 120
imageHeader.left_margin = 0
imageHeader.top_margin = 10
imageHeader.right_margin = 10
# Startseite des Dokuments, um Kopfzeile hinzuzufügen
startPage = 1
# letzte Seite des Dokuments, um eine Kopfzeile hinzuzufügen
endPage = 2
# Rufen Sie die API auf, um dem PDF Dokument einen Bildkopf hinzuzufügen und die resultierende Datei im Cloud-Speicher zu speichern
response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
# Antwortcode in der Konsole drucken
print(response)
# Nachricht in der Konsole drucken (optional)
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.
Die Quelldateien und die im obigen Beispiel generierte Ergebnisdatei können heruntergeladen werden von
Hinzufügen einer Textüberschrift zu einer PDF mit dem cURL-Befehl
Die cURL-Befehle bieten einen praktischen Mechanismus für den Zugriff auf REST-APIs über Befehlszeilenterminals. Da Aspose.PDF Cloud auch gemäß der REST-Architektur entwickelt wurde, können wir auch mit cURL-Befehlen auf die API zugreifen. Dieser Ansatz kann für Entwickler nützlich sein, die lieber mit Befehlszeilentools arbeiten oder die Bearbeitung von PDF-Headern in einen größeren Automatisierungsworkflow integrieren müssen.
Um nun die REST-API verwenden zu können, müssen wir durch Ausführen des folgenden Befehls ein JSON Web AccessToken (JWT) basierend auf Ihren Client-Anmeldeinformationen generieren.
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"
Sobald wir das JWT-Token haben, versuchen Sie bitte, mit dem folgenden Befehl Text im Kopfbereich des Dokuments auf der 1. und 2. Seite hinzuzufügen.
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}"
Hinzufügen eines Bildkopfs zu einer PDF mit dem cURL-Befehl
Versuchen Sie, mit dem folgenden cURL-Befehl einem PDF Dokument einen Bildkopf hinzuzufügen und die resultierende Datei im Cloud-Speicher zu speichern. Im folgenden Befehl wird der Bildkopf auf der 1. und 2. Seite des Dokuments eingefügt, wobei die Deckkraft auf 0,7, der Zoomfaktor auf 0,5 und die Bildhöhen und -breiteneigenschaften auf 120 Punkte festgelegt sind.
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}"
Abschluss
Zusammenfassend lässt sich sagen, dass das Hinzufügen eines Bilds und Textes zur Kopfzeile eines PDF Dokuments eine nützliche Funktion ist, die die visuelle Attraktivität und das Branding Ihrer Dokumente verbessern kann. Mit dem Aspose.PDF Cloud SDK für Python ist dies eine einfache Aufgabe, die mit nur wenigen Codezeilen erledigt werden kann. Egal, ob Sie Rechnungen, Berichte oder ein anderes Dokument erstellen, das eine Kopfzeile erfordert, diese Funktion kann Ihnen Zeit und Mühe sparen und gleichzeitig die Qualität Ihrer Ausgabe verbessern. Neben der Verwendung des Aspose.PDF Cloud SDK für Python haben wir auch gelernt, dass es auch möglich ist, mit cURL-Befehlen Bilder und Text zu PDF-Kopfzeilen hinzuzufügen.
Wir hoffen, dass dieser Artikel Ihnen alle notwendigen Hinweise und Anregungen gegeben hat, um diese Funktionalität zu Ihrer Python-Anwendung hinzuzufügen.
Nützliche Links
Verwandte Artikel
Wir empfehlen Ihnen, die folgenden Artikel zu lesen, um mehr über Folgendes zu erfahren: