You are not logged in Log in Join
You are here: Home » Members » aaltepet's Home » A Wiki Toolbar for Silva » install.txt » View Document

Log in
Name

Password

 

install.txt

Copyright (c) 2006 Bethel University. All rights reserved.

Meta::
Valid for: Silva 1.4+, Silva Wiki Toolbar 0.9+
Author: Andy Altepeter
Email: aaltepet at altepeter dot net

Installing Silva Wiki Toolbar

The first step is to untar this product into your Products directory
and restart zope.

In the ZMI, go to the container you wish to use as your wiki root and add
a Silva Wiki Toolbar. A WikiToolbar is a folderish object, and will initially
contain the scripts and templates you need to publically expose the toolbar:

toolbar-macro: PageTemplate containing the toolbar.
show-revision: Copy this to your wiki root. This script is used to
browse a documents version history.
web_template.html: Called by show-revision to actually render a document version.
wiki-print.css: print style for wiki. Just hides the toolbar.
wiki-styles.css: styles for the toolbar.

Feel free to customize these as you need, but just be aware that your customizations
are removed if you delete the wiki toolbar!

You will need to do some work to get web_template.html working in your environment.
Bethel University uses a custom layout engine, and this template is configured
to use that engine. It should be fairly trivial to rewrite the template to use
layout_macro.html.

Update wiki-styles.css as needed to change the "look" of your toolbar.

NOTE: these scripts assume your wiki toolbar has an id: wiki-toolbar!
You can of course use whatever id you want, but you'll need to update
these scripts with your toolbar id. This is the SilvaWikiToolbar id, not
the name of the toolbar template (which is toolbar-macro).

Hooking the toolbar in to your public website

There are two additional css files that need to included in your public
layout_macro. Basically, here's the code you will use:

<link rel="stylesheet" type="text/css"
tal:attributes="href here/wiki-toolbar/wiki-styles.css/absolute_url" />
<link rel="stylesheet" type="text/css" media="print"
tal:attributes="href here/wiki-toolbar/wiki-print.css/absolute_url" />

The toolbar-macro will also need to be included in your layout_macro.
Basically, here's the code for this:

<metal:block use-macro="here/wiki-toolbar-macro/macros/toolbar" />

Setting up Revision History Browser

All that needs to be done here is to copy show-revision into your wiki root.

Installing the revised Silva Search

Note: If you are using Silva Search (i.e. <silva-url>/public/search) in production make
sure you test this revised search on a non-production box first, to ensure these changes
don't break your existing silva search!

Copy the files in the silva_search directory into the Silva/views/public product
directory. You will overwrite the existing files. There is a stylesheet included
in this directory (search-styles.css). The contents of this file should be included
somehow in your public layout.