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]
vagrant>Vagrant</>, install with <tvar
1>download-link</> and place the file(s) in a directory called <tvar|name>
headerTree</> in your <tvar|ext>
Add the following code at the bottom of your LocalSettings.php:</translate>
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 - <translate>
Navigate to <tvar|special>Special:Version</> on your wiki to verify that the extension is successfully installed.</translate>code>
wfLoadExtension( 'headerTree' );</>, you need to use:</translate>