• README
• BSD-3-Clause license

= Darkfish Rdoc Generator
This is a complete replacement for the default HTML generator for Rdoc 2.
I created it with a few goals in mind:
* Replace the four-frame layout with three different indexes with a single-page,
  class/module-focused view.
* I helped write what became the default look and feel for Rdoc, but it's
  starting to show its age. I wanted to update it with new CSS and Javascript
  for modern browsers.
* Add some of the nifty searching and index-on-the-side stuff I liked from the
  modified Allison template (http://www.superalloy.nl/blog/?p=7) Eloy
  Duran came up with.
* Implemented using separate ERB template files instead of Rdoc's
  constants-in-a-module style templating.
I think I mostly succeeded, and it's nice enough that I wanted to use it for all
my documentation, and I thought you might want to, too. Or at least be able to
tweak it to generate your own spiffy docs.
It looks like this:
http://deveiate.org/darkfish_preview.png
== Getting Started
If you haven't installed it yet, you can install it via RubyGems:
 $ sudo gem install darkfish-rdoc
Or download the source and do:
 $ sudo rake install
== Usage
If you're using RDoc 2.3 or later, the Darkfish formatter will be automatically discovered when RDoc
is loaded, so you only have to specify that you want the 'darkfish' formatter:
 $ rdoc -w 4 -SHN -f darkfish -m README README lib
It's equally easy to specify from a Rakefile in an RDocTask:
  ### Task: rdoc
  require 'rake/rdoctask'
  gem 'darkfish-rdoc' # Omit this if it's installed as a regular library
  Rake::RDocTask.new do |rdoc|
    rdoc.title    = "My Awesome SnoCone Library"
    rdoc.options += [
        '-w', '4',
        '-SHN',
        '-f', 'darkfish', # This bit
        '-m', 'README',
      ]
    rdoc.rdoc_files.include 'README'
    rdoc.rdoc_files.include 'lib/snocone.rb'
  end
That's it.
== Feedback
I'd be happy to have feedback via email (ged at FaerieMUD dot org)
or a ticket on the project's Trac:
  http://deveiate.org/projects/Darkfish-RDoc/
== License
See the LICENSE file included with the distribution for copyright and licensing details.