author Frank-Rainer Grahl <>
Tue, 22 Sep 2020 12:49:57 +0200
changeset 1444 a1df37bb0794cce00c387ebe0ab0db5182f8287b
parent 1225 901cd80a42e80740049714f1bd51a9e030a6dcec
permissions -rw-r--r--
Bug 1663313 - Fix version typo in release notes. r=me

Directory Structure
Contained in the repository:
bin - contains the build scripts
etc - Template Toolkit configuration
lib - various include files for the templates and the site map used to generate
      the navigation menus
src - the actual site content

dest - the output of the build script (the finished website docroot)

Build Requirements
* expat library
* Perl modules:
  * Template Toolkit
  * XML::XPath
Debian: apt-get install expat libtemplate-perl libtemplate-plugin-xml-perl libxml-xpath-perl

Building the Site
To build manually:
* cd into the directory containing this README file
* run "bin/build"
* The "dest" directory will be created if it doesn't exist, and the tree will be
  built there.

To build from a cron job:
* Same as above, but run "bin/" instead, which does locking
  to ensure build jobs don't overlap.

HTML files will be processed by Template Toolkit.  This means you can use Template
Toolkit directives in your pages for creative content or site-wide variables that
you define in one of the config files.  See for

The main site look (banner, navigation, etc) is in lib/wrapper.tmpl

Configuration Files
Most config files are self-documenting.  Read the comments in the files.