Powering api.rubyonrails.org/ and railsapi.com/
RDoc generator to build searchable HTML documentation for Ruby code.
sdoc
- command line tool to run rdoc with
generator=shtml
(searchable HTML)
sdoc-merge
- comand line tool to merge multiple sdoc folders
into a single documentation site
# Install the gem gem install sdoc # Generate documentation for 'projectdir' sdoc projectdir
sdoc
is simply a wrapper for the rdoc
command
line tool. See sdoc --help
for more details.
--fmt
is set to shtml
by default. The default
template -T
is shtml
, but you can also use the
direct
template.
Example:
sdoc -o doc/rails -T direct rails
Usage: sdoc-merge [options] directories -n, --names [NAMES] Names of merged repositories. Comma separated -o, --op [DIRECTORY] Set the output directory -t, --title [TITLE] Set the title of merged file
Example:
sdoc-merge --title "Ruby v1.9, Rails v2.3.2.1" --op merged --names "Ruby,Rails" ruby-v1.9 rails-v2.3.2.1
# Rakefile require 'sdoc' # and use your RDoc task the same way you used it before Rake::RDocTask.new do |rdoc| rdoc.rdoc_dir = 'doc/rdoc' rdoc.options << '--fmt' << 'shtml' # explictly set shtml generator rdoc.template = 'direct' # lighter template used on railsapi.com ... end
Vladimir Kolesnikov (voloko)
Nathan Broadbent (ndbroadbent)