Project

prawn_plus

0.01
A long-lived project that still receives updates
prawn_plusbkuhlmann/prawn_plusHomepageDocumentationSource CodeBug Tracker
A Rails renderer for Prawn PDFs.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
89,594
Stars
31
Forks
3
Watchers
4
 Releases
Current version
15.2.0
Total releases
61
First release
2012-05-26
Latest release
2024-03-03
 Issues
Open Issues
0
Closed Issues
2
Total Issues
2
Issue Closure Rate
100%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
1
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
Hippocratic-2.1
Average date of last 50 commits
2023-08-23
Reverse Dependencies
0

 Dependencies

Runtime

prawn
~> 2.4
prawn-table
~> 0.2
rails
~> 7.1
refinements
~> 12.1
 Project Readme

Prawn+

Prawn+ is a lightweight Rails Engine that wraps the Prawn PDF generator in order to render PDFs within Rails views. This allows you to build view templates which render PDFs using the Prawn syntax.

Table of Contents
  • Features
  • Requirements
  • Setup
  • Usage
    • Views
    • Controllers
  • Development
  • Tests
  • License
  • Security
  • Code of Conduct
  • Contributions
  • Versions
  • Community
  • Credits

Features

  • Loads the Prawn gem by default (no Gemfile entry necessary).

  • Registers PDF as a MIME type.

  • Registers a template handler for rendering “.prawn” template view files.

Requirements

Setup

To install with security, run:

# 💡 Skip this line if you already have the public certificate installed.
gem cert --add <(curl --compressed --location https://alchemists.io/gems.pem)
gem install prawn_plus --trust-policy HighSecurity

To install without security, run:

gem install prawn_plus

You can also add the gem directly to your project:

bundle add prawn_plus

Once the gem is installed, you only need to require it:

require "prawn_plus"

Usage

Views

Within your views you can craft Prawn templates using Ruby code. For example, assuming there are document resources, then the following structure might exist:

/views/documents/show.html.slim
/views/documents/show.pdf.prawn

The show.html.slim could have a link to the PDF download. Example:

= link_to "PDF Download", action: "show", id: @document.id, format: "pdf"

The show.pdf.prawn file would contain the Prawn syntax for crafting the PDF. A simple example might look like this:

pdf.text "Hello, I'm a PDF!"

…​which would render the following output:

Basic Example

You could also render a more complex PDF with tabular information, for example:

pdf.text "Metals"
pdf.move_down 10
pdf.font_size = 10

data = [
  ["Name", "Atomic Number", "Price"],
  ["Mercury", "80", number_to_currency(10)],
  ["Platinum", "78", number_to_currency(25)],
  ["Titanium", "22", number_to_currency(50)]
]

pdf.table data, header: true, column_widths: [100, 50, 50], row_colors: ["FFFFFF", "E5ECF9"] do
  columns(0).align = :left
  columns(1..2).align = :right
  row(0).text_color = "FFFFFF"
  row(0).background_color = "000000"
  row(0).columns(0..2).font_style = :bold
  row(0).columns(0..2).align = :center
end

…​which would render the following output:

Complex Example

NOTE: The pdf object must always be referenced when making using of the Prawn syntax - it is initialized for you as a Prawn::Document instance.

Controllers

Within your controller, only the respond_to method is required. Example:

class DocumentsController < ApplicationController
  respond_to :pdf

  def show
  end
end

That’s it!

Development

To contribute, run:

git clone https://github.com/bkuhlmann/prawn_plus
cd prawn_plus
bin/setup

You can also use the IRB console for direct access to all objects:

bin/console

Tests

To test, run:

bin/rake

Credits