Skip to content
forked from raggi/hanna

RDoc generator designed with simplicity, beauty and ease of browsing in mind

License

Notifications You must be signed in to change notification settings

jeremyevans/hanna

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hanna

Hanna is an RDoc generator built with simplicity, beauty and ease of browsing in mind.

Installation

gem install hanna

Usage

rdoc -o doc -f hanna lib

An alternative is to set the ‘RDOCOPT` environment variable:

RDOCOPT="-f hanna"

This will make RDoc always use hanna unless it is explicitly overridden.

Integrating with RubyGems

If you put the following line in your .gemrc, this will make RubyGems use Hanna for all rdoc generation:

rdoc: -f hanna

After doing this, if you wish to have documentation for all your installed gems to be formatted in hanna:

gem rdoc --all --overwrite

Rake task

For repeated generation of API docs, you can set up a Rake task. Set hanna as the RDoc generator:

require 'rdoc/task'
RDoc::Task.new do |rdoc|
  rdoc.generator = 'hanna'
end

Modification to RDoc

Hanna makes a small modification to RDoc to generate more friendly documentation. It changes label lists to use a table instead of a description list, since it is very difficult to get visually appealing styling for description lists without cutting corners (like using fixed widths).

Contributors

The Hanna template was created by Mislav and since then has seen contributions from:

  1. Tony Strauss, who participated from the early start and made tons of fixes and enhancements to the template.

  2. Michael Granger who maintained the original RDoc template.

  3. Hongli Lai with the search filter for methods.

  4. Erik Hollensbe a serious refactoring and up to date with RDoc 2.5.x and 3.x, now named ‘hanna-nouveau’.

  5. James Tucker minor cleanups and RubyGems integration

  6. Jeremy Evans RDoc 4+ support, switch from haml/sass to erb, maintenance since 2014.

About

RDoc generator designed with simplicity, beauty and ease of browsing in mind

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 36.8%
  • CSS 31.1%
  • HTML 29.0%
  • JavaScript 3.1%