= Groff

Groff is another ruby pdf generator that doesn’t reinvent the wheel.

It use the always present groff command (on all macs and *nix), and ps2pdf from ghostscript package.

If you load it within rails, you will get a TemplateEngine for free

Some resources to get you started:

• {GitHub Wiki}[http://github.com/guillermo/groff/wikis]
• {GitHub Repo}[http://github.com/guillermo/groff]
• {Conferencia Rails Lighting Talks}[http://isabel.dit.upm.es/component/option,com_docman/task,doc_download/gid,840/Itemid,74/] (WMV)

== Installation

The recommended way is that you get the gem:

add GitHub to your local list of gem sources:

gem sources -a http://gems.github.com/

install the gem:

gem install guillermo-groff

Just add a simple require to the end of “config/environment.rb”:

gem ‘guillermo-groff’
require ‘groff’

That’s it. Remember to install the gem on all machines that you are
deploying to.

== Example usage

Create a view named index.pdf.groff with these content

.AUTHOR “<%= author = %x(who am i).split(” “).first.capitalize %>”
.DOCTYPE LETTER
.PRINTSTYLE TYPESET
.START
.DATE
<%= Time.now.strftime “%A, %d %b %Y %H:%M” %>
.TO
User of Groff
.FROM
Guillermo Álvarez
[email protected]
.GREETING
Hi
Enjoy using groff
.CLOSING
Bye

== Authors and credits

Authors:: Guillermo Álvarez [email protected]
Thanks:: Willpaginate as I used as scaffold for the template engine and gem