Merge branch 'ready/trail-sort'
[ikiwiki] / doc / plugins / contrib / navbar.mdwn
1 [[!template id=plugin name=navbar author="[[TobiOetiker]]"]]
2
3 The Navbar Plugin renders a Navigation Bar into your page. It is based on code
4 from the [[sidebar_plugin|plugins/sidebar]].
5
6 The plugin looks for a page called "navbar" 
7
8 This page must contain a itemized list of the form
9
10
11     * \[[Welcome|index]]
12     * \[[Management|mgmt]] 
13       * \[[Leadership|mgmt/lead]]       
14       * \[[Kidnapping|mgmt/kidnapping]]          
15     * \[[Information_Technology|it]]  
16       * \[[Windows|it/windows]]
17       * \[[Mobile_Communication|it/mobile]] 
18
19 This list will be turned into a folding menu structure
20
21 Include this into your templates.
22
23     <TMPL_IF NAVBAR> 
24     <div id="navbar">
25     <TMPL_VAR NAVBAR>
26     </div>
27     </TMPL_IF>
28
29
30 To make a nice menu, some css magic is required, but since this is required to make
31 ikiwiki look good anyway, I won't go into details here ... 
32
33 See the navbar in action on <http://insights.oetiker.ch>
34
35 Tobi Oetiker 2006.12.30    
36
37 If you are interested in this, drop me a line tobi at oetiker dot ch
38
39
40 In the meanwhile, I ([[MartinQuinson]]) have hacked this a bit to make it fit my needs. The result is [[here|http://www.loria.fr/~quinson/Hacking/ikiwiki/]]
41
42 In the meanwhile I too have hacked this for my needs and fixed a few bugs in Martin's version.
43 The result (and source / instructions) can be found [[here|http://wiki.math.cmu.edu/iki/wiki/tips/20140720-ikiwiki-navbar.html]]. (It is not mobile ready yet, but might be soon...)