# Sidebar Guide

The sidebar is the column of text which (by default) appears on the left hand side of each wiki page.

You can use the sidebar to provide context for visitors, or direct links to interesting places in your wiki or web site. You can also provide links to external web sites.

## Editing

You can go directly to the sidebar here. You can edit the sidebar with the usual edit link at the bottom of the page. If there is a sidebar on the page you are reading (there is one, by default) it will also have a sidebar edit link on it, for direct access.

## Additional text

The sidebar includes two links, one to the sidebar as a wiki page, and one to the edit link for the sidebar.

At the bottom of the sidebar there is also a list of wiki pages which reference the page text opposite the sidebar. This text does not appear for wiki pages not referenced by any other wiki page. There is no other way to prevent this reference text from appearing.

## Configuration

The sidebar location is controlled by the Sidebar-Layout field in the configuration file.

    Sidebar-Layout: left

Valid settings are `left`, `right` and `none`. If not set, it defaults to `left`.

The `left` and `right` settings indicate which side of the page text to place the sidebar. The `none` setting means that no sidebar will appear on each page.

The sidebar width is controlled by the Sidebar-Width field in the configuration file.

    Sidebar-Width: 100px

Valid settings are an integer followed by "`px`" to indicate a width in pixels, or a number followed by a percent (`%`) sign, to indicate a relative width wide fraction. If not set, it defaults to `100` pixels. The width must be a valid CSS width specification.

## Delayed Application

Please note that changes to the configuration file will only take effect when the each wiki page is next saved, because the HTML of each page is cached until it is next edited.

Edit this page. Historical versions.
This content last modified Thu Oct 12 10:40:49 2017. This html text generated Thu Oct 12 10:40:50 2017.