Starter Template

Starter Template

Compatible with DokuWiki

2012-01-25 "Angua" yes
2011-05-25 "Rincewind" yes
2010-11-07 "Anteater" yes

The template that gets you started

Last updated on: 2011-12-11
Repository: Source

Tagged with discussion, sidebar, simple, start, userpage

By Anika Henke

The Starter Template is designed to be the starting point of your custom template. It has a lot of inline comments in the code which should explain many things. It focuses less on design, but more on maintainability.

It is done in a way which lets you worry less about DokuWiki's core styles (which in this template all begin with an underscore). Instead you only need to care about the four main styles:

basic.css: You probably only want to touch this if you'd like to change general font sizes and font stacks.
structure.css: You probably only want to touch this if you'd like to change the general structure of the site (to 3 columns or have different widths or make everything fluid or switch the sidebar to the right, etc).
design.css: Here you can style all the bits that surround the page content.
content.css: Here you can style all of the page content.

Download and Install

Use the following URL to download this template:

Download latest version (december 2011)
Repository

Refer to template on how to install and use templates in Dokuwiki.

Configuration

These are in [theme root]/starter/conf/default.php. It can be changed from the Configuration panel.

config option	description	default value
`sidebarID`	the pagename (in the root namespace) of your sidebar	`sidebar`
~~`userNS`~~	removed in version 2011-02-20, superseded by `userPage`	~~`user`~~
`userPage`	User page (`@USER@` is replace by the corresponding user name)	`user:@USER@`
~~`discussionNS`~~	removed in version 2011-02-20, superseded by `discussionPage`	~~`discussion`~~
~~`discussNSreverse`~~	removed in version 2011-02-20, superseded by `discussionPage`	~~`0`~~
`discussionPage`	Discussion page (`@ID@` is replaced by the corresponding page ID)	`discussion:@ID@`
`hideTools`	hide editing and other tools when not logged in	`0`
`tagline`	the tagline under your top heading	`This is the tagline - explaining what this site is about.`

More Info

To Do

mobile styles
improve print styles

Credits

Thanks to Andreas GohrAndreas Gohr
andi

Berlin Germany for general advice.
Thanks to Clarence Lee for his design advice, especially concerning typography.

Changes

If you are a template author using this template as a base for your own, you might want to check out the list of detailed changes.

added X-UA-Compatible to always use the best possible browser mode in IE and give users with Chrome Frame the chance to use it (2012/03/24 16:22)
added mediamanager link to be highlighted when selected (2012/03/24 16:13)
removed a few unnecessary classes and elements before IDs in styles (2012/03/24 16:12)
made images fit better into the horizontal grid (2012/03/24 15:50)
improved closed item in sitemap for RTL languages (2012/03/24 15:43)
changed the way RTL styles are added (2012/03/24 15:39)
whitespace changes: made css codings style more consistent (2012/03/24 15:31)
made styles for .pad and .site more specific to avoid interfering with the same classes somewhere else within the page (2012/03/24 15:03)

Demo

http://test.selfthinker.org/

Templates based on Starter

the future DokuWiki default template, “DokuWiki” (coming soon)
ACH
monobook (the DokuWiki CSS parts)
vector (the DokuWiki CSS parts)
Taratasy

Comments

clear and useful！ great！
thank you, this template is very clean and useful for most cases! love this :)

How to translate this theme?

There are two files to translate:

lang/en/lang.php is for everything you see on the frontend (although the “accessibility headlines” are hidden for most users). This file is the most important to translate.
lang/en/settings.php is for the configuration admin. This file is not as important as the other, as it will only be seen by the admin(s).

You can either send me language files to update by email or post them here or in the bugtracker. Please have a look at the available translations first.

How to insert a logo image instead of text?

Open the template's main.php and search for “logo”. It's explained in there.

CSS bug w/ zoom plugin

An image included with the zoom plugin will scroll over the footer and hide it

I cannot reproduce this. Do you have any more specific information? (Browser, other installed plugins, etc?) — Anika HenkeAnika Henke
ach

London, UK 2011/05/02 16:45

Tools hidden - can't login

In the template config, I selected «hide editing and other tools when not logged in» and then I logged out. But now I can't log in as there is no «Login» button/link showing.

Am I missing something? — Nactus 2011-11-10

You probably need to save/remember the login URL (you can get it just by adding ?do=login to any DokuWiki URL). In fact I use the following bookmarklet:
javascript:window.location=window.location+"?do=login"
(I'm assuming the use of webserver rewriting) —Antonio BuenoAntonio Bueno
atnbueno

41.9766,2.8099 2011/11/11 21:40

That sounds like a good idea! Thanks — Nactus 2011-11-13