پاورقی به صورت 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

گام مهم بعدی دریافت اعتبار مشتری از داشبورد ابری است. اگر حساب GitHub یا Google دارید، به سادگی ثبت نام کنید یا روی دکمه ایجاد یک حساب جدید کلیک کنید و اطلاعات مورد نیاز را ارائه دهید.

اعتبار مشتری

تصویر 1: - اعتبار مشتری در Aspose.Cloud Dashboard.

اضافه کردن پاورقی متن در PDF با استفاده از پایتون

لطفاً مراحل زیر را برای افزودن پاورقی متن در سند PDF با استفاده از قطعه کد پایتون دنبال کنید.

  • اولین گام این است که یک نمونه از کلاس ApiClient ایجاد کنید که به Client ID Client Secret به عنوان آرگومان نیاز دارد.
  • در مرحله دوم، یک نمونه از کلاس PdfApi ایجاد کنید که به شیء ApiClient به عنوان آرگومان ورودی نیاز دارد.
  • سوم، یک شی از TextFooter ایجاد کنید که در آن تراز افقی را به عنوان مرکز، Opacity را 0.7، زاویه چرخش را 356 و حاشیه پایین را 5 تعیین کرده ایم.
  • به منظور تنظیم قالب بندی متن برای TextFooter، یک شی از TextState ایجاد کنید که در آن رنگ پیش زمینه، اندازه فونت، نام فونت و غیره را تعریف می کنیم.
  • اکنون باید مقادیری را برای دو پارامتر اختیاری تعیین کنیم که صفحه شروع و پایان سند PDF را برای قرار دادن Text Footer تعیین می کنند.
  • در نهایت، روش postdocumenttextfooter(..) را فراخوانی کنید تا Text Footer را به سند PDF اضافه کنید و فایل حاصل را در فضای ذخیره سازی Cloud ذخیره کنید.
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)

        # هنگام ارسال PdfApiClient به عنوان آرگومان، نمونه PdfApi ایجاد کنید
        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 در صفحه دوم و سوم، با API تماس بگیرید
        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 ایجاد کنید که در آن تراز افقی را به عنوان مرکز، Opacity را 0.7، زاویه چرخش را 10، نام فایل تصویر، جزئیات حاشیه و سایر ویژگی ها را مشخص کرده ایم.
  • از آنجایی که ما فقط باید Footer را به صفحه اول سند اضافه کنیم، بنابراین مقادیری را برای پارامترهای اختیاری startpagenumber و endpagenumber تنظیم کرده ایم.
  • در نهایت، روش postdocumentimagefooter(..) را فراخوانی کنید تا Text Footer را به سند PDF اضافه کنید و فایل حاصل را در فضای ذخیره سازی Cloud ذخیره کنید.
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)

        # هنگام ارسال PdfApiClient به عنوان آرگومان، نمونه PdfApi ایجاد کنید
        pdf_api = PdfApi(pdf_api_client)

        # سند PDF را وارد کنید
        input_file = 'marketing.pdf'
        
        # ایجاد نمونه ImageFooter
        imageFooter = asposepdfcloud.ImageFooter()
        
        # هدر را در بالای محتوای PDF ارائه دهید
        imageFooter.background = False
        # تراز را به صورت چپ تنظیم کنید
        imageFooter.horizontal_alignment = 'Left'
        # Opacity را 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 با API تماس بگیرید
        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 برای پایتون یک راه راحت و قدرتمند برای پیاده سازی این ویژگی در برنامه پایتون شما ارائه می دهد. از سوی دیگر، استفاده از دستورات cURL با Aspose.PDF Cloud API می‌تواند انعطاف‌پذیری و سادگی را برای ادغام این ویژگی در زبان‌ها و محیط‌های برنامه‌نویسی مختلف ارائه دهد. صرف نظر از رویکردی که انتخاب می کنید، Aspose.PDF Cloud ابزارهای قوی و قابل اعتمادی را برای افزودن تصویر و متن به بخش پاورقی اسناد PDF شما ارائه می دهد.

لینک های مفید

مقالات مرتبط

توصیه می کنیم برای کسب اطلاعات بیشتر از مقالات زیر دیدن کنید: