Yes, I also had a look at this tool and even had a go at feeding it
with the current documentation on the wiki. The output looks indeed
very nice and should make a good way to generate an offline
distribution of the docs.

There is ome work necessary to complete the conversion, most of which
can be automized:

- The toc marker neds to removed from every page
- The comment markup needs to be removed from every page
- "toctree" pages need to be written for every collection of
documents*
- (Optional) mark up class/function/file names etc. to eable automatic
referencing.

* This is a manual process and the main work, as we ned to identify
the documents to include, sort them into collections (i.e. like
"books") and put them in proper order.

Sphinx also has a directive for inlcuding code examples from external
files, so this might also be a starting point for a tutorial
generating tool like it is outlined on the GSoC ideas page.

I'll try to upload my results with converting the current wiki docs
somewhere asap.

Chris

On 21 Mrz., 21:03, "Mark Ramm" <[EMAIL PROTECTED]> wrote:
> http://sphinx.pocoo.org/index.html
>
> This seems to be the place to go for ReST doc handling.   It seems to
> do everything we need it to do, and do it well.
>
> --
> Mark Ramm-Christensen
> email: mark at compoundthinking dot com
> blog:www.compoundthinking.com/blog
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears Docs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to