Ruport: Ruby Reports
A free book about Ruport from the Ruby Reports Documentation Effort
Ruport Book Contents
The Ruport Book takes a multi-faceted approach to learning about the Ruby Reports project and its packages. What you'll find is that it is actually three works in one, designed to reach a wide cross-section of users. Each section is described below, and any available content can be found in the chapter listing to the right.
Part I: Introductory Materials
Michael Milner has provided a whirlwhind introduction that is designed to give new users a general feel for how Ruport works. This section of the book walks you through a basic report against the Ruby census data collected by the tattle project. In it, everything from ActiveRecord integration to data manipulations and even custom formatting is covered. We hope that this provides a comfortable starting point for our readers, without resorting to overly contrived examples.
Part II: Ruport in the Real World
The heart of this book is a deep dive through PayR, a simple payroll system developed by Gregory Brown for BTree Technology. In it, you'll see how Ruport fits into Rails to provide a comprehensive reporting solution, and gain insight on how our developers actually use Ruport.
Part III: Ruport Cheatsheets
We have put together a series of concise reference documents which show how to handle tasks using the various subsystems of ruport, ruport-util, and some third party extensions. These will be cross-referenced throughout the book, and may be generally useful for anyone looking for quick solutions to common problems our users face.
Between its three parts, we hope that this book will get you up to speed on Ruport in no time.
What you see here is a free content book, self published by Gregory Brown and Michael Milner under a Creative Commons License.