Most web sites use a menu to navigate. <b>Template::TT2Site</b> can
automatically create this menu, using <b>.map</b> files placed in the
directories to navigate. The advantage of <b>.map</b> files is that
they can easily be maintained with the directory data, and directories
can be moved to another location taking the map data with them.
<p>This is how it works.
<p>In your main directory (the one with the top level
<code>index.html</code> in it, create a file <code>.map</code> with
contents:
<pre> title "Site Menu"
</pre>
Now, for each entry you want in this menu, add a line:
<pre> menu "Title" target
</pre>
<p>The item will appear in the menu as "Title".
<p>The target for a menu choice is deducted as follows.
<ul>
<li>if a file <i>target</i><tt>.html</tt> exists, the target is
this HTML document;</li>
<li>if a directory <i>target</i> exists, the target will point to
the <code>index.html</code> in this directory. If this
directory contains a <code>.map</code> file, the navigation menu will
be hierarchically expanded with the items from this directory,
introducing a new level of navigation;</li>
<li>otherwise, target will be taken to be an arbitrary URL.</li>
</ul>
<p>Note that the appearance of the actual menus is controlled by the
layout definition of the web pages (file <code>lib/page/layout</code>)
and the menu (file <code>lib/page/menu</code>).
<p>The visual appearance can be controlled with the style sheet
<code>css/site.css</code>. The menu items will belong to the CSS class
'menu', and the currently active link will be given the class
'menuselect'.