Topbarsyntax Plugin

PluginTopbarsyntax
Description for horizontal/vertical, left/right sided, css based menu on dw page wherever you want to have it.
Type syntax
Author Taggic
Last update 2011-10-30
DW compatible 2011-05-25 (Rincewind), 2011-11-10 (Angua)
Depends none
Conflicts none
Similar none
Download https://github.com/Taggic/topbarsyntax/archives/master
Issues fcon - Topbarsyntax issues

Vote for this plugin

TopbarMenu
(2) (2)


Intro

This Plugin allows you to insert menus wherever you want. This might be useful for larger pages, where you want to add a navigation inside chapters. The top bar syntax plugin was also 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 Miachael Kliers template_simple.

Example:

The following text appears between the side menues
due to their style (css) is set to float = left/right.




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.

Example: topbar.txt

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

Finally you have to create 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. For the fcon page this would look similar to following:

topbar.txt
  * [[:start|Home]]
 
  * Plugins
    * Issue Tracker
      * [[issuetracker:descr|Description]]
      * [[issuetracker:report|Report an Issue]]
      * [[issuetracker:issuelist|Issue List]]
    * Training  
      * [[training:start|Overview]]
      * [[training:authors|Author Training]]
      * [[training:admins|Admin Training]] 
    * NEWS System  
      * [[news:how_to_set-up|Description]]
      * [[news:news|News]]
      * [[news:writenews|Write News]]

[also CSS style tips]

Development

[downloadable blocks, development comments]

Change Log

Known Bugs and Issues

Known Issues














 

Id Created Product Version Severity Status Title


ToDo/Wish List

Settings consider that all can read but only registered users are allowed to report issues.

 Please if you want to report an issue.

FAQ

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

Discussion

Please use only the DokuWiki Forum for discussion and IssueTracker above to raise issues. 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).

topbarsyntax/descr.txt · Last modified: 2014/04/30 09:36 (external edit)

This Wiki is hosted and ruled by Policies of Frister Consultancy Services.
By using this wiki you accept these rules. -> Impressum