הוסף טקסט ותמונה לכותרת PDF

כשמדובר ביצירת מסמכי PDF מקצועיים ומושכים מבחינה ויזואלית, היכולת להוסיף תמונות וטקסט לכותרת היא תכונה חובה. קטע הכותרת הוא אחד התחומים החשובים ביותר במסמך, מכיוון שהוא מספק לקוראים מידע חיוני כגון הכותרת, המחבר והתאריך. למרות שהוספת טקסט לכותרת היא תהליך פשוט יחסית, הוספת תמונות יכולה להיות מאתגרת יותר, במיוחד עבור מפתחי Python שחדשים ביצירת מסמכי PDF. במאמר זה, נחקור כיצד להוסיף תמונה וטקסט לכותרת של מסמך PDF באמצעות Python Cloud SDK.

אתה יכול להוסיף תמונות, סמלי לוגו, התאריך והשעה שיצרת את המסמך, כותרת המסמך, מספר גרסה או גרסה, טיוטה, שם מחבר ושמות פרקים בכותרת PDF.

REST API עבור הרכבת מסמכי PDF

Aspose.PDF Cloud SDK עבור Python מספק מגוון פונקציות ושיטות המאפשרות למפתחים לתפעל קבצי PDF באופן פרוגרמטי. הוא גם מספק קבוצה חזקה וגמישה של כלים להוספת תמונות וטקסט לכותרות של מסמכי PDF, וניתן לשלב אותו בקלות ביישומי Python לעיבוד אוטומטי של מסמכי PDF. כעת בנוגע לתהליך הוספת תמונה לכותרת, הוא כרוך בציון מיקום ומידות התמונה, וכן את מספר העמוד עליו אמורה התמונה להופיע. באופן דומה, הוספת טקסט לכותרת מחייבת לציין את תוכן הטקסט, גודל הגופן ואפשרויות עיצוב אחרות. ה-SDK מספק גם אפשרויות לשליטה ביישור ובמיקום של תוכן הכותרת, כמו גם לציון צבע הרקע של הכותרת.

כעת, ראשית עלינו להתקין את ה-SDK אשר זמין להורדה בחינם מעל מאגר PIP ו-GitHub. כל שעליך לעשות הוא לבצע את הפקודה הבאה כדי להתקין את הגרסה האחרונה של ה-SDK.

pip install asposepdfcloud

כדי לגשת ל- REST API, עליך להירשם ולקבל את האישורים האישיים שלך. אנא עיין במדריך התחלה מהירה לקבלת מידע קשור.

הוסף טקסט לכותרת PDF באמצעות Python

ה-SDK מאפשר לך להוסיף מחרוזות טקסט למקטע הכותרת של המסמך וניתן להשיג דרישה זו באמצעות השלבים הבאים.

  • ראשית, צור מופע של מחלקה ApiClient תוך מתן סוד לקוח לקוח כארגומנטים.
  • שנית, צור אובייקט של מחלקה PdfApi אשר לוקח את אובייקט ApiClient כארגומנט קלט.
  • שלישית, צור אובייקט של TextHeader המגדיר מאפיינים של מופע TextHeader.
  • על מנת להגדיר עיצוב טקסט עבור TextHeader, צור אובייקט של TextState שבו אנו מגדירים צבע קדמי, גודל גופן, שם גופן וכו'.
  • לבסוף, קרא לשיטה postdocumenttextheader(..) כדי להוסיף כותרת טקסט למסמך PDF ולשמור את הקובץ שנוצר באחסון בענן.
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)

        # צור מופע PdfApi תוך העברת PdfApiClient כארגומנט
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # צור אובייקט המגדיר כותרת טקסט
        textHeader = asposepdfcloud.TextHeader()
        # הגדר את הערך לעיבוד כותרת ברקע
        textHeader.background = False
        # הגדר את היישור האופקי עבור כותרת הטקסט כמרכז
        textHeader.horizontal_alignment = 'Center'
        # הגדר את האטימות של הכותרת כ-0.5
        textHeader.opacity = 0.5
        # אין זווית סיבוב
        textHeader.rotate = None
        textHeader.rotate_angle = 0
        # הגדר ערך כניסות X ו-Y
        textHeader.x_indent = 100
        textHeader.y_indent = 100
        # הגדר את מקדם הזום כ-1.0
        textHeader.zoom = 1.0
        # ערך הטקסט שיוצג בתוך הכותרת
        textHeader.value = 'Aspose.PDF Cloud'

        # צור מופע של TextState המגדיר עיצוב של טקסט
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 252,
              "G": 173,
              "B": 3},font_style=2)
        # להעביר אובייקט TextState ל-TextHeader
        textHeader.text_state = textState

        # התקשר ל-API כדי להוסיף כותרת טקסט למסמך PDF
        response = pdf_api.post_document_text_header(name = input_file, text_header = textHeader)
        
        # הדפס קוד תגובה במסוף
        print(response)
        # הדפס הודעה במסוף (אופציונלי)
        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)
כותרת טקסט ב-PDF

תמונה 2:- תצוגה מקדימה של כותרת טקסט במסמך PDF.

ניתן להוריד את קבצי הקלט וה-PDF שנוצרו מ-awesomeTable.pdf ו-awecomeTable-TextHeader.pdf.

הוסף תמונה לכותרת PDF באמצעות Python

אנא עקוב אחר ההוראות שלהלן כדי להוסיף אובייקט תמונה למקטע כותרות PDF. הקובץ שנוצר עולה לאחסון בענן.

  • קודם כל, צור מופע של מחלקה ApiClient תוך מתן Client ID Client Secret כארגומנטים.
  • שנית, צור אובייקט של מחלקה PdfApi אשר לוקח את אובייקט ApiClient כארגומנט קלט.
  • כעת צור אובייקט של ImageHeader המגדיר את המאפיינים של ImageHeader.
  • על מנת לשלוט בעיבוד הכותרת בדפים מסוימים, ערכים מוקצים לפרמטרים אופציונליים startpagenumber ו-endpagenumber.
  • לבסוף, קרא לשיטה postdocumentimageheader(..) כדי להוסיף כותרת תמונה למסמך PDF ולשמור את הקובץ שנוצר באחסון בענן. שימו לב שהכותרת מתווספת רק לשני העמודים הראשונים של המסמך (כפי שצוין בקוד).
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)

        # צור מופע PdfApi תוך העברת PdfApiClient כארגומנט
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # ליצור מופע ImageHeader
        imageHeader = asposepdfcloud.ImageHeader()
        # הגדר את מאפיין הרקע כ-true
        imageHeader.background = True
        # הגדר יישור אופקי כימין
        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
        # שם קובץ התמונה הזמין באחסון בענן להוספת בכותרת
        imageHeader.file_name = 'Koala.jpg'
        # רוחב התמונה בכותרת
        imageHeader.width = 120
        # גובה התמונה בכותרת
        imageHeader.height = 120
        imageHeader.left_margin = 0
        imageHeader.top_margin = 10
        imageHeader.right_margin = 10
        
        # עמוד ההתחלה של המסמך להוספת כותרת עליונה
        startPage = 1
        # עמוד סיום של המסמך כדי להוסיף כותרת עליונה
        endPage = 2

        # התקשר ל-API כדי להוסיף כותרת תמונה במסמך PDF ולשמור את הקובץ שנוצר באחסון בענן
        response = pdf_api.post_document_image_header(name = input_file, image_header = imageHeader, start_page_number = startPage, end_page_number=endPage)
        
        # קוד תגובה של pritn בקונסולה
        print(response)
        
        # הדפס הודעה במסוף (אופציונלי)
        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.

ניתן להוריד את קובצי המקור והקובץ שנוצר בדוגמה שלעיל

הוספת כותרת טקסט ל-PDF באמצעות פקודת cURL

פקודות cURL מספקות מנגנון נוח לגישה לממשקי REST API דרך מסופי שורת הפקודה. מכיוון שגם Aspose.PDF Cloud פותח לפי ארכיטקטורת REST, אז נוכל לגשת ל-API גם באמצעות פקודות cURL. גישה זו יכולה להיות שימושית עבור מפתחים המעדיפים לעבוד עם כלים בשורת הפקודה או שצריכים לשלב עריכת כותרות PDF בזרימת עבודה גדולה יותר של אוטומציה.

כעת על מנת להשתמש ב- REST API, עלינו ליצור JSON Web accessToken (JWT) המבוסס על אישור הלקוח שלך על ידי ביצוע הפקודה הבאה.

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"

ברגע שיש לנו את אסימון JWT, אנא נסה להשתמש בפקודה הבאה כדי להוסיף טקסט בחלק הכותרות של המסמך בעמוד הראשון והשני.

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}"

הוספת כותרת תמונה ל-PDF באמצעות פקודת cURL

נסה להשתמש בפקודה cURL הבאה כדי להוסיף כותרת תמונה למסמך PDF ולשמור את הקובץ שנוצר באחסון ענן. בפקודה הבאה, כותרת התמונה לעמוד הראשון והשני של המסמך, כאשר האטימות מוגדרת כ-0.7, מקדם זום הוא 0.5, ומאפייני הגובה והרוחב של התמונה מוגדרים כ-120 נקודות.

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}"

מַסְקָנָה

לסיכום, הוספת תמונה וטקסט לכותרת של מסמך PDF היא תכונה שימושית שיכולה לשפר את המשיכה החזותית והמיתוג של המסמכים שלך. עם Aspose.PDF Cloud SDK עבור Python, זוהי משימה פשוטה לביצוע עם מספר שורות קוד בלבד. בין אם אתה יוצר חשבוניות, דוחות או כל מסמך אחר הדורש כותרת עליונה, תכונה זו יכולה לחסוך לך זמן ומאמץ תוך שיפור איכות הפלט שלך. בנוסף לשימוש ב-Aspose.PDF Cloud SDK עבור Python, למדנו גם שאפשר להוסיף תמונות וטקסט לכותרות PDF באמצעות פקודות cURL.

אנו מקווים שמאמר זה סיפק לך את כל ההדרכה וההשראה הדרושים כדי להוסיף פונקציונליות זו ליישום Python שלך.

קישורים שימושיים

מאמרים קשורים

אנו ממליצים לבקר במאמרים הבאים כדי ללמוד על: