التذييل في PDF

يمكن أن يكون إضافة الصور والنصوص إلى قسم تذييل PDF مفيدًا في سيناريوهات مختلفة، مثل إضافة معلومات العلامة التجارية أو القانونية إلى المستندات. في العديد من الصناعات، يعد إضافة شعار الشركة أو إخلاء المسؤولية في أسفل كل صفحة من المستند متطلبًا شائعًا. في حالات أخرى، قد تكون هناك حاجة لإضافة أرقام الصفحات أو بيانات وصفية أخرى للمساعدة في تنظيم المستند أو تحديده. بغض النظر عن حالة الاستخدام المحددة، فإن القدرة على إضافة الصور والنصوص إلى قسم تذييل مستند PDF هي ميزة مهمة للعديد من الشركات والمؤسسات. في هذه المقالة، سوف نستكشف كيفية إضافة الصور والنصوص إلى قسم تذييل مستند PDF باستخدام Python Cloud SDK.

هناك مصطلح آخر يستخدم للتذييل وهو “القدم الجارية”. وهو مستخدم على نطاق واسع في صناعة النشر ويسمى كذلك لأنه يحتوي على نسخة مختصرة من المقالة أو معلومات أخرى عنها.

مجموعة أدوات تطوير البرامج السحابية Python

توفر Aspose.PDF Cloud SDK for Python مجموعة من الميزات القوية للعمل مع مستندات PDF، بما في ذلك القدرة على إضافة صورة ونص إلى قسم التذييل في مستند PDF. توفر مجموعة SDK هذه واجهة بسيطة وبديهية تجعل من السهل تنفيذ مهام مختلفة متعلقة بـ PDF برمجيًا. باستخدام مجموعة SDK هذه، يمكنك إضافة نص أو صور مخصصة بسرعة وسهولة إلى تذييل أي مستند PDF، مما يوفر مظهرًا احترافيًا ومخصصًا لمستنداتك.

تتوفر مجموعة أدوات التطوير البرمجية للتنزيل عبر مستودع PIP وGitHub. ومع ذلك، يمكنك ببساطة تنفيذ الأمر التالي على المحطة الطرفية/موجه الأوامر لتثبيت أحدث إصدار من مجموعة أدوات التطوير البرمجية على النظام.

pip install asposepdfcloud

الخطوة المهمة التالية هي الحصول على بيانات اعتماد العميل من لوحة معلومات السحابة. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل أو النقر فوق الزر إنشاء حساب جديد وتقديم المعلومات المطلوبة.

بيانات اعتماد العميل

الصورة 1:- بيانات اعتماد العميل على لوحة معلومات Aspose.Cloud.

إضافة تذييل النص في PDF باستخدام Python

يرجى اتباع الخطوات الموضحة أدناه لإضافة تذييل النص في مستند PDF باستخدام مقتطف كود Python.

  • الخطوة الأولى هي إنشاء مثيل لفئة ApiClient والتي تتطلب معرف العميل وسر العميل كوسائط.
  • ثانيًا، قم بإنشاء مثيل لفئة PdfApi والتي تتطلب كائن ApiClient كحجة إدخال.
  • ثالثًا، قم بإنشاء كائن TextFooter حيث قمنا بتعيين المحاذاة الأفقية إلى Center، والعتامة إلى 0.7، وزاوية التدوير إلى 356 وحددنا الهامش السفلي إلى 5.
  • لتعيين تنسيق النص لـ TextFooter، قم بإنشاء كائن TextState حيث نقوم بتحديد لون المقدمة وحجم الخط واسم الخط وما إلى ذلك.
  • الآن نحتاج إلى تعيين قيم لمعلمتين اختياريتين تحددان صفحة البداية والنهاية لمستند PDF لوضع نص التذييل.
  • أخيرًا، اتصل بطريقة postdocumenttextfooter(..) لإضافة نص تذييل إلى مستند 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

        # اتصل بواجهة برمجة التطبيقات لإضافة نص التذييل في ملف 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.

توفر واجهة برمجة التطبيقات أيضًا إمكانية إضافة تذييل صورة إلى ملف PDF. يُرجى اتباع الإرشادات الواردة أدناه لإنجاز هذا المطلب.

  • الخطوة الأولى هي إنشاء مثيل لفئة ApiClient والتي تتطلب معرف العميل وسر العميل كوسائط.
  • ثانيًا، قم بإنشاء مثيل لفئة 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

        # استدعاء واجهة برمجة التطبيقات لعرض تذييل الصورة في ملف 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 (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 for Python طريقة ملائمة وقوية لتطبيق هذه الميزة في تطبيق Python الخاص بك. من ناحية أخرى، يمكن أن يوفر استخدام أوامر cURL مع واجهة برمجة تطبيقات Aspose.PDF Cloud المرونة والبساطة لدمج الميزة في لغات البرمجة والبيئات المختلفة. بغض النظر عن النهج الذي تختاره، توفر Aspose.PDF Cloud أدوات قوية وموثوقة لإضافة الصور والنصوص إلى قسم التذييل في مستندات PDF الخاصة بك.

روابط مفيدة

مقالات ذات صلة

ننصحك بزيارة المقالات التالية للتعرف على: