From: Jim Freeze <jim@...>
Date: 2005-03-22T10:35:53+09:00
Subject: Help for the busy and docgen challenged

Ok, ok, I'm no Jamis, _why, Bill or even David.

But, I do need a way to generate documents 
(at least web based) for my applications and
libraries.

I would prefer a system that let's me write 
a text file and I format it with one of the 
markup languages such as rdoc or xyz_cloth.
If a web interface for editing (like Hieraki) 
is also provided, that is a bonus, but I must be able
to host the editor with either webrick or
Apache.

The output of this app needs to be a nicely
formatted book in the form of a working
website. It must have a TOC, an optional 
index, chapter (and possibly subchapter) links, 
support local references and outside links.

And one other thing, it needs to integrate with
docs generated for other apps/libraries.

So far, I have seen these features in several places,
but have been unable to find a 'gem' of a solution.
For example, Hieraki, docs by Jamis and books by _why.

Does this app already exist in product form? My queries
so far have lead me to "... well I used 
[Hieraki|_why's book|rdoc] and then tweaked it like crazy".

Do you documentation experts have a solution you would 
be willing to share? Do you have something close that 
you would be willing to put on rubyforge and start an 
active project?

I have been needing this for some time but have been too
busy working on some other complimentary features 
(soon to be announced). Plus, I don't think I could come
up with an acceptable solution in a reasonable amount of
time due to my lack of CSS/HTML experience.

A few crumbs please?

-- 
Jim Freeze
Code Red. Code Ruby