متن و تصویر را به هدر PDF اضافه کنید

وقتی صحبت از ایجاد اسناد PDF حرفه‌ای و جذاب می‌شود، داشتن قابلیت افزودن تصاویر و متن به هدر یکی از ویژگی‌های ضروری است. بخش سرصفحه یکی از مهم ترین بخش های یک سند است، زیرا اطلاعات ضروری مانند عنوان، نویسنده و تاریخ را در اختیار خوانندگان قرار می دهد. در حالی که افزودن متن به هدر فرآیندی نسبتاً ساده است، افزودن تصاویر می‌تواند چالش‌برانگیزتر باشد، به‌ویژه برای توسعه‌دهندگان پایتون که در تولید اسناد PDF جدید هستند. در این مقاله، نحوه افزودن تصویر و متن به هدر یک سند PDF با استفاده از Python Cloud SDK را بررسی خواهیم کرد.

می توانید تصاویر، آرم ها، تاریخ و زمان ایجاد سند، عنوان سند، شماره نسخه یا ویرایش، پیش نویس، نام نویسنده و نام فصل را در سربرگ PDF اضافه کنید.

REST API برای مجموعه اسناد PDF

Aspose.PDF Cloud SDK for Python توابع و روش‌های مختلفی را ارائه می‌کند که به توسعه‌دهندگان اجازه می‌دهد فایل‌های PDF را به صورت برنامه‌نویسی دستکاری کنند. همچنین مجموعه‌ای از ابزارهای قدرتمند و انعطاف‌پذیر برای افزودن تصاویر و متن به سرصفحه‌های سند PDF فراهم می‌کند و می‌تواند به راحتی در برنامه‌های پایتون برای پردازش خودکار اسناد PDF ادغام شود. اکنون در مورد فرآیند افزودن یک تصویر به هدر، شامل تعیین مکان و ابعاد تصویر و همچنین شماره صفحه ای است که تصویر باید در آن ظاهر شود. به همین ترتیب، افزودن متن به سربرگ نیازمند تعیین محتوای متن، اندازه فونت و سایر گزینه‌های قالب‌بندی است. SDK همچنین گزینه هایی را برای کنترل تراز و موقعیت محتوای هدر و همچنین برای تعیین رنگ پس زمینه هدر ارائه می دهد.

اکنون، ابتدا باید SDK را نصب کنیم که به صورت رایگان برای دانلود در مخزن PIP و GitHub در دسترس است. برای نصب آخرین نسخه SDK کافیست دستور زیر را اجرا کنید.

pip install asposepdfcloud

برای دسترسی به REST API، باید ثبت نام کرده و اعتبار شخصی خود را دریافت کنید. لطفاً برای اطلاعات مرتبط به راهنمای شروع سریع نگاهی بیندازید.

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

SDK شما را قادر می سازد رشته های متنی را به قسمت سرصفحه سند اضافه کنید و این نیاز را می توان با استفاده از مراحل زیر انجام داد.

  • ابتدا یک نمونه از کلاس ApiClient ایجاد کنید و در عین حال Client ID Client Secret را به عنوان آرگومان ارائه دهید.
  • در مرحله دوم، یک شی از کلاس PdfApi ایجاد کنید که شی ApiClient را به عنوان آرگومان ورودی دریافت کند.
  • سوم، یک شی از TextHeader ایجاد کنید که خصوصیات نمونه TextHeader را تعریف می کند.
  • به منظور تنظیم قالب بندی متن برای TextHeader، یک شی از TextState ایجاد کنید که در آن رنگ پیش زمینه، اندازه فونت، نام فونت و غیره را تعریف می کنیم.
  • در نهایت، روش postdocumenttextheader(..) را فراخوانی کنید تا Text Header را به سند PDF اضافه کنید و فایل حاصل را در فضای ذخیره سازی Cloud ذخیره کنید.
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)

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

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # یک شیء تعریف کننده Text Header ایجاد کنید
        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

        # برای افزودن Text Header به سند PDF با API تماس بگیرید
        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 با استفاده از پایتون

لطفاً دستورالعمل‌های زیر را دنبال کنید تا یک شیء Image به بخش هدر PDF اضافه کنید. فایل حاصل در فضای ذخیره سازی ابری آپلود می شود.

  • اول از همه، یک نمونه از کلاس ApiClient ایجاد کنید و در عین حال Client ID Client Secret را به عنوان آرگومان ارائه دهید.
  • در مرحله دوم، یک شی از کلاس PdfApi ایجاد کنید که شی ApiClient را به عنوان آرگومان ورودی دریافت کند.
  • اکنون یک شی از ImageHeader ایجاد کنید که ویژگی های ImageHeader را تعریف می کند.
  • به منظور کنترل رندر هدر در صفحات خاص، مقادیری به پارامترهای اختیاری startpagenumber و endpagenumber اختصاص داده می شود.
  • در نهایت، روش postdocumentimageheader(..) را فراخوانی کنید تا Image Header را به سند PDF اضافه کنید و فایل حاصل را در فضای ذخیره سازی Cloud ذخیره کنید. توجه داشته باشید که هدر فقط به دو صفحه اول سند اضافه می شود (همانطور که در کد مشخص شده است).
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)

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

        #source PDF file
        input_file = 'awesomeTable.pdf'
        
        # ایجاد نمونه ImageHeader
        imageHeader = asposepdfcloud.ImageHeader()
        # ویژگی پس زمینه را درست تنظیم کنید
        imageHeader.background = True
        # تراز افقی را به صورت Right تنظیم کنید
        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

        # برای افزودن هدر تصویر به سند PDF و ذخیره فایل حاصل در فضای ذخیره سازی ابری، با API تماس بگیرید
        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 مکانیزم مناسبی برای دسترسی به API های REST از طریق پایانه های خط فرمان فراهم می کند. از آنجایی که Aspose.PDF Cloud نیز بر اساس معماری REST توسعه یافته است، بنابراین می توانیم با استفاده از دستورات cURL به API نیز دسترسی داشته باشیم. این رویکرد می‌تواند برای توسعه‌دهندگانی که ترجیح می‌دهند با ابزارهای خط فرمان کار کنند یا افرادی که باید ویرایش سرصفحه 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 را دریافت کردیم، لطفاً از دستور زیر برای اضافه کردن متن در قسمت سرصفحه سند در صفحات 1 و 2 استفاده کنید.

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 زیر استفاده کنید تا یک Image Header به یک سند 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 برای پایتون، انجام آن تنها با چند خط کد کار ساده ای است. چه در حال ایجاد فاکتور، گزارش یا هر سند دیگری باشید که نیاز به هدر دارد، این ویژگی می تواند در زمان و تلاش شما صرفه جویی کند و در عین حال کیفیت خروجی شما را بهبود بخشد. علاوه بر استفاده از Aspose.PDF Cloud SDK برای پایتون، همچنین آموخته ایم که می توان تصاویر و متن را با استفاده از دستورات cURL به هدرهای PDF اضافه کرد.

امیدواریم که این مقاله تمام راهنمایی ها و الهامات لازم را برای افزودن این قابلیت به برنامه پایتون خود ارائه کرده باشد.

لینک های مفید

مقالات مرتبط

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