[pmwiki-users] New: Flexible Hg Breadcrumbs & Pagenames

[The Editor]

Just uploaded a new release of Hg to make it easier to create
breadcrumbs on your site.  It works somewhat similar to Cluster in
it's simplest mode, but gives much more flexibility for those wanting
it.

>From the recipe documentation:

BreadCrumbs
Hg is designed to give you easy BreadCrumbs, while still allowing
great flexibility. To set up a basic BreadCrumb effect, simply put the
(:breadcrumb:) markup on your page. It will create a pretty, clickable
trail like Group > SubGroup > SubSubGroup > Name. That's all you need
to do! However, you can do more...

If you create a page called Site.HgGroupTitles, you can use text
variables to do full aliasing of how each element in the breadcrumb
looks. For example, suppose you are on page Main-Hide-Start.HomePage,
then on Site.HgGroupTitles, you could put

 Main:  [[Main.HomePage|Welcome]] >
 Hide:
 Start:  [[Somewhere.Else|Getting Started]] >

In this case, the breadcrumb would output Welcome > Getting Started >
HomePage (with appropriate underlying links. The Hg breadcrumb also
uses $Title rather than $NameSpaced (cluster), so you can either
change HomePage to something else, or eliminate it.

In situations where you need extra flexibility, you may wish to
consider a hierarchical page variable (see below), and insert it into
your skin where desired. Then at the default $SiteGroup.BreadCrumb
location, add the (:breadcrumb:) markup. Hg will then enable you to
overwrite it in any child groups you wish, just as it does with
sidebars and sidemenus--allowing you to create fully customized
breadcrumbs wherever needed.

Cheers,
Dan

PS.  Hg also just added a new function to set up any kind of
hierarchical pages you want ($BreadCrumb, $RightBar, $Menu, $TopBar,
whatever).  Just add to config.php:

$FmtPV['$BreadCrumb'] = 'HierarchicalPagenames($group, "BreadCrumb")';

Thanks for the great idea Hans!