To try to clarify how the programs and the assumed directory structure fit together I've included a download of the whole of the sourgumdrop set up. That is, the complete set of directories and contents needed to make the sourgumdrop.org.uk website (as of 19-11-09).
The download is a gzipped tar file. This will be familiar to most Linux, UNIX and probably Mac users. If you are using a Microsoft system, other than installing Cygwin I don't know how you would use it. And I don't know enough about Windows to be able to construct the download in an operating system independent way. Maybe it already is; I just don't know.
1. Download the file sourgumdrop.tar.gz 5MB.
2. Create a directory, say, tmp
3. Copy sourgumdrop.tar.gz to tmp
4. cd to tmp
5. gunzip sourgumdrop.tar.gz
6. tar xvf sourgumdrop.tar
This will produce the directory structure and each directory will contain the files necessary to create the website. All the necessary content files are in the CONTENT directories, the page and menu description files are in the DESCRIPTIONS directories. The COMPLETE directory contains the images directory and only 2 HTML files: 404.html and sitemap.html. All the other HTML files can be made using the supplied scripts.
7. cd SCRIPTS
Now all the HTML files will be in the COMPLETE directory and can be viewed in a browser.
make_all is a shell script (shown in Figure 1.) which runs all the SITE_MAKER Python programs to make the finished website. It must be run from the SCRIPTS directory.
cd ../DESCRIPTIONS pwd python ../SCRIPTS/make_menu.py python ../SCRIPTS/make_pages.py cd ../KAKURO/DESCRIPTIONS pwd python ../../SCRIPTS/make_menu.py python ../../SCRIPTS/make_pages.py cd ../../MINESWEEPER/DESCRIPTIONS pwd python ../../SCRIPTS/make_menu.py python ../../SCRIPTS/make_pages.py cd ../../SITE_MAKER/DESCRIPTIONS pwd python ../../SCRIPTS/make_menu.py python ../../SCRIPTS/make_pages.py cd ../../SOKOBAN/DESCRIPTIONS pwd python ../../SCRIPTS/make_menu.py python ../../SCRIPTS/make_pages.py cd ../../SUDOKU/DESCRIPTIONS pwd python ../../SCRIPTS/make_menu.py python ../../SCRIPTS/make_pages.py