Each webpage (which becomes a complete html page on your
Website) has, as an attribute to the webpage element, an
ID value. An example is shown in Example 13
Example 13. Using ID values
<?xml version="1.0" encoding="iso-8859-1" ?>
<!-- Time-stamp: "2004-04-18 10:41:38 dpawson" -->
<webpage navto="yes" xml:id="N138" xmlns="http://docbook.org/ns/docbook">
<head>
<title>Books</title>
<summary>Books</summary>
<keywords>XSLT books, books on XSLT, XSLT references</keywords>
<description>A partial list of XSLT reference books</description>
</head>
<webtoc/>
<section>
<title>....
<para> ...
</section>
</webpage>
The build of a Website happens in two phases. The first resolves
the site layout using both the layout.xml and the
actual files that you have written. (N138.xml in
the example above). An intermediate file is produced which, for this file,
has an entry which looks something like
<tocentry page="N138.xml"
xml:id="N138"
dir="xsl/sect1/"
filename="N138.html">
<title>Books</title>
<summary>Books</summary>
</tocentry>
Note that this contains enough information to create the Website (or at least this part of it). The xml file, the directory into which the html file will be placed, and the actual file name of the html file.
This clear tracing of a filename, an ID value and the html file
(most cases) is one aspect I make use of by using the same 'token'
value. In the example above, it is N138. I know that if I find a file that needs
changing called N138.html, then the xml file from
which it was derived will be called N138.xml, and
it will have an ID value of N138.
This is not a mandate. Simply a way for a lazy? efficient? user to navigate over what may become a sizeable Website.
I do hope you will name your files more imaginatively than my 'N138' :-)
Before leaving this example it may be enlightening to look at some of the contents and how the xslt transformation deals with them.
The two elements title and summary are used wherever tables of content are produced. The output is a major and minor heading with the link to that webpage.
The webtoc element generates a table of contents for
web pages 'beneath' the current file, so it really only makes sense to
insert these either at the top of a Website (in the main home page) or
at a section boundary, where the dir attribute is used on a
tocentry in the layout.xml file.
That's really all there is to say about the file. The remainder of a file content is what you want to say.