Release status: stable
|Description||Wraps sections according to header hierarchy. Gives class and id to the wrapping divs according to section title.|
|Latest version||1.1 (2008-10-22)|
Translate the StyleByHeaderTree extension if it is available at translatewiki.net
|Check usage and version matrix; code metrics|
Introduction[edit | edit source]
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.
Usage[edit | edit source]
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[edit | edit source]
- Example of rules file
intro: is: Introduction attr: class: intro question: match: ^Question [0-9]+$ attr: id: question-[COUNTER] class: question answer: is: Answer attr: class: answer code-color: match: ^Code\s+(.*)$ attr: class: code-$1
Installation[edit | edit source]
- Download the extension and unzip it in your mediawiki's
extensions/folder. and extract the file(s) in a directory called
extensions/folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository.
- Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/headerTree/headerTree.php"; $wgHooks['OutputPageBeforeHTML'] = array( new HeaderTree(), 'apply', //change this string according to your new rules file's path "$IP/extensions/headerTree/example.yml" );
- Create a new .yml rules file fitting your needs.
- Edit your wiki's MediaWiki:Monobook.css to use the new classes and id.
- Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.