public
Description: Ruby LaTeX to PDF preprocessor (and Rails plugin)
Homepage: http://rtex.rubyforge.org
Clone URL: git://github.com/bruce/rtex.git
Click here to lend your support to: rtex and make a donation at www.pledgie.com !
rtex / README_RAILS.rdoc
100644 52 lines (34 sloc) 1.058 kb

RTeX Rails plugin

Installation

  sudo gem install rtex

Rails 2.0.X, 2.1 in vendor/plugins:

  rtex --install /path/to/rails/app

Or, as a Rails 2.1 gem dependency, just add the following to your config/environment.rb:

  config.gem 'rtex'

Dependencies

  • Rails >= 2.0.1

Usage

Create files +pdf.rtex+ extensions (eg, +index.pdf.rtex+) using standard LaTeX markup.

  • Layouts are supported, eg: +application.pdf.rtex+
  • Partials are supported, eg: +_item.pdf.rtex+

Example

With the following:

  # app/controllers/items_controller.rb
  def index
    @items = Item.find(:all)
  end

  # app/views/items/index.pdf.rtex
  \section*{Items}
  \begin{itemize}
  <%= render :partial => @items %>
  \end{itemize}

  # app/views/items/_item.pdf.rtex
  \item <%=l item.name %> \\

  # app/layouts/application.pdf.rtex
  \documentclass[12pt]{article}
  \begin{document}
  <%= yield %>
  \end{document}

If you hit +http://the.server.url/items.pdf+, you end up with a nice PDF listing of items.

Obviously a simplistic example.