[Pyobjc-dev] pyobjc website possibility

[Jim T. <jw...@On...>]

I have started playing with Barry Warsaw's ht2html
<http://ht2html.sf.net> to make some templates for a pyobjc
website.  I also thought the Python FAQ Wizard might be a
useful addition since it allows easy delegation of updates
which can be handy during rapid expansion.

<http://starship.python.net/crew/jwt/pyobjc/> is my playground.

I did this partly to try out the ht2html templating system
and partly to make a nice big place to hold all of the
documentation I am hoping everyone is busy writing.  :-)

The top level of the site has an .ht file for each .html file.
The .ht file is basically just the "body" fragment of standard
HTML. A links.h file makes the upper part of the sidebar.

For the documentation page, I tried fetching the Doc tree out
of CVS and then running those files through reStructured text's
html generator (and today tried combining it with Ollie
Rutherfurd's extension that does reStructured text to .ht,
making the doc pages fit in the template).  An adddocs.py hack
finds the files in the Doc subdirectory and adds them to the
documentation.h file to make the documentation.ht file.  Feels
a bit dirty, but allows easy reuse of the Doc tree and could be
made a cron job.  This allows 'make' to easily regenerate the
site.

A tarball of the site (and a separate ht2html directory with
the generator class I used) is at
http://starship.python.net/crew/jwt/pyobjcweb.tgz if you would
like to see the source.  Additional things needed outside the
tarball are the current docutils snapshot and the Python FAQ
wizard from the source distribution.  The process could be run
remotely and rsync'ed to SourceForge (or run there if all of
the modules are available).

Jim