Rack::Tidy cleans text/html markup by automatically indenting and reformatting content. Best results are achieved with valid markup, when you simply want to use this component to produce clean (X)HTML rendered by templating systems such as ERb.

Rack::Tidy relies on the power of the Tidy gem and defaults to settings based on convention. However, you can override these through configuration.

For more information about the Rack specification, check out rack.rubyforge.org

Prerequisites:

-Rack gem (sudo gem install rack)
-Tidy gem (sudo gem install tidy)

From Gem:

$ sudo gem install webficient-rack-tidy

With a local working copy:

$ git clone git://github.com/webficient/rack-tidy.git
$ rake build && sudo rake install

Basic Usage

Rack::Tidy is implemented as a piece of Rack middleware and can be used with any Rack-based application. If your application includes a rackup (‘.ru`) file or uses Rack::Builder to construct the application pipeline, simply require and use as follows:

require 'rack/tidy'

use Rack::Tidy
run app

Using with Rails

Add this to your ‘config/environment.rb`:

# above Rails::Initializer block
require 'rack/tidy'

# inside Rails::Initializer block
config.middleware.use Rack::Tidy

You should now see ‘Rack::Tidy` listed in the middleware pipeline:

rake middleware

Configuration Options

The Tidy gem requires setting an internal path variable that points to the Tidy library, which will differ per platform. Rack::Tidy defaults to ‘/usr/lib/libtidy.A.dylib’ which is the default location for the Tidy gem on Mac Leopard. To override the constant, simply define it in your application’s configuration file:

TIDY_LIB = '/usr/lib/tidylib.so'

Need Rack::Tidy to ignore certain paths? In your config, pass in an optional array of paths:

# Rails example
config.middleware.use Rack::Tidy, 
  :ignore_paths => ['/admin', '/cms']

Rack::Tidy relies on convention with regard to Tidy’s configuration (see Rack::Tidy::Cleaner for details). If you want to override/set attributes supported by the Tidy gem, declare them in your configuration as an optional hash:

# Rails example
config.middleware.use Rack::Tidy,
  'indent-spaces' => 4

See tidy.sourceforge.net/docs/quickref.html for Tidy gem config options

Copyright © 2009 Phil Misiowiec, Webficient LLC. See MIT-LICENSE for details.