Default template
The default.tmpl template is provided as an example
template. It shows various techniques useful when creating
templates. The different parts of the template are defined as RXML
tags and are inserted in the table structure found last in the
template. The table defines the page layout of the template. By
separating the layout of the page from the different functions in the
template it is much easier to understand the layout and maintaining
the template.
There are three different navigation menus provided with the
default.tmpl, showing different approaches to the creation of
navigation menus.
Custom tags
There are several custom tags in the default.tmpl. First the
<h1> tag has been redefined as a graphical header and the
<h2> tag as a simple text header. The <leftobject>
tag gives the user of the template the possibility to place images and
other objects in the left margin right under the navigation menu.
The <file-listing> tag gives a simple way to create nice
looking file listings with a few features. By default the tag lists
all text/html files but it can also list different file types by
adding the argument
type=glob-pattern,glob-pattern,... to the tag. The
<file-listing> tag will then list all the files whose content
type match one of the glob patterns. The argument title=The
title of the file listing sets the title of the file
listing.
Navigation menus
There are three different navigation menus provided with the template.
They are all designed to fulfill different goals ranging from easy
navigation in an arbitrary deep structure to simply looking nice. To
change navigation menu in the template edit the tag found below the
comment This is where we insert the navigation menu in the
default.tmpl. The three alternatives are
<navigation-cell-text>, <navigation-cell-graphical>
and <navigation-cell-intranet>.
The first one is a navigation menu built using <sb-output>
together with <gtext> and simple text buttons. It outputs a
simple menu limited to a depth of five folders. It scans the site
structure using <sb-output> and creates buttons linking to
folders and files. To do this it uses the output from the previous
<sb-output> to determine where to scan for files and
subdirectories for the next <sb-output>, this is repeated for
each level in the navigation menu. This navigation menu is suitable
for intranets or large volume Internet sites.
The second navigation menu is basically the same as the first one
but built entirely using the <navigation> tag. It works in
the same way as the previous navigation menu but only in two levels of
folders. The menu created will be graphical only and thus suitable for
smaller sites where the design is important.
The last navigation menu is designed to be used in larger intranet
sites. It is text only and has no limitation in the number of levels
of folders. The navigation menu shows a history of the folders
descended to reach the current folder and the content of the current
folder.
|