Project

pdfcraft

0.0
No commit activity in last 3 years
No release in over 3 years
PDFCraft adds templated rendering of PDF documents to Rails. Now PDF generation of a resource can work just like HTML, XML builders, or JSON.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 2.1
< 6.0, >= 5.0.0.rc1
 Project Readme

A little Rails plugin for rendering PDFs from templates.

Install¶ ↑

Add Pdfcraft to your Gemfile

gem "pdfcraft"

And bundle

% bundle

Usage¶ ↑

Controllers¶ ↑

From your controllers:

def index
  respond_to do |format|
    format.pdf { render pdf: 'contents' }
  end
end

Views¶ ↑

Create view templates just like you would for any other view format. Use file extension .pdfcraft for the pdfcraft template handler.

By default, Pdfcraft gives you access to the pdf document through a variable named ‘pdf’.

pdf.text "This will be rendered in a PDF"

Since Pdfcraft is built on Rails’ templating and rendering, this means that partials, layouts, and helpers are all at your disposal.

pdf.text "This is a template"

render partial: 'aggregates'

Pdfcraft uses Prawn as the rendering engine. For the time being, the pdf object delgates directly to a Prawn::Document object, so refer to Prawn’s API documentation for how to construct a PDF.

One method on the Pdfcraft::Document that is not part of the Prawn::Document is the #page_config method. This method takes all of the options that Prawn::Document#new does, and can only be called once before any other method on Pdfcraft::Document. This is how you can configure the PDF layout options.

pdf.page_config page_layout: :landscape

One you’ve started constructing the document, calls to #page_config will be ignored. There is also a version of #page_config named #page_config! (notice the bang). Using #page_config! will raise an exception if PDF document construction has already begun.

Configuration¶ ↑

If, for some reason, you don’t want to use the ‘pdf’ variable name (perhaps you have a name collision), you can configure the variable to be named anything you want.

Create an initializer and set the Pdfcraft#varibale_name value:

# config/initializers/pdfcraft.rb
Pdfcraft.variable_name = 'gummi_bears'

Then you can reference your pdf document from your views using this variable name instead:

# app/views/a_controller/a_view.pdf.pdfcraft
gummi_bears.move_down 20
gummi_bears.text "Get in ma belly!"

A Note About render_to_string¶ ↑

The contract for render_to_string requires that this method returns a string. In the case of PDF representations, string content doesn’t really make sense, since it’s really a binary format. When render_to_string is called for PDF format, Pdfcraft simply returns the binary data for the generated PDF.