====== Simple Template ======

---- template ----
Author_mail:    chi@chimeric.de Michael Klier
Description:    Features a CSS dropdown menu.
LastUpdate_dt:  2010-10-29
Compatible:     2010-10-27 (packages for older releases available)
Template_tags:  blog, cms
Screenshot_img: :template:simple.jpg
----


===== Features =====
  * custom CSS hover topbar menu via a normal wiki page

===== Screenshots =====
Some screenshots can be found [[http://www.chimeric.de/projects:dokuwiki:template:simple:screenshots|here]].

===== Download =====
^ DokuWiki version ^ download ^ 
| 2010-10-27 "Busy Wednesday" | {{http://cloud.github.com/downloads/chimeric/dokuwiki-template-simple/template-simple.tgz}} (:!: **current stable version** :!:) |
| 2009-12-25 | {{http://cloud.github.com/downloads/chimeric/dokuwiki-template-simple/template-simple-2009-12-25.tgz}} |
| 2009-02-14 | {{http://cloud.github.com/downloads/chimeric/dokuwiki-template-simple/template-simple-2009-02-08.tgz}} |
| 2008-05-05 | {{http://cloud.github.com/downloads/chimeric/dokuwiki-template-simple/template-simple-2008-07-18.tgz}} |
| Github URL| [[http://github.com/chimeric/dokuwiki-template-simple]] |

===== Installation =====
  - [[#download]] the tarball/zip-file
  - unpack it into ''<dokuwiki>/lib/tpl/''
  - login as admin and change the template in the configuration manager

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

**Debian install:**
<code>
# cd /usr/share/dokuwiki/lib/tpl/
# wget http://www.chimeric.de/_src/template-simple.tgz
# tar -xvf template-simple.tgz
</code>

**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.

<file>
  * [[level1]]
    * [[level2]]
      * [[level3]]
        * [[level4]]
    * [[levl2]]

  * [[level1]]
    * [[level2]]
    * [[level2]]
</file>

**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 [[http://github.com/chimeric/dokuwiki-template-simple/commits/|github page]]!

{{rss>http://github.com/feeds/chimeric/commits/dokuwiki-template-simple/master 10 1d date}}

===== Bugs / Feature Requests =====
To report bugs and feature requests please use the [[http://github.com/chimeric/dokuwiki-template-simple/issues|bug tracker]].

===== Sites using this Template =====
  * [[http://www.retroclysm.co.cc/|retroclysm]]
  * [[http://operador.if.uff.br/|Wiki do Operador]]
  * [[http://www.gagas.ch|Les gagas]]
  * [[http://momas.fr| Momas, France, public information service]]
  * [[http://www.petermansfeld.de| Private Homepage von Peter A. Mansfeld]]
  * [[http://www.monavocatallemand.com| www.monavocatallemand.com - Le site web en langue française de Me Lueneberg]]
  * [[http://www.frankreichanwalt.de]]
  * [[http://villemain.org| Cédric Villemain]]

===== Discussion =====

==== S5reload Plugin ====
Aim: nice icon to run presentation mode via s5reload-plugin via template integration

Insert in **main.php** (~ line 102):

<code>
<a href="<?php echo exportlink($ID, 's5reloaded')?>" title="online slideshow"><img src="<?php echo DOKU_BASE?>lib/plugins/s5reloaded/screen.gif" height="16px" alt="Slideshow"></a>
</code>

e.g.
<code>
<div class="bar-right" id="bar__topright">
<?php tpl_actionlink('history')?>
<?php tpl_actionlink('subscription')?>
<a href="<?php echo exportlink($ID, 's5reloaded')?>" title="online slideshow"><img src="<?php echo DOKU_BASE?>lib/plugins/s5reloaded/screen.gif" height="16px" alt="Slideshow"></a>
</div>
</code>


==== 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 [[plugin:indexmenu|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).

==== Backlinks? ====
How do I find the Backlinks in this template?

> Good questions. seems they've been left out. Please open a feature request.  --- //[[chi@chimeric.de|chi]] 2010/02/02 09:59//