Project

jfish

0.0
No commit activity in last 3 years
No release in over 3 years
This RDoc Generator was forked from RDoc's own JFish template and made into a Gem for easy consumption.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.0
~> 4.0.0
 Project Readme

jfish logo

JFish Rdoc 4.0.0+ Generator

This is a complete replacement for the default HTML generator for Rdoc 4.0.0

It was forked from https://github.com/ged/darkfish and modified to look a little greener and meaner.

Getting Started

You can install it via RubyGems:

$ gem install jfish

Usage

Specify from your Rakefile in an RDocTask:

require 'rdoc/task'
Rake::RDocTask.new do |rdoc|

  require 'jfish' #=> THIS IS IMPORTANT
  
  version = File.exist?('VERSION') ? File.read('VERSION') : ""
  
  rdoc.rdoc_dir = 'rdoc'
  
  rdoc.generator = 'jfish' #=> THIS IS IMPORTANT TOO
  
  rdoc.title = "hipster_sql_to_hbase #{version}"
  rdoc.rdoc_files.include('README.rdoc')
  rdoc.rdoc_files.include('lib/**/*.rb').exclude(/lib\/adapter/,/lib\/datatype_extras.rb/)
end

That's it. JFish will automatically register itself to RDoc when required so that all you have to do is set it as the default generator.

The important parts from the above code to add to your task are these:

require 'jfish'

and

rdoc.generator = 'jfish'

Once that's done, just call your rake task like so: $ rake rdoc

Logo

In order to customize your rdoc with your logo simply replace the following path (relative to your generated 'rdoc' folder root):

images/logo.png

License

See the LICENSE file included with the distribution for copyright and licensing details.