Skip to content

Sidebar (with Translations)

Martin Gabelmann edited this page Aug 9, 2016 · 2 revisions

Sidebar

The template provides two sidebar functionalities: dynamic generation from the index and static from files.

Translations

We prefer the latter because it is more compatible with the translations plugin.
At the root namespace ''/'' create a page called ''sidebar'' and put a list of links there

~~NOCACHE~~
  * [[start|Startseite]]
  * [[mitarbeiter|Mitarbeiter]]
  * [[pub:start|Veroefentlichungen]]

The template searches for a sidebar file in the current namespace: to have a translated version in the english namespace create the file ''/en/sidebar'' with

~~NOCACHE~~
  * [[start|Startpage]]
  * [[mitarbeiter|Members]]
  * [[pub:start|Publications]]

If you want the ''Veroefentlichungen'' subsections to be unfolded when visiting the ''Veroeffentlichungen'' section create the file ''/pub/sidebar'' with

~~NOCACHE~~
  * [[start|Startseite]]
  * [[mitarbeiter|Mitarbeiter]]
  * [[pub:start|Veroefentlichungen]]
    * [[pub:start:diploma|Preprints]
    * [[pub:start:diploma|Diplome]

and similar in the english namespace...

Sort entries

For the static navigation from file it is obvious how to arrange entries.
The dynamic navigation sorts its entries alphanumerically (descending) by the pagename, not of the first heading (which is shown in the navigation). Therefore it is a good option to work with prefixes ([A_-Z_] or [1_-9_]) in the pagename (not heading). To reorder pages you simply have to rename/change the prefix of the corresponding sites with the move plugin.

external links

The DokuKIT template comes with an function to show a list of external links at the bottom of the navigation. You have to enable it and set a pagename that contains the external links in the admin panel (default is ''external''). Create that page (exceptional without heading) and put the list of links in there:

  * [[http://example.com|Externer Link]]
  * [[http://example.com|Externer Link]]

The whole pagecontent is shown in the navigation, therefore the page should not contain other things.

hide entries

When using the dynamic sidebar, use the ''hidepages''-field in the config panel. It expects a regular expression like ''^mitarbeiterseiten|en|playground|test123''. Advanced examples can be found on dokuwiki.