Despite the snazzy look of the new default RDoc templates with three panes at the top, I keep coming back to the original flat look of http://www.rubycentral.com/book/builtins.html. There''s something deeply usable with having all the modules and methods take up a full screen instead of being cramped into tiny panes at the top. Of course, it could also be, as Dave Thomas suggested, that I''m just "getting old and inflexible". Regardless of which, I''d be terribly appreciative if anyone had the insight and energy to make a set of RDoc templates that used this flat format with 1 index and 1 page per module. I''d *really* like to have it for the unveiling of the new Ruby on Rails site, which is coming shortly. Even Dave says its not supposed to be that hard: "...if someone wanted to create a new output template and generator, it would be fairly simple: just change the stuff that generates the current top frame to store it all in one file, not three" Anyone up for it? :) -- David Heinemeier Hansson, http://www.basecamphq.com/ -- Web-based Project Management http://www.rubyonrails.org/ -- Web-application framework for Ruby http://macromates.com/ -- TextMate: Code and markup editor (OS X) http://www.loudthinking.com/ -- Broadcasting Brain
I might be able to do it. Where is this code I should edit so I can take a look at it? David Heinemeier Hansson wrote:> Despite the snazzy look of the new default RDoc templates with three > panes at the top, I keep coming back to the original flat look of > http://www.rubycentral.com/book/builtins.html. There''s something deeply > usable with having all the modules and methods take up a full screen > instead of being cramped into tiny panes at the top. Of course, it could > also be, as Dave Thomas suggested, that I''m just "getting old and > inflexible". > > Regardless of which, I''d be terribly appreciative if anyone had the > insight and energy to make a set of RDoc templates that used this flat > format with 1 index and 1 page per module. I''d *really* like to have it > for the unveiling of the new Ruby on Rails site, which is coming shortly. > > Even Dave says its not supposed to be that hard: "...if someone wanted > to create a new output template and generator, it would be fairly > simple: just change the stuff that generates the current top frame to > store it all in one file, not three" > > Anyone up for it? :) > -- > David Heinemeier Hansson, > http://www.basecamphq.com/ -- Web-based Project Management > http://www.rubyonrails.org/ -- Web-application framework for Ruby > http://macromates.com/ -- TextMate: Code and markup editor (OS X) > http://www.loudthinking.com/ -- Broadcasting Brain > > _______________________________________________ > Rails mailing list > Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org > http://lists.rubyonrails.org/mailman/listinfo/rails >
On 20 Dec 2004, at 11:30, Luis G. Gómez wrote:> I might be able to do it. Where is this code I should edit so I can > take a look at it?/usr/local/lib/ruby/1.8/rdoc Take a look at rdoc/generators/template/html for examples of generators. (I tried this once, but my machine was so slow as to make it too frustrating to finish.) -- Eric Hodel - drbrain-48TerJ1FxhPk1uMJSBkQmQ@public.gmane.org - http://segment7.net FEC2 57F1 D465 EB15 5D6E 7C11 332A 551C 796C 9F04 _______________________________________________ Rails mailing list Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org http://lists.rubyonrails.org/mailman/listinfo/rails
On Mon, 20 Dec 2004, David Heinemeier Hansson wrote:> Despite the snazzy look of the new default RDoc templates with three > panes at the top, I keep coming back to the original flat look of > http://www.rubycentral.com/book/builtins.html.... > Regardless of which, I''d be terribly appreciative if anyone had the > insight and energy to make a set of RDoc templates that used this flat > format with 1 index and 1 page per module.Funny, that 3-pane format reminded me a lot of a Smalltalk class/method browser, except it isn''t one, of course. The problem is that it''s static, not dynamic. Given that we have rails here, how about a real browser, rather than static web pages? Heck, you might even contemplate generating the documentation on the fly, so you just point it at a directory and you can start browsing. cjs -- Curt Sampson <cjs@cynic.net> +81 90 7737 2974 http://www.NetBSD.org Make up enjoying your city life...produced by BIC CAMERA