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$