GitHub Sale: sign up for any paid plan this week and pay nothing until January 1, 2009!  [ hide ]

public
Description: Rdoc template and generator for Ruby source code that uses javascript to make searching for methods and classes very easy.
Homepage: http://www.railsbrain.com
Clone URL: git://github.com/breakpointer/ajax-rdoc.git
Brian (author)
Sat Oct 04 12:30:34 -0700 2008
commit  8c135c29e3d986839eb141c2b5103d76ad05ed3d
tree    cb9d95796840e355b6edab2e81f80a6809f109cd
parent  71309a4e3fd9c50f47a05e83a16f68f0887fc01a
ajax-rdoc / README
100644 40 lines (25 sloc) 1.717 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
README for ajax-rdoc - the javascript enhanced rdoc template
 
This template creates a javascript enhanced rdoc (similar to what is on http://www.railsbrain.com ).
 
== Installation
 
1) Get the files (pick your flavor)
    * tarball: http://github.com/breakpointer/ajax-rdoc/tarball/master)
    * git: git clone git://github.com/breakpointer/ajax-rdoc.git
    
2) cd into the new ajax-rdoc directory
 
3) Install the generator and templates into your version of rdoc
    * RDOC=/usr/local/lib/ruby/1.8/rdoc rake install
    * If you are using macports ruby you can just rake install
 
4) Switch over to the directory where you want to run this rdoc template and run the following command
    * rdoc --fmt ajax
 
5) This should start the generator and you'll have your new rdoc template in no-time! It should be in a folder called "doc"
 
For a shortcut you might try adding this to your .bash_profile
>alias ajaxrdoc="rdoc --fmt ajax --exclude .*generator.* --exclude .*test.* --exclude .*spec.*"
 
Thanks to:
Tien Dung (http://github.com/tiendung) for a neat title insertion hack. The title of your rails documentation is pulled from the
directory name (with some humanizing). For example, standing in this directory /blah/ruby/rails-2.1.0 and running rdoc --fmt ajax
will create a title "Rails 2.1.0" for the generated documentation pages.
 
John Nunemaker (http://github.com/jnunemaker) for the addition of the installation rake task.
Also, for the very nice QuickSilver search failover if an exact name match is not found. Very nice indeed!
 
=======
-Brian
 
Alternatively you can set this env var and run the documentation generator from anywhere (ie your home dir)
 
>export RUBYLIB=~/Usersbrian/rails/src/ajax-rdoc (for example)