rails 3 中 生成pdf
基于 wkhtmltopdf (http://code.google.com/p/wkhtmltopdf/) 库的比较常见的有pdfkit 和 wicked_pdf 这2个插件。
pdfkit 配置很简单,适合用于快速给每个页面加上pdf版本输出,样式跟html页面完全一样。
三步实现:
1.设置gem
# HTML+CSS to PDF using wkhtmltopdf
# 官方当前最新版本(0.5.0)有BUG,需要使用一个fork版本
# https://github.com/jdpace/PDFKit/issues/66
# January 10, 2011
# gem "pdfkit", :git => "git://github.com/huerlisi/PDFKit.git"
2. 设置mime
# config/initializers/mime_types.rb
# for pdfkit
Mime::Type.register_alias "application/pdf", :pdf
3.设置middleware
# config/application.rb
config.middleware.use "PDFKit::Middleware", :print_media_type => true
这样访问任何一个页面在url的最后加上.pdf,即可得到一个与html版本内容完全一样的pdf输出。
wicked_pdf 的可调整的地方就比较多,比较适合于需要可以任意定制pdf版本页面的需求
跟pdfkit差不多,2-3步可以实现
1. 配置gem
# PDF generator (from HTML) plugin for Ruby on Rails
gem 'wicked_pdf', '0.6.0'
2.render,有很多可选参数,其中: show_as_html 这个参数很有用,可以切换为html输出,方便开发时调整页面的样式
# app/controllers/invoices_controller.rb
def show
show! do |format|
# 如果模板引擎用的是haml,layout必须使用完整的文件名,如“pdf.html.haml”,不能用简写“pdf”
format.pdf { render :pdf => "invoice_#{@invoice.id}", :layout => "pdf.html.haml", :show_as_html => params[:debug].present? }
end
end
3.设置layout,不是必须,但一般都会需要定制下页头页尾的。
# app/views/layouts/pdf.html.haml
!!!
%html{:lang => "en", "xml:lang" => "en", :xmlns => "http://www.w3.org/1999/xhtml"}
%head
%meta{:content => "text/html; charset=UTF-8", "http-equiv" => "Content-Type"}/
= wicked_pdf_stylesheet_link_tag "pdf.css"
= yield :stylesheet
%body
#content
= yield
一些tips:
如果要动态为某个action 插入css,需要用它提供的helper: wicked_pdf_stylesheet_link_tag,如为invoics#show插入invoice.css
# app/views/invoices/show.pdf.haml
- content_for :stylesheet, wicked_pdf_stylesheet_link_tag("invoice.css")
= render "invoice.html.haml"
pdfkit 也可以不使用middleware,而使用 format.pdf { render ...}来达到定制的页面内容的目的,参考这里,或者直接用一个专门的action如/invoices/123/print 或者/invoices/123/pdf 来做内容定制。
install wkhtmltopdf on linux
wget http://wkhtmltopdf.googlecode.com/files/wkhtmltopdf-0.10.0_rc2-static-amd64.tar.bz2
tar xvjf wkhtmltopdf-0.10.0_rc2-static-amd64.tar.bz2
which wkhtmltopdf
/usr/bin/wkhtmltopdf
# backup the old version
sudo mv /usr/bin/wkhtmltopdf /usr/bin/wkhtmltopdf.old
sudo mv wkhtmltopdf-amd64 /usr/bin/wkhtmltopdf
wkhtmltopdf -V
Name:
wkhtmltopdf 0.10.0 rc2
links:
http://railscasts.com/episodes/220-pdfkit
https://github.com/huerlisi/PDFKit
http://snikt.net/index.php/2010/03/03/generating-pdfs-from-ruby-on-rails
https://github.com/mileszs/wicked_pdf
http://www.ruby-forum.com/topic/218049