Differences between revisions 8 and 9
Revision 8 as of 2007-03-08 16:18:25
Size: 2550
Comment:
Revision 9 as of 2008-11-15 14:00:04
Size: 2550
Editor: localhost
Comment: converted to 1.6 markup
No differences found!

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$

Admin/RedesignRequirements (last edited 2008-11-15 14:00:04 by localhost)

Unable to edit the page? See the FrontPage for instructions.