Prawn
יצירת PDF מהירה באמצעות קוד פתוח Ruby Library
Ruby PDF API בחינם המאפשר למתכנתים ליצור ולשנות קובצי PDF; הוסף, ערוך גרפיקה וצייר טקסט בדף PDF בתוך Ruby Apps.
פורמט המסמכים הנייד (PDF) הוא פורמט קבצים אמין ומאובטח פופולרי מאוד להצגה, שיתוף והדפסה של קבצים ברחבי העולם. ספריית הקוד הפתוח Ruby Prawn סיפקה פונקציונליות מלאה לעבודה עם מסמכי PDF באמצעות ספריית Ruby. הספרייה קלה מאוד לשימוש ומתועדת היטב מה שהופך את עבודת המפתח לקלה. זה עוזר למפתחים ליצור מערכת יצירת מסמכי PDF גמישה ביותר בקלות.
ספריית הסרטנים הקיפה מספר תכונות חשובות המאפשרות למפתחי תוכנה לטפל במסמכי PDF שלהם בקלות, כגון יצירת PDF מאפס, הטבעת תמונות PNG ו-JPG, הוספת ציור וקטור ל-PDF, שימוש בגופנים מובנים ובגופני TrueType, תמיכה בהצפנה , מסמך PDF מאובטח באמצעות סיסמה, תמיכה בעיבוד טקסט, תמיכה בגופנים מבוססי UTF-8, עיבוד טקסט מימין לשמאל, תמיכה בקווי מתאר ועוד רבים נוספים.
תחילת העבודה עם סרטנים
כדי להתקין את הסרטן על המערכת שלך, הפעל את הפקודה הבאה,
התקן סרטן באמצעות RubyGems
gem install prawn
צור קבצי PDF באמצעות ספריית רובי
ספריית הקוד הפתוח Ruby Prawn מאפשרת למפתחי תוכנה ליצור באופן תוכנתי מסמכי PDF באמצעות כמה שורות של קוד Ruby. הספרייה סיפקה 3 דרכים שונות ליצירת מסמכי PDF עם הגדרות ברירת מחדל וגופנים. אלה הם באמצעות הקצאה, חסימה מרומזת או חסימה מפורשת. לאחר היצירה, תוכל לגשת ולשנות בקלות כל חלק במסמך ה-PDF שלך. אתה יכול בקלות להוסיף עמוד חדש, להגדיר את גודל העמוד ואת השוליים, לשנות סגנונות גופנים, להחיל עיצוב ועוד הרבה יותר.
צור ועבד קובץ PDF באמצעות רובי
# Using explicit block form and rendering to a file
content = "Hello World"
Prawn::Document.generate "example.pdf" do |pdf|
# self here is left alone
pdf.font "Times-Roman"
pdf.draw_text content, :at => [200,720], :size => 32
end
הוסף וערוך גרפיקה בתוך קובצי PDF
ספריית ה-Prawn מעניקה למפתחי תוכנה את הכוח להוסיף ציורי וקטור למסמכי ה-PDF שלהם באמצעות קוד Ruby. מפתחים יכולים בקלות לצייר קווים, מצולעים, עקומות, עיגולים וכו' לכל מקום לבחירתם בדף PDF. הספרייה כללה מספר פונקציות חשובות לעבודה עם גרפיקה כגון צבעי מילוי, החלת סגנונות מקפים ודפוס, הגדרת עובי קו והחלת צבע עליו, שימוש במצב מיזוג, החלת טרנספורמציה כמו גם שקיפות וכן הלאה.
שימוש בתמונות במסמכי PDF
ספריית הקוד הפתוח Ruby Prawn סיפקה תמיכה להכנסת תמונות לקבצי ה-PDF שלך באמצעות פקודות Ruby. נכון לעכשיו, הספרייה כללה תמיכה בתמונות JPEG ו-PNG. ישנן מספר תכונות חשובות המסופקות לניהול התמונות שלך בתוך קובץ PDF כגון התאמת מיקום, תמיכה בקנה מידה של תמונה, הגדרת רוחב וגובה תמונה בנפרד, התאמת תמונה פרופורציונלית וכן הלאה.
צור תמונה וקנה מידה כדי להתאים ל-PDF באמצעות Ruby
Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do
pigs = "#{Prawn::DATADIR}/images/pigs.jpg"
image pigs, :at => [50,450], :width => 450
dice = "#{Prawn::DATADIR}/images/dice.png"
image dice, :at => [50, 450], :scale => 0.75
end
ציור טקסט בדף PDF
ספריית הסרטנים מאפשרת למקצועני תוכנה לצייר טקסט על דף PDF בתוך אפליקציית Ruby שלהם בקלות. אתה יכול בקלות להתחיל לצייר טקסט במיקום מוגדר של דף PDF. אתה יכול בקלות להתאים את מיקום הטקסט, לסובב טקסט בהתאם לצרכים שלך, להחיל גודל גופן, תמיכה בשורה אחת ובמספר שורות ועוד הרבה יותר.
צייר טקסט בדף PDF באמצעות ספריית רובי
def draw_text!(text, options)
unless font.unicode? || font.class.hide_m17n_warning || text.ascii_only?
warn "PDF's built-in fonts have very limited support for " \
"internationalized text.\nIf you need full UTF-8 support, " \
"consider using an external font instead.\n\nTo disable this " \
"warning, add the following line to your code:\n" \
"Prawn::Fonts::AFM.hide_m17n_warning = true\n"
font.class.hide_m17n_warning = true
end
x, y = map_to_absolute(options[:at])
add_text_content(text, x, y, options)
end