ספריית פייתון חינמית להמרת HTML ו‑CSS ל‑PDF
ספריית פייתון קוד פתוח מאפשרת ליצור מסמכי PDF מ‑HTML. היא תומכת בפריסת עמוד מתקדמת, בתצוגת תמונות וטבלאות, בהוספת גופנים מותאמים, בכותרות/תחתונים וכן הלאה.
מהי ספריית XHTML2PDF?
בעולם פיתוח האתרים, הצורך ליצור מסמכי PDF מתוכן HTML הוא צורך נפוץ. בין אם מדובר ביצירת חשבוניות, דוחות או כל סוג אחר של מסמך להדפסה, חשוב שיהיה כלי אמין שמטפל בהמרה זו. כאן נכנסת לתמונה הספרייה הקודפת קוד פתוח של Python, XHTML2PDF, שמצילה את המצב. html2pdf (שנקראה בעבר pisa) היא ספרייה כתובה ב-Python בלבד שממירה HTML (כולל XHTML) ו‑CSS למסמכי PDF. היא נבנתה על גבי ערכת הכלים ReportLab ו‑html5lib, עם תמיכה אופציונלית מ‑PyPDF. בלתי תלויה בפלטפורמה ונגישה, היא מאפשרת למפתחים להפוך את התוכן האינטרנטי שלהם ל‑PDFים מודפסים במהירות וביעילות.
XHTML2PDF מלא בתכונות שהופכות אותו לכלי רב‑גוני ליצירת PDF. הוא תומך ב‑HTML5 וב‑CSS 2.1, אינטגרציה חלקה עם Django, ממשק שורת פקודה חזק, תגיות מותאמות ספציפיות ל‑PDF, פריסת עמודים מתקדמת ועיצוב, תמיכה משופרת בטבלאות ותמונות ועוד. מה שהופך את XHTML2PDF למושך למפתחים הוא הפשטות והגמישות שלו. אם אתה יודע לכתוב HTML ו‑CSS, אתה יכול להתחיל ליצור קבצי PDF עם הספרייה הזו תוך זמן קצר. זו ספרייה טהורה של Python, מה שאומר שהיא בלתי תלויה בפלטפורמה ויכולה לרוץ על כל מערכת הפעלה שתומכת ב‑Python. חשוב גם להיות מודעים למגבלות הספרייה: היא אינה תומכת במלוא המפרט של CSS ואינה מריצה JavaScript.
התחלת עבודה עם XHTML2PDF
ניתן להתקין את XHTML2PDF באמצעות pip, הפקודות הבאות יתקינו ממחוגת Python אם אחת זמינה לפלטפורמה שלך.
התקנת XHTML2PDF באמצעות pip
pip install xhtml2pdf שכפול מאגר דרך GitHub
git clone https://github.com/xhtml2pdf/xhtml2pdf.git ניתן גם להתקין אותו ידנית; הורד את קבצי השחרור האחרונים ישירות ממאגר GitHub.
המרת HTML ו‑CSS ל‑PDF באמצעות Python
הפונקציה העיקרית של ספריית הקוד הפתוח XHTML2PDF היא לנתח HTML ו‑CSS (כולל סגנונות משולבים) וליצור אותם במדויק למסמך PDF. היא תומכת בתת‑קבוצה רחבה של תגיות HTML ותכונות CSS, מה שמאפשר גמישות עיצוב משמעותית. היא תומכת בתכונות כמו שבירת עמוד, כותרות ותחתיות, מרווחי וגודל עמוד, הטמעת גופנים ועוד. הדוגמה הפשוטה הבאה מציגה כיצד מפתחים יכולים להמיר תוכן HTML לקובץ PDF באמצעות קוד Python.
איך להמיר תוכן 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. מפתחים יכולים גם ליצור כותרות ותחתיות מותאמות אישית למסמכים שלהם. בנוסף, אם יש צורך להשתמש בגופנים ספציפיים ב‑PDFs שלכם, הספרייה מאפשרת להטמיע גופנים מותאמים. זה במיוחד שימושי למיתוג ולהבטחת טיפוגרפיה עקבית בכל המסמכים.
הצגת תמונות וטבלאות ב‑PDF באמצעות ספריית Python
הספרייה הפתוחה המקורית XHTML2PDF מספקת תמיכה חזקה ביצירת טבלאות ותמונות בקבצי ה-PDF שלך. אתה יכול לעצב את הטבלאות שלך באמצעות CSS, ובנוגע לתמונות, אתה יכול לשלוט בגודל וביישור שלהן. הספרייה יכולה בקלות ובדיוק לפתור וכן לשלב תמונות, גופנים ונכסים סטטיים אחרים, דבר קריטי ליצירת PDFים עצמאיים. אתה יכול ליצור באופן אוטומטי תוכן עניינים על ידי הוספת תג
תמיכה ב‑HTML5 וב‑CSS 2.1
אם אתה מכיר את HTML ו-CSS, יצירת PDFים עם עיצוב הופכת לאינטואיטיבית—אין עקומת למידה חדשה. הספרייה XHTML2PDF מציעה תמיכה מצוינת בתקנים מודרניים של האינטרנט, כולל HTML5 ו-CSS 2.1, עם תמיכה חלקית בתכונות CSS 3. משמעות הדבר היא שאתה יכול להשתמש בתגיות HTML ובמאפייני CSS שאתה מכיר כדי לבנות ולעצב את מסמכי ה-PDF שלך, בדיוק כפי שהיית עושה עבור דף אינטרנט.
