Dokuwiki

Dokuwiki is the wiki engine I am using. It seemed the nicer, more complete and easier to use to me.

There was some problems to have it working on my host Free.

Someone created a patch to solve all the problems: http://forum.dokuwiki.org/thread/518.

One bottleneck of Dokuwiki in the standard version is navigation.

There is a template Sidebar which replaces the default template, which adds this sidebar with the index you can see at your left : http://wiki.jalakai.co.uk/dokuwiki/doku.php/start.

You just have to copy the content of the archive in Dokuwiki/lib/tpl, and either use the admin page to modify the template, or change in local.php :

$conf['template'] = 'sidebar-rc2006-09-28'; // the name of your template folder

You can change some options in sidebar/conf/tplfn_sidebar.php.

In particular if you use to write C/C++ code, you can find annoying that Dokuwiki replaced << and >> by « and ».

You can do that by commenting out the lines in conf/entities.conf.

A list of all plugins is available here

Those I use are:

• discussion
• captcha
• source
• PageIndex
• SearchIndex
• latex
• comment
• note
• tag
• keywords

syntax.php:166|_getSource
  $source = @file($this->location.$file);
+ if (empty($source)) $source = @file($_SERVER['DOCUMENT_ROOT']."/".$this->location.$file);
+ if (empty($source)) $source = @file(DOKU_INC."data/media/".$this->location.$file);
  if (empty($source)) return '';

syntax.php:24|search_list_index
- if ($type == 'd') return false;
+ if ($type == 'd')
+ {
+ 	$id = pathID($file);
+ 	if($opts['ns'].":$id" <> $ID) 
+ 	{
+ 		$data[] = array( 
+ 			'id'    => $opts['ns'].":$id",
+ 			'type'  => $type,
+ 			'level' => $lvl );
+ 	}
+ 	return true;
+ }

To show the start page when clicking on a directory/namespace in the sidebar/index, and to hide the start page in the list of pages.

lib/scripts/index.js:28|treeattach
- addEvent(elem,'click',function(e){ return index.toggle(e,this); });
+ //addEvent(elem,'click',function(e){ return index.toggle(e,this); });
 
inc/html.php:642|html_list_index
  $base = substr($base,strrpos($base,':')+1);
+ if ($base == "start" && $item['id'] != "start") return $ret;
  if($item['type']=='d'){
 
inc/html.php:644|html_list_index
- $ret .= '<a href="'.wl($item['id'], "").':start" class="idx_dir"><strong>';
+ $ret .= '<a href="'.wl($ID,'idx='.rawurlencode($item['id'])).'" class="idx_dir"><strong>';
 
inc/html.php:664|html_li_index
  function html_li_index($item){
+ $base = ':'.$item['id'];
+ $base = substr($base,strrpos($base,':')+1);
+ if ($base == "start" && $item['id'] != "start") return;

In conf/mime.conf, add:

html    text/html
htm     text/html
txt     text/plain
conf    text/plain
xml     text/xml
bas     text/bas
pas     text/pas
c     text/c
cpp     text/cpp
cxx     text/cxx
h     text/h
hpp     text/hpp
hxx     text/hxx