Next / Previous / Contents / TCC Help System / NM Tech homepage

6. The template file

Now that you have created a plan.xml file enumerating all the files and their outline structure, it is time to create the template.xml file, which specifies the standard page layout.

The template.xml file is useful for giving your pages a uniform “look and feel.” It also specifies how you want your standard navigational links to look.

Create this file using any XML editor. If no such editor is available, you can use a regular text editor. An XML editor will, however, make it easier to keep the file valid.

A template.xml file will contain a mixture of elements from two document types (schemas). At the top level, elements conform to a schema in Relax NG Compact Form (RNC) named template.rnc. At certain points in the template, you will insert ordinary XHTML elements that will be carried over to the generated pages.

6.1. template.rnc: The template file schema: prologue

Here is the schema used for the top level of the template file. These elements present the overall structure of the template. You can embed XHTML elements at various places inside these elements, to be copied to the generated page.

The start symbol for this schema is the template element.

template.rnc
start = template
template = element template
{ any
}

We use Relax NG's any pattern to specify a template can have any content—in any namespace. You can use any mixture of XHTML elements, and elements in the template.rnc schema, freely anyplace in a template.

Here is a list of the elements particular to the template schema.

In these definitions, the input page is the .g file contain the specific page content to be expanded into an .html file using the template.