Command: updateSite.py

The only command used by PubTal is the updateSite.py command. This takes a minimum of one parameter, the location of the website configuration file.

updateSite.py site.config [content-dir | content-file] [...]

The updateSite.py command first reads in the configuration file, in the process locating the content, template, and destination directories (defaulting to content, template, and dest respectively). If only one parameter is passed to updateSite.py, it will then find each file under the content directory and build the corresponding HTML file.

If more than one parameter is passed, then each extra parameter is taken as content to build. If the parameter is a directory under the content directory then any content files in that directory (recurring down through all directories) will be built. If the parameter is a file in the content directory (or one of its children), then just that file will be built.

Take for example:

updateSite.py new-site/site.config new-site/content/index.txt new-site/content/examples/

This will build the index.txt file into index.html and all content files under content/examples/ will be built into their corresponding HTML files.

Note

When PubTal is building the HTML files, it will automatically create any directories that are required.