DokuWiki

It's better when it's simple

User Tools

Site Tools


template:simple

This is an old revision of the document!


Simple Template

Author:
Michael Klier
Description:
Features a CSS dropdown menu.
LastUpdate:
2010-10-29
Compatible:
2010-10-27 (packages for older releases available)
Template:
blog, cms
Screenshot:
screenshot: 2007-10-20-simple-01.jpg

Features

  • custom CSS hover topbar menu via a normal wiki page

Screenshots

Some screenshots can be found here.

Download

DokuWiki version download
2010-10-27 “Busy Wednesday” template-simple.tgz (:!: current stable version :!:)
2009-12-25 template-simple-2009-12-25.tgz
2009-02-14 template-simple-2009-02-08.tgz
2008-05-05 template-simple-2008-07-18.tgz
Github URL http://github.com/chimeric/dokuwiki-template-simple

Installation

  1. download the tarball/zip-file
  2. unpack it into <dokuwiki>/lib/tpl/
  3. login as admin and change the template in the configuration manager

using git:

% cd <dokuwiki>/lib/tpl/
% git clone git://github.com/chimeric/dokuwiki-template-simple.git simple

Debian install:

# cd /usr/share/dokuwiki/lib/tpl/
# wget http://www.chimeric.de/_src/template-simple.tgz
# tar -xvf template-simple.tgz

Note: http://chimeric.de/_src/template-simple.tgz always points to the latest stable version!

Configuration

This template has no configuration options yet.

First Steps

Creating the Topbar

The template uses the CSS hover technique to generate the topbar menu from a normal wiki page which contains unordered lists of links. Therefore you have to create a page called “topbar” in your DokuWiki root namespace. Edit it and insert an unordered list of links per menu item. Don't insert anything else than these lists in this page as it will lead to garbage ;-). At the moment only lists with up to 4 levels are supported. You can also have a separate topbar for each namespace. For example, if you browse to wiki:syntax and the page wiki:topbar exists it will be used as the topbar.

  * [[level1]]
    * [[level2]]
      * [[level3]]
        * [[level4]]
    * [[levl2]]

  * [[level1]]
    * [[level2]]
    * [[level2]]

The space between those lists is important!

Style

The template style (colors/font-sizes/width) can be configured via the style.ini file located in <dokuwiki>/lib/tpl/simple/style.ini.

Browser Compatibility

The template was tested with the following browsers.

If you've seen it working with other browsers feel free to add them to the list :-)!

  • Firefox (Win/Linux all → 2.0.0.x / 3.x.x / Mac 1.0.7 / Mac 1.5.0.1)
  • Opera (Win / Linux 8.5-10.X / Win 7.54)
  • Opera Mobile
  • IE6/7
  • Safari
  • Chrome
  • w3m
  • links2
  • lynx
  • Konqueror

Changelog

A complete changelog is available at my github page!

Bugs / Feature Requests

To report bugs and feature requests please use the bug tracker.

Sites using this Template

Discussion

topbar menu and nstoc

An interesting feature would be to autogenerate the Navigation e.g. with nstoc-Plugin or something else so that changes in folder-structure doesn't have to be changed manually - deshi (13.12.2009)

Just use the indexmenu plugin with this syntax: {{indexmenu>..#3|tsort context id#2}}

changing layout

really, really good job! to make this design full width it's enough to comment out the width in simple_design.css:

div.dokuwiki {
  line-height: 160%;
  /* width: __wiki_width__; */
  margin-left: auto;
  margin-right: auto;
}
div.dokuwiki div.page {
  padding: 1em;
  margin: 0 8px 1em 0;
  /* width: 96% !important; */
  /* width: 95%; */
  background-color: __page_background__;
}
Or just edit the style.ini and __wiki_width__ to 100% (that's actually the better way to do this).

How do I find the Backlinks in this template?

Good questions. seems they've been left out. Please open a feature request. — chi 2010/02/02 09:59
template/simple.1290013842.txt.gz · Last modified: 2010-11-17 18:10 by chi

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki