Config values and Dowww parameters
Data assignment are lines that look like:
page.info.header = "title"
The left part is the doted notation of an arborescence of identifiers. The
identifier names use characters: _ a-z,A-Z,0-9. They are case
sensitive.
The right part is the value assigned to the identifier. The value can be text,
number or the result of an operation (a "filter").
Some identifiers have special meaning :
target: the file name of the resulting page to generate.
root_path: potion relative to the root of the web site of the resulting page.
template: the name of the Cheetah template to use.
default: values that will used as default for the template.
loop: the name of a field containing a list of values, to use in a loop to generate several pages, one page for each value of the list.
idloop: the name of a field containing a list of names, to use in the build of the html file name in a loop. If not present, the file names are build using by numbering the pages.
previous: loop feature: link to the previous page in the loop.
next: loop feature link to the next page in the loop.
These identifiers themselves can be changed (you can rename "target" to another keyword), using the configuration identifier dowww.
Identifiers beginning by "dowww" contains parameters for the software:
folders :
dowww.folder.web: root folder where the pages will be written
dowww.folder.work: folder for the log and dump data files
dowww.folder.backup: where the previously generated web sites will be saved
dowww.folder.template: folder containing the Cheetah templates
dowww.folder.pytemplate: folder for the .py generated templates. With the default makefile, must be below the template folder
dowww.folder.static: folder containing the directories of static datas to copy (like css, icons, ...)
dowww.folder.content: default location for the data read from the config file by the "read" filter
dowww.folder.config: default location where dowww will search for included config files
other parameters :
To change identifiers for special purpose, default are :dowww.max_backup: how many backup are kept (default 5)
dowww.verbose: verbosity level (default 3)
dowww.dump_page_data: creation of "data" files in the work folder, one file per generated page, containing the actual data for each identifier of the page. Usefull for debugging page contents (default:False)
dowww.dump_page_conf: creation of "config" files in the work folder, containing the identifiers and their values for each page. Usefull for debugging cascadingincludedirectives, default values, and so on... (default:False)
dowww.info_full_path: print the full path of generated pages on the screen. (default:True)
dowww.template_make_command: command issued to rebuild the Cheetah templates. (default"make")
dowww.template_make_on_init: wether the"make"command is executed or not. (default:True)
dowww.format_page_number: how are numbered pages created by the"loop"feature. default:"%s%02d", aka page01.html page02.html ...
dowww.exclude: file suffix to be ignored while copying static directories. Default :"*~ .* *.bck *.bak #* *.o *.pyc *.tmp *.orig CVS temp tmp"
dowww.quiet: suppress messages (default:False)
dowww.word_loop="loop"
dowww.word_idloop="idloop"
dowww.word_default="default"
dowww.word_template="template"
dowww.word_target="target"
dowww.word_root_path="root_path"
dowww.word_previous="previous_page"
dowww.word_next="next_page"
Default name for log files :dowww.written_pages_log: list of generated files (default: "written_pages.log")dowww.written_folders_log: list of copied directories (default: "written_folders.log")