إذا كنت تقوم بإنشاء تقارير HTML أو فواتير أو صفحات بوابة وتحتاج إلى ملفات PDF بكميات كبيرة، فإن المتطلب الأساسي هو الحصول على مخرجات قابلة للتكرار عبر الأجهزة. يوضح هذا الدليل خطوة بخطوة كيفية تحويل مجموعة من ملفات HTML إلى PDF دفعيًا باستخدام Python و Aspose.HTML for Python via .NET. ستقوم بإنشاء محول يعتمد على المجلد، ثم توسيعه لمعالجة الصفحات التي تحتوي على الكثير من SVG والخطوط المدمجة لضمان عرض متسق.

لماذا تستخدم Aspose.HTML لتحويل دفعات HTML إلى PDF؟

Aspose.HTML for .NET هو واجهة برمجة تطبيقات عرض المستندات يمكنها تحميل محتوى HTML من الملفات أو عناوين URL وتصديره إلى PDF مع تحكم دقيق في خيارات العرض. في سيناريوهات التحويل الجماعي، الفوائد الرئيسية هي

  • عرض موثوق دون أتمتة المتصفح
  • التحكم في خيارات PDF مثل حجم الصفحة والهوامش وعرض الخلفية
  • تنفيذ متوقع في بيئات الخادم
  • القدرة على توحيد الخطوط والموارد عبر العديد من التحويلات

تحويل دفعي لعدة ملفات HTML إلى PDF باستخدام Python — خطوة بخطوة

الخطوة 1: إعداد بيئتك

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

تثبيت Aspose.HTML for Python via .NET

تشغيل:

pip install aspose-html-net

إذا كنت تستخدم بيئة افتراضية:

python -m venv .venv
.venv\Scripts\activate
pip install aspose-html-net

الخطوة 2: إنشاء مجلدات الإدخال والإخراج (اختياري)

أنشئ مجلدين في دليل المشروع الخاص بك:

  • input_html لملفات HTML والموارد
  • output_pdf للملفات PDF المُولدة

الهيكل الموصى به لحل الأصول بشكل موثوق:

  • input_html

  • report1.html

    • report2.html
    • styles

  • site.css

    • images

  • logo.png

    • الخطوط

  • Inter Regular.ttf

احتفظ بـ CSS والصور والخطوط داخل نفس الجذر حتى تعمل المسارات النسبية بشكل ثابت.

الخطوة 3: كتابة برنامج تحويل الدُفعات

يقوم هذا البرنامج النصي بمسح المجلد الإدخالي، ويجد ملفات .html و .htm، ويحول كل ملف إلى PDF بنفس المسار النسبي داخل مجلد الإخراج. كما يسجل نجاح أو فشل كل ملف.

مثال على الكود: تحويل مجموعة من ملفات HTML إلى PDF دفعيًا.

هذا القسم ينفّذ نمط الدفعة الأساسي المستخدم في أتمتة المؤسسات. يقوم بتعداد ملفات HTML، ويُنشئ مسارات إخراج حتمية، ويحوّل كل مستند، ويعيد تقريرًا ملخصًا يمكنك تخزينه للمراقبة وإعادة التنفيذ.

اتبع الخطوات أدناه:

  1. تعيين مجلدات الإدخال والإخراج.
  2. تعداد جميع ملفات HTML.
  3. تحميل كل مستند HTML.
  4. تحويل كل مستند إلى PDF.
  5. حفظ ملفات PDF بأسماء محددة.

يوضح مثال الشيفرة هذا كيفية تحويل مجموعة من ملفات HTML إلى PDF باستخدام Aspose.HTML for Python via .NET.

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input، output، إلخ) لتطابق مواقع ملفاتك الفعلية، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى التوثيق أو التواصل مع فريق الدعم للحصول على المساعدة.

الخطوة 4: تشغيل المحول والتحقق من النتيجة

تشغيل:

python batch_html_to_pdf.py

تحقق:

  • يتم إنشاء ملفات PDF في output
  • هيكل المجلدات يعكس input
  • التخطيط يطابق التوقعات
  • CSS والصور تظهر بشكل صحيح

إذا كان CSS مفقودًا، انتقل إلى قسم Fix Missing CSS, Images, and Broken Relative Paths لأن السبب يكون غالبًا مشكلة في المسار أو حزمة الأصول.

اجعل عرض الخطوط متسقًا عن طريق تضمين الخطوط

إذا كنت تقوم بإنشاء فواتير أو مستندات امتثال، يمكن أن يؤدي استبدال الخطوط إلى تغيير فواصل الأسطر وترقيم الصفحات. الحل الأكثر موثوقية هو تضمين الخطوط مع القوالب الخاصة بك وتحميلها باستخدام CSS.

مثال على الكود: تحويل HTML إلى PDF مع خطوط مدمجة

يركز هذا القسم على تعبئة القالب. يبقى رمز التحويل كما هو. تقوم بدمج الخطوط باستخدام CSS @font-face مع مسارات نسبية.

اتبع الخطوات أدناه:

  1. ضع الخطوط المطلوبة في مجلد يمكن الوصول إليه.
  2. أشر إلى الخطوط عبر CSS باستخدام قواعد @font-face.
  3. تأكد من أن HTML يحمل CSS والخطوط عبر مسارات نسبية.
  4. حوّل HTML إلى PDF وتحقق من ظهور الخط.

هيكل المجلد:

  • input_html

  • invoice.html

    • أنماط

  • invoice.css

    • الخطوط

  • Inter Regular.ttf

    • Inter Bold.ttf

عينة CSS:

@font-face {
  font-family: "Inter";
  src: url("../fonts/Inter Regular.ttf") format("truetype");
  font-weight: 400;
  font-style: normal;
}

@font-face {
  font-family: "Inter";
  src: url("../fonts/Inter Bold.ttf") format("truetype");
  font-weight: 700;
  font-style: normal;
}

body {
  font-family: "Inter", Arial, sans-serif;
}

قم بتشغيل برنامج الدُفعة مرة أخرى وتحقق:

  • يستخدم ملف PDF الخط المقصود.
  • التباعد وترقيم الصفحات يتطابقان مع التخطيط المتوقع.

إصلاح CSS المفقود، الصور والمسارات النسبية المكسورة

إذا كان مخرجات PDF الخاصة بك تبدو غير مُنسقة أو الصور مفقودة، استخدم هذه القائمة المرجعية:

  1. تأكد من أن جميع مراجع الأصول في HTML نسبية لموقع ملف HTML.
  2. احتفظ بالقوالب والأصول تحت مجلد جذري واحد، مثل input.
  3. تجنب المسارات المطلقة التي توجد فقط على جهازك.
  4. تجنب الأصول التي تُقدم عبر عناوين URL لا يمكن للخادم الوصول إليها.

اختبار سريع هو فتح ملف HTML محليًا والتأكد من أنه يحمل ملفات CSS والصور من نفس بنية المجلدات التي تقوم بنشرها إلى الإنتاج.

الخلاصة

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

للاستخدام في الإنتاج، يمكنك شراء ترخيص بزيارة صفحة الأسعار. بدلاً من ذلك، يمكنك طلب رخصة مؤقتة لأغراض التقييم. استكشف المزيد من البرامج التعليمية على مدونة Aspose.HTML وانضم إلى المجتمع في المنتديات للحصول على دعم إضافي.

الأسئلة المتكررة

1. هل يمكنني تحويل كل من ملفات HTML و HTM دفعة واحدة في تشغيل واحد؟

نعم. في برنامج الدُفعة الخاص بك، قم بتضمين كل من امتدادات .html و .htm عند فحص مجلد الإدخال، ثم حوّل كل ملف إلى PDF واحتفظ بنفس بنية الإخراج النسبية.

2. لماذا يفتقد ملف PDF الخاص بي تنسيق CSS أو الصور؟

عادةً ما يحدث هذا عندما لا يتم حل المسارات النسبية في بيئة التحويل. احتفظ بـ CSS والصور والخطوط تحت نفس جذر input، واستخدم المسارات النسبية في HTML و CSS، وتجنب المسارات المطلقة الخاصة بالآلة.

3. كيف أجعل إخراج PDF متسقًا عبر الخوادم؟

قم بتجميع الخطوط المطلوبة مع القوالب الخاصة بك وارجع إليها باستخدام قواعد CSS للخطوط. كما يجب الحفاظ على جميع الأصول محلية ومُصدَّرة بإصدارات بحيث يرى المحول دائمًا نفس ملفات HTML وCSS والصور والخطوط في كل بيئة.

4. هل يحافظ Aspose.HTML على جودة SVG في ملف PDF المُنشأ؟

نعم. عادةً ما يتم عرض عناصر SVG المضمنة كقائمة متجهة في ملف PDF. بعد التحويل، قم بالتكبير على المخططات والرموز للتأكد من بقاء الحواف حادة وأن النص داخل SVG يستخدم الخطوط المتوقعة.

5. كيف يمكنني التعامل مع الفشل عند تحويل مئات أو آلاف الملفات؟

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

اقرأ المزيد