כותרת תחתונה ב-PDF

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

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

Python Cloud SDK

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

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

pip install asposepdfcloud

השלב החשוב הבא הוא השגת אישורי לקוח מ-Cloud Dashboard. אם יש לך חשבון GitHub או Google, פשוט הירשם או לחץ על הלחצן צור חשבון חדש וספק את המידע הנדרש.

תעודות לקוח

תמונה 1:- אישורי לקוח ב-Aspose.Cloud Dashboard.

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

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

  • הצעד הראשון הוא ליצור מופע של מחלקה ApiClient אשר דורש Client ID Client Secret כארגומנטים.
  • שנית, צור מופע של מחלקה PdfApi אשר דורש אובייקט ApiClient כארגומנט קלט.
  • שלישית, צור אובייקט של TextFooter שבו קבענו את היישור האופקי כמרכז, אטימות כ-0.7, סיבוב זווית כ-356 וציינו את השוליים התחתונים כ-5.
  • על מנת להגדיר עיצוב טקסט עבור TextFooter, צור אובייקט של TextState שבו אנו מגדירים צבע קדמי, גודל גופן, שם גופן וכו'.
  • כעת עלינו להגדיר ערכים עבור שני פרמטרים אופציונליים המגדירים את עמוד ההתחלה והסיום של מסמך PDF כדי למקם את כותרת התחתונה של טקסט.
  • לבסוף, קרא לשיטה postdocumenttextfooter(..) כדי להוסיף Text Footer למסמך PDF ולשמור את הקובץ שנוצר באחסון בענן.
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)

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

        # קלט קובץ PDF
        input_file = 'marketing.pdf'

        # צור מופע TextFooter
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # הגדר יישור אופקי עבור כותרת תחתונה כמרכז
        textFooter.horizontal_alignment = 'Center'
        # הגדר את האטימות של כותרת תחתונה כ-0.7
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # הגדר את זווית הסיבוב כ-5 מעלות
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # ערך טקסטואלי שיוצג בקטע כותרת תחתונה
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # צור מופע של TextState המגדיר עיצוב של טקסט
        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)
        # הקצה אובייקט TextState ל-TextFooter
        textFooter.text_state = textState
        
        # דף התחלה של PDF עבור כותרת תחתונה
        startPage = 2
        # עמוד סיום של PDF עבור כותרת תחתונה
        endPage = 3

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

תמונה 2:- תצוגה מקדימה של TextFooter נוספה ל-PDF.

אנא בקר בקישור הבא כדי להוריד את הקלט marketing.pdf והתוצאה marketing-TextFooter.pdf.

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

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

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

        # הזנת מסמך PDF
        input_file = 'marketing.pdf'
        
        # צור מופע ImageFooter
        imageFooter = asposepdfcloud.ImageFooter()
        
        # עיבוד כותרת על גבי תוכן PDF
        imageFooter.background = False
        # הגדר את היישור כשמאל
        imageFooter.horizontal_alignment = 'Left'
        # הגדר את האטימות ל-70%
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # קובץ תמונה קלט
        imageFooter.file_name = 'Koala.jpg'
        # הגדר את פרטי רוחב וגובה התמונה
        imageFooter.width = 100
        imageFooter.height = 100
        # ציין פרטי שוליים עבור תמונת כותרת תחתונה
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # עמוד ההתחלה של המסמך כדי להוסיף כותרת תחתונה
        startPage = 1
        # עמוד ההתחלה של המסמך כדי להוסיף כותרת תחתונה
        endPage = 1

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

תמונה 3:- תצוגה מקדימה של הכותרת התחתונה של התמונה ב-PDF.

ניתן להוריד את הקובץ שנוצר על ידי הדוגמה לעיל מ-marketing-ImageFooter.pdf.

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

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

כעת, כדרישה מוקדמת, צור JSON Web Token (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, עלינו לבצע את הפקודה הבאה כדי להוסיף TextFooter לקובץ 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}"

אנא בצע את הפקודה הבאה כדי להוסיף את כותרת התמונה לקובץ ה-PDF באמצעות הפקודה 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}"

מַסְקָנָה

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

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

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

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