قم بتحويل HTML إلى PDF باستخدام REST API في Python

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

سيتم تناول الموضوعات التالية في هذه المقالة:

تحويل HTML إلى PDF REST API و Python SDK

لتحويل ملفات HTML إلى PDF ، سأستخدم Python SDK من GroupDocs.Conversion Cloud API. يسمح لك بتحويل المستندات والصور الخاصة بك من أي تنسيق ملف مدعوم إلى أي تنسيق تحتاجه. يمكنك بسهولة التحويل بين أكثر من 50 نوعًا من المستندات والصور مثل Word و PowerPoint و Excel و PDF و HTML و CAD والصور النقطية وما إلى ذلك.

يمكنك تثبيت GroupDocs.Conversion Cloud على مشروع Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:

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 إلى PDF باستخدام REST API في Python

يمكنك تحويل ملف HTML الخاص بك إلى مستندات PDF باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

أولاً ، قم بتحميل ملف HTML إلى السحابة باستخدام مثال الرمز الموضح أدناه:

# إنشاء مثيل لواجهة برمجة التطبيقات
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 في Python

يمكنك بسهولة تحويل مستندات HTML إلى PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • قم بإنشاء مثيل لـ ConvertApi
  • قم بإنشاء مثيل لـ ConvertSettings
  • قم بتعيين مسار ملف HTML
  • قم بتعيين “pdf” للتنسيق
  • قم بتوفير مسار ملف الإخراج
  • حدد PdfConvertOptions إذا لزم الأمر
  • قم بتعيين خصائص متنوعة اختياريًا مثل dpi ، و margin \ top ، و margin \ left ، و fit \ window ، إلخ.
  • قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings
  • احصل على النتائج عن طريق استدعاء الأسلوب convert \ document() باستخدام ConvertDocumentRequest

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

# إنشاء مثيلات 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 إلى PDF باستخدام REST API في Python

قم بتحويل HTML إلى PDF باستخدام REST API في Python

قم بتنزيل الملف المحول

نموذج الكود أعلاه سيحفظ ملف 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 في Python. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل الملفات.

# تهيئة 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” للتنسيق
  • اضبط “لا شيء” على مسار الإخراج
  • قم بإنشاء ConvertDocumentRequest باستخدام ConvertSettings
  • احصل على النتائج باستدعاء طريقة convert \ document \ download()
  • اختياريًا ، احفظ ملف الإخراج إلى المسار المحلي باستخدام طريقة shutil.move()

يوضح مثال الكود التالي كيفية تحويل ملف HTML إلى مستند PDF وتنزيله مباشرةً باستخدام واجهة برمجة تطبيقات REST في Python. يجب على 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 المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/conversion/html-to-pdf

خاتمة

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

أنظر أيضا