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

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.

Can you expound upon this one?

A few crumbs please?

ZenWeb?

http://zenspider.com/ZSS/Products/ZenWeb/index.html

You can browse around zenspider.com for a good overview of its features. My website, segment7.net, is also generated by ZenWeb.

PGP.sig (186 Bytes)

···

On 21 Mar 2005, at 17:35, Jim Freeze wrote:

--
Eric Hodel - drbrain@segment7.net - http://segment7.net
FEC2 57F1 D465 EB15 5D6E 7C11 332A 551C 796C 9F04

* Eric Hodel <drbrain@segment7.net> [2005-03-22 10:47:42 +0900]:

ZenWeb?

zenspider projects | software projects | by ryan davis

You can browse around zenspider.com for a good overview of its
features. My website, segment7.net, is also generated by ZenWeb.

Looks good. I'm reviewing the site now.
Is there a gem for it?

···

--
Jim Freeze
Code Red. Code Ruby