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$