I don't at all mean to sound confrontational, but would simple xml + xsl be a bit easier to implement? If we're just going to have a few pages, a simple shell script could loop thru them calling xsltproc. Then again, I'm a fan of using simple tools for simple needs?
Here's an example of documentation that's created in this manner: http://thinkflat.com/howto/index.html Just my two cents. John M. ____________________ Jim Gallacher wrote: > Justin Erenkrantz wrote: > >> On 2/11/06, Jim Gallacher <[EMAIL PROTECTED]> wrote: >> >>> No, I was not aware that it is auto-generated, but I'm hardly suprised. >>> :) The point was mostly to kick off a discussion. >> >> >> >> The point is that you needn't muck with HTML directly and can focus on >> the content instead. =) -- justin >> > > As a result of the nudge from Justin I've hacked out a minimum build > system for us to play with, based on the httpd doc infrastructure. > > You can download it from: > http://people.apache.org/~jgallacher/mod_python/mp-website-build.tgz > Untar and check the README for further instructions. > > The generated output can be found at > http://people.apache.org/~jgallacher/mod_python/website-test. > > The only links that you should really trust are under the "Get Involved" > meun heading. There is likely all sorts of incorrect or missing content. > This is only intended as a rough demonstration. > > If we decide this is the route we want to take I'll commit the files to > my svn sandbox and we can get to work on the content. > > Jim > >
