Extension:YAMBE

What can this extension do?
Creates a hierarchical breadcrumb (navigation path) for a MediaWiki page based on the page that it was created from. Allows users to track back through the wiki more easily and provides a context for the current page.

Whenever a new page is created beneath a page which already uses YAMBE a piece of markup is inserted at the start of the page to set up YAMBE and identify the page's parent. When the page is displayed this is used to build links to the parent page looping through each parent until it gets to the top of the tree.

YAMBE differs from many of the other MediaWiki breadcrumb extensions in that it allows the wiki structure (and the author) to control the breadcrumb that the user sees, rather than displaying the user's progress through the wiki.

Stability
The latest version (0.2.2) has been tested and appears stable on MediaWiki versions 1.15.0 and 1.16.0. The 0.2.0 update fixed an instability identified whilst testing version 0.1.5 with the MediaWiki 1.17.0 alpha.

Version 0.1.5 is known to be stable on MediaWiki 1.13.0, 1.14.0 and 1.15.0. It has issues (fixed in 0.2.0 above) which may cause pages to fail to load or create when used with MediaWiki version 1.16.0 and later.

Usage
Tags are auto-generated when creating a new page, but may be edited to change the details in the breadcrumb if required. Parent Page|Parent Text
 * Self Text is the text to display at the end of the breadcrumb for the current page. Defaults to page name if blank
 * Parent Page is the name of the parent page
 * Parent Text is the text to display in the breadcrumb for the parent

Download instructions
See Getting hold of YAMBE

Installation
See Getting hold of YAMBE

Example
Yambe is being used in a number of intranet and private wikis. You can see it in action on shadowfax.org.uk

Configuration parameters
//Some global config declarations // where to split the URL to find page name. Usually either /index.php/ or /wiki/ $URLSplit = "/index.php/"; $bcDelim = " &gt; "; // Character to mark the stages of the breadcrumb? $maxCountBack = 5; // Maximum number of links in breadcrumb $overflowPre = "[...]"; // Prefix if breadcrumb is longer than $maxCountBack links The above variables can be changed to customise how YAMBE creates the breadcrumb and the maximum depth it supports.