The <breadcrumbs> Tag

The "breadcrumb trail" is a piece of navigation text, displaying a list of
the parent pages, from the top-level page right down to the current page.
You've probably seen them before; take a look at this Yahoo
category for an example.

To illustrate, here's an example. Let's say you're browsing the Man Bites
Dog story in an issue of Dogbiting Monthly, which in turn is part of the
Bizarre Periodicals site. Here's a hypothetical breadcrumb trail for that
page:

Bizarre Periodicals : Dogbiting Monthly : Issue 24 : Man
Bites Dog

Typically those would be links, of course, so the user can jump right back to
the contents page for Issue 24 with one click.

If you have a site that contains pages that are more than 2 levels deep from
the front page, you should consider using this to aid navigation.

To use a breadcrumb trail, first define a sitemap. This tells WebMake how to
order the page hierarchy, and which pages to include.

Next, define a template to be used for each entry in the trail. This
should contain references to ${url} (note: not$(url)), which will be replaced with the URL for the page in
question; and ${name}, which will be expanded to the name of the
"main" content item on that page, allowing you to retrieve metadata for that
content like so: $[${name}.title] .

Note: the "main" content item is defined as the first content
item on the page which is not metadata, not perl-generated code, and
has the map attribute set to "true", ie. not a template.

You can also define two more templates to be used at the top of the
breadcrumb trail, ie. the root page, and at the tail of it, ie. the
current page being viewed. These are optional though, and if not specified,
the generic template detailed above will be used as a default.