Skip to content

jeanlescure/jfish

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

A project to make a complete replacement for the default HTML generator for Rdoc, the API documentation-extraction system for Ruby. (github mirror)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 56.1%
  • CSS 26.4%
  • JavaScript 17.5%