documentation:config_submenu:start

This is an old revision of the document!


Configuring the submenu

The submenu is the gray container underneath the topbar. It can contain the title and subtitle of the page as well as some additional links.

To create a submenu for a namespace, one has to create a page called submenu in the namespace.

An unorderd list (with links as items) will be converted into a navigation bar at the bottom of the submenu. The subitems of a nested list such as

  * [[item 1]] 
  * [[item 2]] 
      * [[subitem 1]] 
      * [[subitem 2]] 

will be shown when hoverd over the parent item.

For example, the submenu of this page was created by first adding a new page with [[submenu]] and then filling it with content:

====== Submenu ======
===== Subtitle of Submenu =====
  * [[just]]
  * [[some]]
  * [[items]]
      * [[some]]
      * [[with]]
      * [[subitems]]

Deleting a submenu is done by the same way as deleting a page, which is saving it with no content.


As mentioned before, it is possible to create for each namespace a different submenu. If there is no submenu defined in the current namespace, the submenu of the next higher level is used.

For example:

   root namespace (always present)
     │
     └── 'a' namespace
          └──'start_a', pagename,                 %start page of namespace 'a:'
          └──'submenu_a' pagename,              %submenu of namespace 'a:'
          └── 'b' namespace
               └──'submenu_b', pagename,        %submenu of namespace 'a:b:'
               └── 'c' pagename
           └──'d' namespace
               └──'e' pagename

Note: For simpler explanation, the submenus pages are named submenu_a and submenu_b, referring to the submenu page in namespace a: and b:. When implemented, both has to called only submenu.

  • On page start_a, the displayed submenu will be submenu_a, as it is the submenu defined in namespace a:.
  • On page c, the displayed submenu will be submenu_b, as it is the submenu defined in namespace b:.
  • on page e, the displayed submenu will be submenu_a, as there is no submenu defined in namespace d:, thus the submenu defined on the next higher level is used, submenu_a.