The basic usage of Wsmake is:
shell$ wsmake -f configfilename
This runs Wsmake using the configuration file named "configfilename". The defaults for the output are to report the status of pages which have been updated. Typical output might look like:
shell$ wsmake -f configfilename Upd Part : templates/header.html PoU Webpage: html/index.html [...] shell$ |
The output shows all Pages that are in need of updating. The 3 character state on the left of these lines can be one of the following:
This means there was no change since the last run
This means that there was an error in determining the state of the Page. This could be because of:
Incorrect Permissions
Non-existent directories
Database problems
This means that the Page was not in the database on the last run, but now is. And it will be updated.
This means that the Page will be updated, regardless of it's state, by a request from the user, or because a clone's original was updated.
This means that the source for this Page was modified, so the output will be updated.
This means that the Page has no "output" file and will be updated.
This means that the Page has no "source" file
This means that the "output" file is old and will be updated.
This means that one of the PageOrders that the Page uses has a PagePart whose source has been modified. So the output page will be updated.
This means that one of the Themes that the Page uses has been been updated. So the output page will be updated.
This means that one of the files that the Page has been made to depend on has been been updated. So the output page will be updated.
This means that one of the SubTags that the Page uses has been updated. So the output page will be updated.
This means that one of the SubTagGroups that the Page uses has been updated. So the output page will be updated.
For all cases the page will be updated unless the state is ---, Err, NoS, or Unk.
The next word indicates the type of page: Part, Webpage, or Clone.
When square brackets appear after a target, it represents the start and stop of the make process for that page. The characters in between can be:
A piece of the page.
A file was included by one of the pieces.
A piece of the page source was missing.
Wsmake has the following command line options:
wsmake [-Fshvct] [-m|-e] [-d #] [-f configfile] [target] ... |
Force files to be updated regardless of their state.
Silent. No output.
This help.
Show version and copyright information.
Clean the website.
Sync timestamps between source and output files.
Targets match anywhere in web paths.
Targets match at end of web paths.
Debug output level. (0-3)
0 - No output except for errors
1 - Level 0 and minimal output (default)
2 - Level 1 and verbose output
3 - Level 2 and config file loading info
Configuration filename (looks for wsmakefile and files ending with .ws if option not given
Specific web paths, matching from front, to make. If not specified, all pages will be made.
"clean" is a special target name. When used, all other targets are ignored and the website is cleaned. To clean only certain groups of files, use the -c or --clean option with the targets but without the clean target.
Note that updates to the configuration file will not update the website on the next run. Using the -F or --force option is one solution to this problem. Another is to use a "depend" attribute (discussed in more detail in chapter 3).