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}_@.com")
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 "_@.com", 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