مكتبة بايثون مجانية لتحويل HTML و CSS إلى PDF
مكتبة بايثون مفتوحة المصدر تسمح بتوليد مستندات PDF من HTML. تدعم تخطيط الصفحات المتقدم، عرض الصور والجداول، إضافة خطوط مخصصة، رؤوس/تذييلات، وما إلى ذلك.
ما هي مكتبة XHTML2PDF؟
في عالم تطوير الويب، الحاجة إلى إنشاء مستندات PDF من محتوى HTML هي متطلب شائع. سواء كان ذلك لإنشاء الفواتير أو التقارير أو أي نوع آخر من المستندات القابلة للطباعة، فإن وجود أداة موثوقة للتعامل مع هذا التحويل أمر حاسم. هنا يأتي دور XHTML2PDF، مكتبة بايثون مفتوحة المصدر قوية، لإنقاذ الموقف. html2pdf (المعروفة سابقًا باسم pisa) هي مكتبة بايثون خالصة تحول HTML (بما في ذلك XHTML) وCSS إلى مستندات PDF. تم بناؤها على أساس مجموعة أدوات ReportLab وhtml5lib، مع دعم اختياري من PyPDF. إنها مستقلة عن المنصة وسهلة الوصول، وتتيح للمطورين تحويل محتواهم المستند إلى الويب إلى ملفات PDF قابلة للطباعة بسرعة وفعالية.
XHTML2PDF مليء بالميزات التي تجعله أداة متعددة الاستخدامات لإنشاء ملفات PDF. يدعم HTML5 و CSS 2.1، تكامل سلس مع Django، واجهة سطر أوامر قوية، وسوم مخصصة خاصة بـ PDF، تخطيط صفحات متقدم وتنسيق، دعم أفضل للجداول والصور، وغيرها. ما يجعل XHTML2PDF جذابًا للمطورين هو بساطته ومرونته. إذا كنت تعرف كيفية كتابة HTML و CSS، يمكنك البدء في توليد ملفات PDF باستخدام هذه المكتبة في وقت قصير. إنها مكتبة بايثون خالصة، مما يعني أنها مستقلة عن النظام الأساسي ويمكن تشغيلها على أي نظام تشغيل يدعم بايثون. من المهم أيضًا أن تكون على علم بحدود المكتبة، فهي لا تدعم مواصفة CSS بالكامل ولا تنفذ جافا سكريبت.
البدء مع XHTML2PDF
يمكن تثبيت XHTML2PDF باستخدام pip، الأوامر التالية ستثبت من حزمة Python wheel إذا كانت متاحة لمنصتك.
تثبيت XHTML2PDF عبر pip
pip install xhtml2pdf استنساخ المستودع عبر GitHub
git clone https://github.com/xhtml2pdf/xhtml2pdf.git يمكن أيضًا تثبيته يدويًا؛ قم بتحميل أحدث ملفات الإصدار مباشرةً من مستودع GitHub.
تحويل HTML و CSS إلى PDF عبر بايثون
الوظيفة الأساسية لمكتبة XHTML2PDF مفتوحة المصدر هي تحليل HTML و CSS (بما في ذلك الأنماط المضمنة) وتحويلها بدقة إلى مستند PDF. تدعم مجموعة واسعة من وسوم HTML وخصائص CSS، مما يتيح مرونة تصميم كبيرة. تدعم ميزات مثل فواصل الصفحات، رؤوس وتذييلات الصفحات، هوامش وحجم الصفحة، تضمين الخطوط وغيرها. يوضح المثال البسيط التالي كيف يمكن لمطوري البرمجيات تحويل محتوى HTML إلى ملف PDF عبر كود بايثون.
كيفية تحويل محتوى HTML إلى ملف PDF باستخدام Python؟
from xhtml2pdf import pisa
# محتوى HTML المراد تحويله
html_content = """
مرحبًا، عالم!
هذا هو أول ملف PDF تم إنشاؤه باستخدام XHTML2PDF.
"""
# اسم ملف PDF الناتج
output_filename = "hello_world.pdf"
# فتح ملف الإخراج في وضع الكتابة الثنائي
with open(output_filename, "w+b") as pdf_file:
# Create the PDF
pisa_status = pisa.CreatePDF(
html_content, # the HTML to convert
dest=pdf_file) # file handle to receive result
# تحقق مما إذا كان إنشاء PDF ناجحًا
if not pisa_status.err:
print(f"Successfully created PDF: {output_filename}")
else:
print(f"Error creating PDF: {pisa_status.err}")
دعم تخطيط الصفحات المتقدم والخطوط المخصصة
مع مكتبة XHTML2PDF، يتمتع مطورو البرمجيات بتحكم دقيق في تخطيط صفحات PDF الخاصة بهم. يمكنهم تحديد حجم الصفحة، الهوامش، والاتجاه باستخدام قاعدة CSS @page. يمكن للمطورين أيضًا إنشاء رؤوس وتذييلات مخصصة لمستنداتهم. علاوة على ذلك، إذا كنت بحاجة لاستخدام خطوط محددة في ملفات PDF الخاصة بك، تتيح المكتبة إمكانية تضمين خطوط مخصصة. هذا مفيد بشكل خاص للعلامة التجارية وضمان تناسق الطباعة عبر جميع المستندات.
عرض صور وجداول PDF عبر مكتبة بايثون
توفر مكتبة XHTML2PDF مفتوحة المصدر دعمًا قويًا لتصيير الجداول والصور في ملفات PDF الخاصة بك. يمكنك تنسيق جداولك باستخدام CSS، وبالنسبة للصور، يمكنك التحكم في حجمها ومحاذاتها. يمكن للمكتبة حل وتضمين الصور والخطوط وغيرها من الأصول الثابتة بسهولة ودقة، وهو أمر حاسم لإنشاء ملفات PDF ذاتية الاكتفاء. يمكنك إنشاء جدول محتويات تلقائيًا ببساطة عن طريق إضافة الوسم
دعم HTML5 و CSS 2.1
إذا كنت متمكنًا من HTML وCSS، فإن إعادة إنشاء ملفات PDF مع التنسيق يصبح بديهيًا—بدون منحنى تعلم جديد. تتمتع مكتبة XHTML2PDF بدعم ممتاز للمعايير الحديثة للويب، بما في ذلك HTML5 وCSS 2.1، مع بعض الدعم لخصائص CSS 3. وهذا يعني أنه يمكنك استخدام وسوم HTML المألوفة وخصائص CSS لتكوين وتنسيق مستندات PDF الخاصة بك، تمامًا كما تفعل مع صفحة ويب.
