DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:topbarsyntax

This is an old revision of the document!


topbarsyntax Plugin

Compatible with DokuWiki

2011-05-25

plugin delivers horizontal/vertical, css based menu on dw page wherever you want to have it

Last updated on
2011-10-30
Provides
Syntax
Repository
Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with css, menu, simple, template

Intro

The top bar syntax plugin was developed to illustrate the behaiviour caused by the instructions of an article How to integrate the CSS Menu into a template.
The initial code base was taken from the related function of Michael Kliers template_simple.

To see the plugin in action please visit: fcon- examples.

Installation

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Examples/Usage

Please be aware that this is a plugin and not the template integration as described within the mentioned article !

There are two parameters. The first defines the width of the menu. There are all css compatible width values allowed (like px, %, em).

The second parameter configures the menu orientation (h = horizontal, vl = vertical, left sided, vr = vertical, right sided). The vertical menu has the possibility of displaying text right/left beside it due to css is set to float:left/right.

As explained for the template integration, you have to create (and maintain) the link list of your navigation. Therfore store a text file to the pages-root folder of your DokuWiki. The menu items are unordered list items followed by the internal dokuwiki link (all as DW-syntax). There it is necessary to enter an empty line between the level one to tell the php-code that a new menu tab item to be created. If you want to have different menues for namespaces, then create a topbar.txt file within the namespace. If the syntax is called it will look at first into current namespace for the topbar.txt file. If there is no such file it will look into pages-root directory and takes that one.

Syntax

horizntal menu bar syntax, valid expressions

- a horizontal menu of 850px width
{{topbarsyntax>850px,h}}%%  

- a horizontal menu of 100% width
{{topbarsyntax>,h}}%%  

vertical menu bar syntax, valid expressions

- a vertical, left sided menu of 12em width and auto height
{{topbarsyntax>12em,vl}}

- a vertical, right sided menu, with css defined width and auto height
{{topbarsyntax>,vr}}

Configuration and Settings

[also CSS style tips]

Development

[downloadable blocks, development comments]

Change Log

Known Bugs and Issues

  • currently none

ToDo/Wish List

[developers roadmap]

FAQ

[discussions should ideally be deleted and turned into FAQ entries along the way]

Discussion

Please use only the DokuWiki Forum for discussion and TopBarMenu reports to raise yourissues. You can mention it here but this page is not regularily tracked and if something is solved it will be cleaned from this page (better to use the forum due to automated notifications).

plugin/topbarsyntax.1323029664.txt.gz · Last modified: 2011-12-04 21:14 by 93.199.174.62

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki