Giới thiệu
Chào mọi người !
Trong bài hôm nay, mình xin chia sẻ với mọi người về gem Prawn cũng như cách sử dụng Prawn trong ứng dụng Rails thông qua các ví dụ .
Thì Prawn là một gem tạo file PDF khá mạnh mẽ hỗ trợ chúng ta dễ dàng tạo bảng, nhúng ảnh(png và jpg) hoặc vẽ các đường thẳng, đa giác…
Hello world với Prawn
Để làm quen với Prawn, chúng ta sẽ cùng nhau tạo một file PDF đơn giản là in dòng chữ “Hello World”
Config cơ bản :
Đầu tiên là tạo project rails mới( Phần này mọi người tự tạo và cấu hình nha)
Trong gemfile. Thêm
gem "prawn"
Và run : bundle install
Run : rails generate scaffold User name:string email:string và run rails db:migrate
Fake dữ liệu :
//db/seeds.rb
5.times do |i|
User.create(name: "Name #{i}", email: "email#{i}[email protected]")
end
Run : rails db:seed
Tiếp theo, trong app/config/initializers/mime_types.rb. Thêm :
Mime::Type.register "application/pdf", :pdf
Ok. Vậy là xong phần cài đặt ban đầu
Controller
//users_controller.rb
def show
user = User.find(params[:id])
respond_to do |format|
format.html
format.pdf do
pdf = CvPdf.new
send_data pdf.render,
filename: "users/#{@user.id}.pdf",
type: "application/pdf",
disposition: "inline"
end
end
end
Mọi người để ý option disposition: "inline" sẽ giúp file PDF hiển thị ngay trên trình duyệt mà không phải download về máy.
View
//views/users/show.html.erb . Thêm
<%= link_to 'Printable', user_path(@user, format: "pdf") %>
Định dạng file PDF
Tạo folder : app/pdfs
Tạo file : app/pdfs/cv_pdf.rb
class CvPdf < Prawn::Document
def initialize
super()
text "Hello World !"
end
end
Ở trên ta sẽ tạo class CvPdf kế thừa từ Prawn::Document
Và thông thường chúng ta sẽ viết toàn bộ nội dung của file PDF ở đây.
Run : rails s và đây là kết quả
Ok ! Rất đơn giản đúng không ạ
Tạo bảng với Prawn
Tạo bảng trong Prawn cũng rất đơn giản.
Đầu tiên mọi người phải thêm gem "prawn-table"
Trong cv_pdf.rb
class CvPdf < Prawn::Document
def initialize
super()
rows = [
['o', 'o','x'],
['x', 'o','x'],
['x', 'o','o']
]
table rows
end
end
Kết quả :
Prawn-table có đầy đủ các method hỗ trợ thay đổi độ lớn, màu sắc các cột, các hàng.Mọi người có thể tìm hiểu thêm ở đây : https://github.com/prawnpdf/prawn-table
Các method của Prawn
Một điểm mình rất thích của Prawn là hỗ trợ đầy đủ các method giúp chúng ta có thể tạo bất kỳ file PDF từ đơn giản đến phức tạp.
Đặc biệt là có docs giải thích rất chi tiết : https://prawnpdf.org/manual.pdf
Mình sẽ làm một demo nhỏ là tạo một phần CV để mọi người dễ dàng hình dung cách dùng các method của Prawn.
Mình sẽ lấy mẫu cv trên https://cv.viblo.asia/
Vẫn trong cv_pdf.rb
class CvPdf < Prawn::Document
def initialize
super()
header
info_user
career_goal
experience
end
def header
image "#{Rails.root}/app/assets/images/viblo_logo.png", position: :left, width: 150, height: 150
draw_text "VIBLO CV", at: [200, 700], size: 25, style: :bold
draw_text "Full-Stack Developer", at: [200, 650], size: 25
end
def info_user
draw_text "[email protected]", at: [20, 550], size: 13
draw_text "0123456789", at: [20, 530], size: 13
move_down 100
end
def career_goal
stroke_horizontal_rule
draw_text "CAREER GOAL", at: [20, 450], size: 16, style: :bold
draw_text "Description", at: [30, 430], size: 13
end
def experience
move_down 100
stroke_horizontal_rule
draw_text "EXPERIENCE", at: [20, 350], size: 16, style: :bold
draw_text "You position :", at: [30, 330], size: 13
draw_text "Company name :", at: [30, 310], size: 13
draw_text "Description :", at: [30, 290], size: 13
end
end
Kết quả :
Lưu ý
Prawn có một điểm yếu là cung cấp khá ít font chữ.
Nếu ta muốn sử dụng loại font chữ như tiếng Nhật , Hàn ... thì ta cần phải tự download font và cài thêm.
Vậy muốn hiển thị được tiếng Nhật trong Prawn.
Đầu tiên ta phải font. Link download : https://ctan.org/pkg/ipaex?lang=en
Giải nén và copy font mới đến folder : vendor/fonts
Vẫn trong cv_pdf.rb
class CvPdf < Prawn::Document
def initialize
super()
jp_font
text "学ぶ"
end
def jp_font
font_families.update('JP_font' => { normal: "#{Rails.root}/vendor/fonts/ipaexm.ttf" })
font "JP_font", size: 10
end
end
Ở trên, mình sử dụng method font_families để thêm font chữ mới và đặt tên là JP_font . Sau đó font "JP_font" để sử dụng font mới.
Đây là kết quả :
Lúc đầu, mình cũng hơi bất ngờ vì một gem khá lớn mà vẫn phải thêm font chữ một cách thủ công như vậy.
Nhưng thao tác thêm font chữ mới vào Prawn cũng khá đơn giản nên mọi người chú ý điều này để không gặp lỗi nha ^^
Lời kết
Prawn ưu điểm là tốc độ khá nhanh, có docs chi tiết, hỗ trợ nhúng ảnh, vẽ đường thẳng, đường cong rất dễ dàng.
Nhưng nhược điểm thì chỉ hỗ trợ sẵn một vài font chữ, muốn sử dụng ta phải mất công tự cài đặt font. Và Prawn không và sẽ không bao giờ có trình tạo HTML sang PDF.
Trên đây là những hiểu biết của mình về gem Prawn. Hi vọng qua bài viết mọi người có thể hiểu cơ bản về Prawn.
Cảm ơn mọi người đã đọc ^^
Tài liệu tham khảo
https://github.com/prawnpdf/prawn