These are some of the steps I took to setup pyblosxom, though not all python string values are of a complete (literal) path:

1. my web directories are in $HOME/data/2web/reagle.org/joseph
2. untar pyblosxom-0.8rc1.tar.gz as $HOME/data/2web/pyblosxom/
3. cp pyblosxom.cgi ../../reagle.org/joseph/blog
4. make "blog" an executable file:

   ForceType application/cgi-script; SetHandler cgi-script

   Unfortunately, this is in the "reagle.org" the root directory and applies to any file named "blog"

5. Update "reagle.org/joseph/blog" to be able to find the files
   

   import sys
   sys.path.append("2web/pyblosxom/")
   sys.path.append("2web/pyblosxom/web")
   sys.path.append("2web/pyblosxom/Pyblosxom")

   I prefer to use these syspaths instead of copying various files within the distribution which seems to be the convenient, but would make migrating the software to future versions even trickier.

6. Update "2web/pyblosxom/web/config.py" for this site including:

   py["datadir"] = "2web/reagle.org/joseph/content"
   py["comment_dir"] = "2web/reagle.org/joseph/comments"
   py["plugin_dirs"] = ["2web/pyblosxom/contrib/plugins",
      "2web/pyblosxom/contrib/entryparsers",
      "2web/pyblosxom/contrib/plugins/comments/plugins"]
   py["load_plugins"] = ["conditionalhttp","pyarchives",
      "pycategories","txtl", "breadcrumbs","comments"]

7. secure "content" and "comments" from web browsing by placing deny directives in the .htaccess file in their directory
8. enable the web server write permission to the "comments" directory
9. find a copy of "textile.py", and place it at "2web/pyblosxom/contrib/entryparsers/"
10. find a copy of breadcrumbs.py, stick it in "2web/pyblosxom/contrib/plugins/breadcrumbs.py"
11. create html flavors
12. tweak pycategories and others to make it generate valid XHTML
13. add "trackback" to "reagle.org/joseph/", and add a system paths to it as for "blog"
14. the URIs for trackback pings should look like "http://reagle.org/joseph/trackback/technology/python/setting-up-pyblosxom"
15. add tweaks so that the flavours can sit in their own directory; and add the HTML entry parser.