This is an old revision of the document!
Table of Contents
Sidebar Configuration
The sidebar that you are seeing on the side of this page is a part of the York Template. This document will describe how to customize the sidebar for your DokuWiki site.
Department Name
The department name displays at the top of the sidebar. This is not configurable.
Wiki Name
Under the Department Name, the wiki name is displayed. This is the name that you provided to tech in your request for a wiki. If you decide to change this name, follow these steps:
- Select the “Admin” button.
- Select “Configuration Settings”.
- Under “Basic Settings”, change “Wiki Title”.
- Click the “Save” button at the bottom of the page.
Sidebar Contents
The sidebar contains links to other wiki pages. These links can appear either at the left margin (level 1), or at increased indent (level 2 through 5).
Each wiki namespace can have its own sidebar. When you visit a wiki namespace, the sidebar that you will see is the combination of all the sidebars from the root namespace up to the visited namespace. For example, if you are in the a:b namespace, the sidebar that you view will consist of details from the root namespace sidebar, the a namespace sidebar, and b namespace sidebar. All sidebars are optional.
Finally, sidebar links will only be displayed to users who have read access to those links. This means the your sidebar will adapt depending on who is logged in.
Edit Buttons
Sidebar files can exist in each namespace and have the name “sidebar”. When you wish to edit these pages, you will use the sidebar edit buttons. The edit buttons appear below the sidebar when you are logged in as an admin. One edit button will appear for each level of the namespace that you are in.
For example, if you are in namespace a:b, you will get an edit button for:
- :sidebar - the sidebar for the root namespace
- a:sidebar - the sidebar for the a namespace
- a:b:sidebar - the sidebar for the a:b namespace
Sidebar Syntax
Sidebars are built using an XML syntax as follows:
<sidebar> <item [id="#ID"] [level="#"] [link="LINK"]>[description]</item> </sidebar>
Search
The search area on the sidebar allows you to search through your wiki site. The search is local to your wiki site only.
York Logo
The York Logo is displayed at the bottom of the sidebar along with the page filename, the last modified date, and who modified the file.
special XDokuWiki document. It exists in the DokuWiki namespace, yet the
<sidebar> <item link=":whats_new">What's New</item> </sidebar>
You can add:
- level=X
- id=X