Emerald – Make your Ruby documentation a jewel, too

You think Darkfish is the worst RDoc generator ever? Got lost in SDoc and Horo documentations? Found Hanna buggy and dislike frames? Then this is for you: Emerald, the only RDoc template which makes your Ruby docs a jewel, too.

Emerald is a generator for RDoc, i.e. a plugin that replaces RDoc’s standard Darkfish generator from which many people (myself included) think it’s the ugliest RDoc layouting engine that ever was around. If you want nice and modern documentation that allows you to retain overview over a library, Emerald is the generator you want to use.

Installation

Emerald is currently Alpha software. Use it at your own risk.

Get the current development release via RubyGems:

# gem install emerald --pre

If you want the latest version, check out the Git repisitory and build the gem yourself:

$ git clone git://github.com/Quintus/emerald
$ cd emarald
$ rake gem
$ gem install pkg/emerald-x.x.x.gem

Usage

From the commandline:

$ rdoc -f emerald YOURFILESHERE

From a rake RDoc::Task:

require "rdoc/task"
require "rdoc/generator/emerald"

RDoc::Task.new do |rt|
  # Your option stuff...
  rt.generator = "emerald"
end

Features

Caveats

Thanks

Thanks to Eric Hodel keeping RDoc in an active and alive state. Without this, there would be no point in developing Emerald. Next my gratitude is dedicated at Mislav Marohnić for creating the Hanna RDoc template, which sadly is not maintained anymore, but was a big inspiration for Emerald and its default theme, and to everyone on the web who posted something on RDoc’s internals. Without you, it wouldn’t have been possible to get Emerald to where it currently is.

License

Emerald is an RDoc HTML generator.

Copyright © 2013 Marvin Gülker

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <www.gnu.org/licenses/>.

Additional notes