====== 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.  

===== Create a submenu =====
To create a submenu for a namespace, one has to create a page called ''submenu'' in the namespace. The content of the page will be displayed as the submenu. There are some additional rules to the syntax.

==== Headings and links in headings ====
A heading in the submenu is declared as a heading on every other page as well, by using  ''%% ====== Heading ======%%'' at the beginning of the submenu page. The first link in the submenu is displayed as a level 1 heading, every following link as a level 2 heading. i.e.
 <code>
[[documentation:website:start|How to...]]
[[documentation:website:config_submenu:start|Submenu]]
</code>
and 
 <code>
====== How to... ======
===== Submenu =====
</code>
would be displayed in the same way, with the difference that in the first version the headings would also be links.

==== Item list ====
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
<code>
  * [[item 1]] 
  * [[item 2]] 
      * [[subitem 1]] 
      * [[subitem 2]] 
</code>
will be shown when hovered 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:
<code>
[[documentation:website:start|How to...]]
[[documentation:website:config_submenu:start|Submenu]]
  * [[just]]
  * [[some]]
  * [[items]]
      * [[some]]
      * [[with]]
      * [[subitems]]
</code>

----
===== Delete a submenu =====
Deleting a submenu is done by the same way as [[..pages#delete_a_page|deleting a page]], which is saving it with no content.
----
===== Different submenus for different namespaces =====
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:
<file>
   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
</file>
//**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 have 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''.

//**Note:** If two pages should have different submenus, they have to be created in different namespaces, as a submenu in one namespace will be used for all pages inside of the namespace.//