Prawn
Penjanaan PDF Cepat melalui Pustaka Ruby Sumber Terbuka
API Ruby PDF percuma yang membolehkan pengaturcara membuat & mengubah suai fail PDF; masukkan, edit grafik dan lukis teks pada halaman PDF di dalam Ruby Apps.
Format Dokumen Mudah Alih (PDF) ialah format fail boleh dipercayai dan selamat yang sangat popular untuk mempersembahkan, berkongsi dan mencetak fail di seluruh dunia. Pustaka Ruby sumber terbuka Prawn telah menyediakan fungsi lengkap untuk bekerja dengan dokumen PDF menggunakan perpustakaan Ruby. Perpustakaan ini sangat mudah digunakan dan didokumenkan dengan baik menjadikan kerja pembangun mudah. Ia membantu pembangun untuk mencipta sistem penjanaan dokumen PDF yang sangat fleksibel dengan mudah.
Pustaka Prawn telah merangkumi beberapa ciri penting yang membolehkan pembangun perisian mengendalikan dokumen PDF mereka dengan mudah, seperti penciptaan PDF dari awal, pembenaman imej PNG dan JPG, menambahkan lukisan vektor kepada PDF, menggunakan fon terbina dalam dan fon TrueType, sokongan penyulitan , dokumen PDF selamat menggunakan kata laluan, sokongan pemaparan teks, sokongan fon berasaskan UTF-8, pemaparan teks kanan ke kiri, sokongan menggariskan dan banyak lagi.
Bermula dengan Udang
Untuk memasang Udang pada sistem anda, sila jalankan arahan berikut,
Pasang Udang melalui RubyGems
gem install prawn
Cipta Fail PDF melalui Perpustakaan Ruby
Pustaka Ruby sumber terbuka Prawn membolehkan pembangun perisian mencipta dokumen PDF secara pemrograman menggunakan beberapa baris kod Ruby. Perpustakaan telah menyediakan 3 cara berbeza untuk penciptaan dokumen PDF dengan tetapan lalai dan fon. Ini adalah melalui tugasan, blok tersirat atau blok eksplisit. Setelah dibuat, anda boleh mengakses dan mengubah suai setiap bahagian dokumen PDF anda dengan mudah. Anda boleh menambah halaman baharu dengan mudah, menetapkan saiz halaman dan margin, menukar gaya fon, menggunakan pemformatan dan banyak lagi.
Cipta & Paparkan Fail PDF melalui 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
Masukkan dan Edit Grafik dalam PDF
Pustaka Prawn memberi pembangun perisian kuasa untuk menambah lukisan Vektor ke dalam dokumen PDF mereka menggunakan kod Ruby. Pembangun boleh melukis garisan, poligon, lengkung, bulatan, dsb. dengan mudah ke mana-mana tempat pilihan mereka dalam halaman PDF. Perpustakaan ini telah memasukkan beberapa fungsi penting untuk bekerja dengan grafik seperti warna isian, menggunakan gaya dan corak sempang, menetapkan ketebalan garisan dan menggunakan warna padanya, menggunakan mod campuran, menggunakan transformasi serta ketelusan, dan sebagainya.
Menggunakan Imej dalam Dokumen PDF
Pustaka Ruby sumber terbuka Prawn telah menyediakan sokongan untuk memasukkan imej ke dalam fail PDF anda menggunakan arahan Ruby. Pada masa ini, perpustakaan telah menyertakan sokongan untuk imej JPEG dan PNG. Terdapat beberapa ciri penting yang disediakan untuk menguruskan imej anda di dalam fail PDF seperti melaraskan kedudukan, sokongan penskalaan imej, menetapkan lebar dan ketinggian imej secara berasingan, memasang imej secara berkadar dan sebagainya.
Jana Imej & Skala untuk Muat dalam PDF melalui 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
Melukis Teks pada Halaman PDF
Pustaka Prawn membolehkan profesional perisian melukis teks pada halaman PDF di dalam aplikasi Ruby mereka dengan mudah. Anda boleh mula melukis teks dengan mudah pada kedudukan tertentu halaman PDF. Anda boleh melaraskan kedudukan teks dengan mudah, memutar teks mengikut keperluan anda, menggunakan saiz fon, sokongan baris tunggal dan berbilang baris, dan banyak lagi.
Lukis Teks pada Halaman PDF melalui Perpustakaan Ruby
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