[ADV] The Ruport Book : Your guide to mastering Ruby Reports

Hi folks,

I am pleased to announce that Mike Milner and I have finished the Ruport Book. We have published it under our own company (Rinara Press LLC) through Lulu.

With the help of the Ruport community, we've refined the book over the last few weeks to meet the needs of our users. We think it will be a great help to anyone trying to learn how to do reporting in Ruby / Rails using Ruport.

The book is split up into three parts. It starts with a tutorial introduction to Ruport that's suitable for beginners. It then dives into some real world use of Ruport and its supporting libraries in a simple Rails 2 app I've been working on for a mid-size dental office. Finally, we round it off with a series of quick reference cheatsheets which were developed based on common questions Ruport users have.

So far, we've heard a lot of positive things about this format, and it seems to be helping our users a whole lot.

== Get it ==

You can see the HTML formatted book here:


You can also see a full preview of what the PDF and printed book look like on Lulu:


At 160 pages, it is certainly the most comprehensive documentation on Ruport out there. If you'd like to buy a PDF or Print copy, you can do so here:


== More Information ==

This book is open source! It is released under the very permissive

Creative Commons Attribution-Share Alike 3.0 license, so we hope this will make contributing to the book or reusing parts of its content as easy as possible for you.

We also are donating 25% of our revenues to Engineers Without Borders, USA to help improve the quality of life in developing countries worldwide. This is one way we're taking advantage of the self-publishing model, and we hope that in a few months we'll be able to send a large donation their way.

Finally, because this effort has mostly been something Mike and I have put forth in our spare time with help from the community, we're relying primarily on word of mouth to market the book. If you enjoy it, please tell your friends. If you don't, please email us and tell us why. :slight_smile:

You can keep an eye on http://ruportbook.blogspot.com/ for further announcements, but we hope you enjoy the book, and that it is helpful to you.

-greg & mike

Greg, I am tasked with creating an inventory application where the code39 barcode for the part number must be printed next to each 'item' listing in an Adobe Acrobat printout. I would be most happy to purchase your fine book if this might be covered or perhaps you could suggest where I look? Thank you, Kathleen

I am using Gbarcode to produce an eps version of the barcode, then rmagick to convert the eps to png. It works very well. One gotcha you should look out for is to make sure you set the image type to monochrome or you will get a grayscale version of the barcode that does not scan well.

Good Luck,



Once you produce the png, you can simply do this with Ruport. Adding images to PDFs is covered in a few places in the book, but the easiest place to look for it is the Printable Documents cheatsheet: