CodeRay Syntax Highlighter for Rack

Rack::Coderay parses text/html markup and replaces code with output from the CodeRay gem (http://coderay.rubychan.de/), producing syntax highlighting. By default, this component looks for

...

blocks, where 'xxxx' is any of the languages supported by CodeRay (e.g. 'ruby'). See http://coderay.rubychan.de/doc/classes/CodeRay/Scanners.html

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

Installation

Prerequisites:

-Rack gem (sudo gem install rack)
-CodeRay gem (sudo gem install coderay)

From Gem:

$ sudo gem install webficient-rack-coderay

With a local working copy:

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

Usage

Basic Usage

Rack::Coderay 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/coderay'

use Rack::Coderay
run app

Using with Rails

Add this to your config/environment.rb:

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

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

You should now see Rack::Coderay listed in the middleware pipeline:

rake middleware

Configuration Options

To override the default markup trigger (

), you
can pass in a css or xpath selector as the second argument:</p>
<pre><code># Rails example
config.middleware.use Rack::Coderay, "//div[@lang]"

To set additional CodeRay gem options, pass a hash as the third argument:

# Rails example
config.middleware.use Rack::Coderay, 
"//pre[@lang]", 
:line_numbers => :table

Stylesheet

You can grab the latest CSS from the CodeRay site at http://coderay.rubychan.de/stylesheets/coderay.css.

A copy has been embedded in the Rack::Coderay gem under the /resources directory for your convenience.