This is the source code for the Template Toolkit web site.
You will need to have the following modules installed (and perhaps some
others too that I've missed):
Template
AppConfig
Path::Class
File::Find::Rule
Pod::POM
Start by running the `bin/configure` script:
$ bin/configure
This processes the templates in the `skeleton` directory to create the
`bin/build` script, the `etc/ttree.cfg` configuration file and a
default configuration file for the Apache web server in
`etc/httpd.conf.default'.
The site is built from templates in the `templates/pages` directory.
The `templates/library` directory contains other template components.
The `bin/build` script is a wrapper around `tree` to build the site.
$ bin/build
You can pass any `ttree` options to the script on the command line.
For example, the build all pages regardless of timestamps:
$ bin/build -a
For further information on the options:
$ bin/build -h
The generated HTML pages are written to the `html` directory.
The HTML documentation for the Template Toolkit is generated from the
POD documentation. The `bin/podmods` script should be used as the first
step.
Specify a path to the `lib` directory of a Template Toolkit distribution
as a command line argument:
$ bin/podmods /path/to/a/copy/of/Template2/lib/
This converts the POD documentation in the Perl modules into HTML page
templates that are written to the `templates/pages/docs/` directory.
It also generates the following YAML files that contain page metadata
for the documentation pages:
metadata/docs/modules.yaml
metadata/docs/pages.yaml
metadata/docs/sections.yaml
Note that this generates page templates rather than the final HTML
pages. You will then need to run the `bin/build` script again to
convert any new documentation templates to their final HTML pages.
$ bin/build
The `templates/pages/about.html` pages is generated from the POD
documentation in `pod/about.pod`.
$ bin/pod2html pod/about.pod > templates/pages/about.html
You will also need to run the `bin/build` script again to convert
the `templates/pages/about.html` template to the equivalent HTML
page in `html/about.html`.
$ bin/build
Directories
-----------
bin scripts
etc config files
html HTML output pages
images images
logs for apache logfiles
metadata contains YAML files providing site/page metadata
perl perl modules (TT plugins, etc)
pod src pod file for web pages (e.g. about.pod)
skeleton skeleton templates used by bin/configure
templates web site page templates and template components