![](https://products-qa.fileformat.com/ar/pdf/ruby/prawn/header-image.png)
Prawn
إنشاء ملف PDF سريع عبر مكتبة روبي مفتوحة المصدر
واجهة برمجة تطبيقات Ruby PDF المجانية التي تتيح للمبرمجين إنشاء ملفات PDF وتعديلها ؛ إدراج وتحرير الرسومات ورسم نص على صفحة PDF داخل تطبيقات Ruby.
تنسيق المستندات المحمولة (PDF) هو تنسيق ملف شائع وموثوق وآمن لعرض الملفات ومشاركتها وطباعتها في جميع أنحاء العالم. توفر مكتبة Ruby مفتوحة المصدر Prawn وظائف كاملة للعمل مع مستندات PDF باستخدام مكتبة Ruby. المكتبة سهلة الاستخدام وموثقة جيدًا مما يجعل مهمة المطور سهلة. يساعد المطورين على إنشاء نظام إنشاء مستندات PDF عالي المرونة بسهولة.
تضم مكتبة Prawn العديد من الميزات المهمة التي تمكن مطوري البرامج من التعامل مع مستندات PDF الخاصة بهم بسهولة ، مثل إنشاء PDF من البداية ، ودمج صور PNG و JPG ، وإضافة الرسم المتجه إلى PDF ، باستخدام الخطوط المضمنة وخطوط TrueType ، ودعم التشفير ، مستند PDF آمن باستخدام كلمة مرور ، دعم عرض النص ، دعم الخطوط المستندة إلى UTF-8 ، عرض النص من اليمين إلى اليسار ، دعم الخطوط العريضة وغير ذلك الكثير.
الابتداء مع الجمبري
لتثبيت الروبيان على نظامك ، يرجى تشغيل الأمر التالي ،
قم بتثبيت Prawn عبر RubyGems
gem install prawn
قم بإنشاء ملفات PDF عبر مكتبة روبي
تتيح مكتبة Ruby مفتوحة المصدر Prawn لمطوري البرامج إنشاء مستندات PDF برمجيًا باستخدام سطرين من كود Ruby. قدمت المكتبة ثلاث طرق مختلفة لإنشاء مستندات PDF بالإعدادات والخطوط الافتراضية. يتم ذلك من خلال التخصيص أو الحظر الضمني أو الحظر الصريح. بمجرد الإنشاء ، يمكنك الوصول بسهولة إلى كل جزء من مستند PDF وتعديله. يمكنك بسهولة إضافة صفحة جديدة ، وتعيين حجم الصفحة ، والهوامش ، وتغيير أنماط الخطوط ، وتطبيق التنسيق ، وغير ذلك الكثير.
قم بإنشاء ملف PDF وعرضه عبر Ruby
# 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 مطوري البرامج القدرة على إضافة رسومات Vector إلى مستندات 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
تُمكِّن مكتبة Prawn محترفي البرمجيات من رسم نص على صفحة 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