- Download or clone the Kiln code from the GitHub repository.
- Open a terminal window and go to the directory where Kiln is installed (hereafter KILN_HOME).
- Run the command
build.sh(Mac OS X/Linux) or
build.bat(Windows), and leave the Terminal window open.
- Open a browser and got to http://localhost:9999/. It should display a welcome page together with some very basic navigation.
- Store project XML content (TEI) in the folder
- View HTML versions of the TEI XML at http://localhost:9999/text/<TEI filename>.html
- Customise the templates, transformations and site URL
structure. The example project in
KILN_HOME/exampleprovides some guidance on how this can be done.
Overriding XSLT by using
xsl:import - a Kiln XSLT is imported by a local
XSLT, allowing for templates to be redefined for the project.
_internal for internal-to-Cocoon Kiln URLs,
admin for viewable but not public local material,
for local internal-to-Cocoon URLs.
The directory structure makes explicit the division between those parts of Kiln that are its core, and should not be changed in any project installation, and the project-specific material. Kiln material is always a descendant of a directory called kiln.
This division also carries through to the Cocoon pipelines and the XSLT they use. Some Kiln pipelines are designed to be flexible enough to suit multiple different uses by a project-specific pipeline (see the Schematron pipelines for an example). Where a Kiln pipeline uses XSLT that might reasonably be customised by a project, it calls a proxy XSLT not within a kiln directory, that in turn imports the Kiln version. This allows for customisation without changing Kiln core files.