= Goals for 2007 redesign =

 * Rebuilding needs to be faster.
   * Global rebuilds could be very fast.
   * Or, a fast rebuild of a subtree or page needs to be easy.

 * Must not require a massive restructuring of the current build/data tree.  (We may or may not use nav.yml and the other files, but a new tool mustn't require some enormous transition process.) 
 * Continue supporting reST and hand-written HTML; we'll continue working on killing off the HTML, but don't want to make it dependent on that.
 * Should be possible to include Wiki pages.
 * Easier to build: e.g. use the current best-of-practice YAML parser, whatever that may be, instead of a custom wrapper.

 * Should include a redirect list inside the pydotorg SVN, so that it doesn't require editing the Apache configs to move a page.

 * Should use some 3rd-party Python library for templating.

 * Should be usable as the back-end for generating pages on the fly in case python.org becomes fully dynamic.  So generating a single page should be reasonably quick and not require any expensive operations.

== Tasks ==

 * Write conversion tool: YAML info to the navigation format. 
 * Fix encoding problems.
 * Write redirection config. tool.

== Pyramid usage ==

{{{
amk@matterhorn:~/source/p/pyramid-trunk$ pyramid/pyramid --help
usage: pyramid [options]

options:
  -h, --help            show this help message and exit
  -d DATA, --data=DATA  directory in which the fragment data is stored
  -o OUT, --out=OUT     directory in which to save output (will be emptied)
  -r RESOURCES, --resources=RESOURCES
                        comma separated list of resource directories to copy
  -v, --verbose         print status messages to stdout
  -V, --veryverbose     print all data to stdout
  -W, --veryveryverbose
                        print all data to stdout
  -R REBUILDDIRS, --rebuilddirs=REBUILDDIRS
                        only rebuild below these comma separated directories
  -C, --createcache     recreate the cache files
  -c CONSTANTS, --constants=CONSTANTS
                        pass in the names constants (e.g.
                        PDO=/root/pdo,PSF=/psf
  -k, --keepgoing       keep going past errors if possible
  -U, --update          NOT WORKING DO NOT USE try to build only those pages
                        that have changed
  -n, --relativeurls    Converts urls from absolute to relative
  -P, --prettify        Prettify output - not used on live site
amk@matterhorn:~/source/p/pyramid-trunk$
}}}