HTML را با استفاده از REST API در پایتون به PDF تبدیل کنید

به عنوان یک توسعه دهنده پایتون، می توانید به راحتی فایل های HTML خود را به صورت برنامه نویسی در فضای ابری به اسناد PDF تبدیل کنید. چنین تبدیلی می تواند در نگهداری سوابق یا به اشتراک گذاری فایل های HTML به شکل قابل حمل مفید باشد. در این مقاله با نحوه تبدیل اسناد HTML به PDF با استفاده از REST API در پایتون آشنا خواهید شد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

تبدیل HTML به PDF REST API و Python SDK

برای تبدیل فایل‌های HTML به PDF، از Python SDK of GroupDocs.Conversion Cloud API استفاده خواهم کرد. این به شما امکان می دهد اسناد و تصاویر خود را از هر فرمت فایل پشتیبانی شده به هر فرمتی که نیاز دارید تبدیل کنید. شما به راحتی می توانید بین بیش از 50 نوع سند و تصویر مانند Word، PowerPoint، Excel، PDF، HTML، CAD، تصاویر شطرنجی و غیره تبدیل کنید.

می توانید با استفاده از دستور زیر در کنسول، GroupDocs.Conversion Cloud را در پروژه پایتون خود نصب کنید:

pip install groupdocs_conversion_cloud

لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، لطفاً کد را مطابق شکل زیر اضافه کنید:

client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

HTML را با استفاده از REST API در پایتون به PDF تبدیل کنید

با دنبال کردن مراحل ساده زیر می توانید فایل HTML خود را به اسناد PDF تبدیل کنید:

سند را آپلود کنید

ابتدا فایل HTML را با استفاده از نمونه کد زیر در فضای ابری آپلود کنید:

# ایجاد نمونه ای از API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# درخواست آپلود فایل
request = groupdocs_conversion_cloud.UploadFileRequest("sample.html", "C:\\Files\\sample.html", my_storage)

# فایل نمونه را آپلود کنید
response = file_api.upload_file(request)

در نتیجه، فایل HTML آپلود شده در بخش فایل ها داشبورد شما در فضای ابری در دسترس خواهد بود.

تبدیل HTML به PDF در پایتون

با دنبال کردن مراحل زیر می توانید به راحتی اسناد HTML را به PDF تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل HTML را تنظیم کنید
  • “pdf” را به قالب اختصاص دهید
  • مسیر فایل خروجی را ارائه دهید
  • در صورت نیاز PdfConvertOptions را تعریف کنید
  • به صورت اختیاری ویژگی های مختلفی مانند dpi، margin\top، margin\left، fit\window و غیره را تنظیم کنید.
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد convert\document() با ConvertDocumentRequest نتیجه بگیرید

مثال کد زیر نحوه تبدیل فایل HTML خود را به سند PDF با استفاده از REST API نشان می دهد.

# نمونه های API لازم را ایجاد کنید
تبدیل_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "تبدیلed"

# گزینه های تبدیل PDF
تبدیلOptions = groupdocs_conversion_cloud.PdfConvertOptions()
تبدیلOptions.center_window = True     # Set position of the document's window on the screen
تبدیلOptions.display_doc_title = True
تبدیلOptions.dpi = 1024.0
تبدیلOptions.fit_window = False
تبدیلOptions.from_page = 1           # Start conversion from FromPage page
تبدیلOptions.linearize = False       # Linearize PDF Document for the Web
تبدیلOptions.margin_top = 5
تبدیلOptions.margin_left = 5
تبدیلOptions.unembed_fonts = True     # Make fonts not embedded
تبدیلOptions.remove_pdfa_compliance = False # Remove Pdf-A Compliance

settings.تبدیل_options = تبدیلOptions

# تبدیل درخواست سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# تبدیل
result = تبدیل_api.تبدیل_document(request)

# انجام شده
print("Document تبدیلed: " + result[0].path)
HTML را با استفاده از REST API در پایتون به PDF تبدیل کنید

HTML را با استفاده از REST API در پایتون به PDF تبدیل کنید

فایل تبدیل شده را دانلود کنید

نمونه کد بالا فایل PDF تبدیل شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:

# مقداردهی اولیه API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# ایجاد درخواست دانلود فایل
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# دریافت فایل
response = file_api.download_file(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\")

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

با دنبال کردن مراحل زیر می توانید HTML را به اسناد PDF تبدیل کنید و به اسناد تبدیل شده به صورت برنامه نویسی واترمارک اضافه کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل HTML را تنظیم کنید
  • “pdf” را به قالب اختصاص دهید
  • مسیر فایل خروجی را ارائه دهید
  • یک نمونه از WatermarkOptions ایجاد کنید
  • متن واترمارک، رنگ، عرض، ارتفاع و غیره را تنظیم کنید.
  • PdfConvertOptions را تعریف کرده و WatermarkOptions را اختصاص دهید
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد convert\document() با ConvertDocumentRequest تبدیل کنید

مثال کد زیر نحوه تبدیل یک فایل HTML به سند PDF و اضافه کردن واترمارک به سند PDF تبدیل شده را با استفاده از REST API در پایتون نشان می دهد. لطفاً برای آپلود و دانلود فایل ها مراحل ذکر شده قبلی را دنبال کنید.

# مقداردهی اولیه api
تبدیل_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.html"
settings.format = "pdf"
settings.output_path = "تبدیلed"

# گزینه های واترمارک را تعریف کنید
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Gray";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# گزینه های تبدیل PDF را تعریف کنید
تبدیلOptions = groupdocs_conversion_cloud.PdfConvertOptions()
تبدیلOptions.watermark_options = watermark

settings.تبدیل_options = تبدیلOptions

# ایجاد درخواست تبدیل سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل
result = تبدیل_api.تبدیل_document(request)
print("Document تبدیلed successfully: " + result[0].url)
HTML را به PDF تبدیل کنید و واترمارک را اضافه کنید

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

تبدیل HTML به PDF بدون استفاده از فضای ذخیره سازی ابری

با دنبال کردن مراحل زیر می توانید اسناد HTML را بدون استفاده از فضای ذخیره سازی ابری به PDF تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • ConvertDocumentDirectRequest را ایجاد کنید و فرمت سند درخواستی و مسیر فایل ورودی را ارسال کنید
  • با فراخوانی متد convert\document\direct() با ConvertDocumentDirectRequest نتیجه بگیرید
  • در صورت تمایل، فایل خروجی را با استفاده از متد () shutil.move در مسیر محلی ذخیره کنید

مثال کد زیر نحوه تبدیل یک فایل HTML به سند PDF را بدون استفاده از فضای ذخیره سازی ابری نشان می دهد. شما فایل ورودی را در بدنه درخواست ارسال می کنید و فایل خروجی را در پاسخ API دریافت می کنید.

# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)

# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentDirectRequest("pdf", "C:\\Files\\sample.html")

# تبدیل
result = convert_api.convert_document_direct(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(result, "C:\\Files\\")

تبدیل HTML به PDF و دانلود مستقیم

با دنبال کردن مراحل زیر می توانید به راحتی اسناد HTML را به PDF تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل HTML را تنظیم کنید
  • “pdf” را به قالب اختصاص دهید
  • “None” را روی مسیر خروجی تنظیم کنید
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی روش convert\document\download() نتایج را دریافت کنید
  • در صورت تمایل، فایل خروجی را با استفاده از متد () shutil.move در مسیر محلی ذخیره کنید

مثال کد زیر نحوه تبدیل یک فایل HTML به سند PDF و دانلود مستقیم آن را با استفاده از REST API در پایتون نشان می دهد. API باید فایل PDF تبدیل شده را در پاسخ بازگرداند. لطفاً برای آپلود فایل مراحل ذکر شده قبلی را دنبال کنید.

# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)

# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.تبدیلSettings()
settings.file_path = "sample.html"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentRequest(settings)

# تبدیل
response = convert_api.convert_document_download(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\")

آنلاین را امتحان کنید

لطفاً ابزار آنلاین رایگان تبدیل HTML به PDF زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/conversion/html-to-pdf

نتیجه

در این مقاله نحوه تبدیل فایل های HTML به اسناد PDF با استفاده از پایتون در فضای ابری را یاد گرفتید. شما همچنین یاد گرفته‌اید که چگونه فایل‌های HTML را بدون استفاده از فضای ذخیره‌سازی ابری به صورت برنامه‌نویسی به اسناد PDF تبدیل کنید. علاوه بر این، یاد گرفته‌اید که چگونه با استفاده از پایتون، یک واترمارک به اسناد PDF تبدیل شده اضافه کنید. در این مقاله همچنین نحوه آپلود برنامه‌نویسی فایل HTML در فضای ابری و سپس دانلود فایل PDF تبدیل شده از ابر توضیح داده شده است. می توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.

همچنین ببینید