Bob Clary <http://bclary.com/>
Version 0.24, April 18, 2002
build-web is designed to support the construction of Web Sites containing static content (not generated by server side scripts). The basic scripts are implemented in Perl and were originally inspired by the mozilla.org build scripts.
build-web essentially copies a source directory tree to a destination directory tree while performing the following tasks:
optionally performs make file processing for each Makefile.pre make file in the source directory tree before any files in a directory are processed.
optionally replaces references to virtual or file Server Side includes (SSI) in the destination files with the contents of the included files.
performs directory remapping by replacing occurences of /path-srce/ with /path-dest/ as specified in a perl hash for the project.
optionally wraps one of two different html templates to around destination html files.
optionally performs make file processing for each Makefile.post make file in the destination directory tree after all files in a directory are processed.
optionally can include other build-web projects into arbitrary locations in the destination tree.
By default, build-web supports two destination types: production and development.
With the appropriate environment, build-web can preprocess XML files using XSLT to produce HTML or PDF versions of documents and can post process the output to produce automatically updated Zip files or other output that is dependent on the final content.
The Source Web Site exists in the Source Physical
Directory and is assumed to be written as if were located
on a Web Server in the Source Web Directory of the Web
Server's root directory, i.e. at URL
http://server/SourceWebDirectory/.
A Destination Web Site exists in a Destination Physical
Directory and has all directory references to the Source
Web Subdirectory mapped to refer to a new
Destination Web Directory, i.e. at URL
http://server/DestinationWebDirectory/.
This arrangement makes it possible to create a working
version of the Raw HTML source on a virtual web with URL
http://server/SourceWebDirectory/ which lives in the
Source Physical Directory and a working version of the
Processed HTML source on a virtual web with URL
http://server/DestinationWebDirectory/ living in the
Destination Physical Directory.
Note that for multiple developers on the same server to each
be able to create virtual webs for their personal Raw Source
Physical Directory, separate instances of a web server must be
used since each developer's Source Web will expect to live at
URL http://server/SourceWebDirectory/ Multiple
developers can share a single Destination Physical Directory on
the same web server however.
| Build Web Home |