Extension:StyleByHeaderTree

Introduction
StyleByHeaderTree does two things to rendered xhtml pages:


 * it wraps each section according to the nesting hierarchy of their respective headers;
 * it may give a class and/or an id to each wrapping div, depending on the header's content and the set of rules defined for the plugin.

Use
This is useful for styling, javascripting and adding semantics. This allows for a richer presentation without additional intervention from the authors, as long as certain conventions exist regarding section headers. In our organization, we have used this primarily as a mean to bring stronger semantics to wiki pages, which was then used to produce XML content with further extensions.

The directives associating headers with classes and id are written in a YAML file. Each rule specifies what class and id will be given to the created wrappers' header matching a regular expression or an exact string.

Your Wiki's MediaWiki:Monobook.css may then be edited to give style to the containers according to their classes and id.

Example of rules file
extensions/headerTree/example.yml:

Installation
Download the extension and unzip it in your mediawiki's  folder.

Append the following to LocalSettings.php:

Create a new .yml rules file fitting your needs.

Edit your Wiki's MediaWiki:Monobook.css to use the new classes and id.