#
#	quickie - a small fast C++ Wiki Wiki
#	Copyright (C) 2005 Peter Miller
#
#	This program is free software; you can redistribute it and/or modify
#	it under the terms of the GNU General Public License as published by
#	the Free Software Foundation; either version 2 of the License, or
#	(at your option) any later version.
#
#	This program is distributed in the hope that it will be useful,
#	but WITHOUT ANY WARRANTY; without even the implied warranty of
#	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#	GNU General Public License for more details.
#
#	You should have received a copy of the GNU General Public License
#	along with this program; if not, write to the Free Software
#	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
#
# MANIFEST: var/manual/sidebar.wiki
#
! 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 [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 [manual/configuration|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
[manual/configuration|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.