Difference between revisions of "DokuWiki"

From Linuxintro
imported>ThorstenStaerk
imported>ThorstenStaerk
Line 38: Line 38:
  
 
=== template ===
 
=== template ===
* use the monobook template as mediawiki does
+
Use the monobook that resembles to mediawiki
** download the monobook template from http://www.dokuwiki.org/template:monobook, as of 2012-01-06 this went like:
+
* download the monobook template from http://www.dokuwiki.org/template:monobook, as of 2012-01-06 this went like:
 
  lib/tpl # wget --no-check-certificate http://andreas-haerter.com/downloads/dokuwiki-template-monobook/latest-update
 
  lib/tpl # wget --no-check-certificate http://andreas-haerter.com/downloads/dokuwiki-template-monobook/latest-update
** extract it to lib/tpl
+
* extract it to lib/tpl
 
  lib/tpl # tar xvf 2011-12-10_monobook-update.tar.gz  
 
  lib/tpl # tar xvf 2011-12-10_monobook-update.tar.gz  
** rename it to default
+
* rename it to default
** set admin -> Configuration Settings -> Load 'monobook/user/user.js'
+
lib/tpl # mv default/ default-save
** adapt :wiki:navigation to contain
+
lib/tpl # mv monobook/ default
 +
* set admin -> Configuration Settings -> Load 'monobook/user/user.js'
 +
* adapt :wiki:navigation to contain
 
  * <nowiki>[[:start]]</nowiki>
 
  * <nowiki>[[:start]]</nowiki>
 
  * [[http://''yourhost''/dokuwiki/doku.php?do=recent|Recent Changes]]
 
  * [[http://''yourhost''/dokuwiki/doku.php?do=recent|Recent Changes]]

Revision as of 08:02, 6 January 2012

DokuWiki is a wiki that stores data in plain files and to priviledge distinct users for viewing articles.

Website

DokuWiki's website is http://www.dokuwiki.org/

Installing

This example shows how to install dokuwiki on your local computer. It has been tested with SUSE Linux 11.2-12.1.

You will need a running php-enabled http service, open a console and enter:

yast -i apache2 apache2-mod_php5 <html><acronym title="this package will allow plugin manager to extract plugins">php5_zlib</acronym></html>
/etc/init.d/apache2 start

Then download the dokuwiki package and unpack it to /srv/www/htdocs/dokuwiki.

cp Downloads/dokuwiki-2011-05-25a.tgz /srv/www/htdocs
cd /srv/www/htdocs
tar xvzf dokuwiki-*
mv dokuwiki-* dokuwiki

Change the owner of the directories to the web server:

chown -R wwwrun:www dokuwiki

Then surf to http://localhost/dokuwiki/install.php

TroubleShooting

If you get an error message like this:

{DOCUMENT_ROOT}/dokuwiki/data/pages is not writable by DokuWiki. You need to fix the permission settings of this directory!

First make sure you know DOCUMENT_ROOT, let's assume it is /srv/www/htdocs. Then do a

chmod -R 777 /srv/www/htdocs

If this does not help, you may have safe_mode turned on. You can find this out with the command

grep -ir "safe_mode" /etc/apache2/*

In this case, apache only reads files that its user owns. Solution can be to chown all files to the user apache is running under. In one case, under Ubuntu, the solution was:

chown -R sw-cp-server:crontab /var/www/vhosts/default/htdocs/dokuwiki/data/

Redirect

To make what mediawiki calls a redirect, use the goto plugin: http://www.dokuwiki.org/plugin:goto

Hints

make it similar to mediawiki

template

Use the monobook that resembles to mediawiki

lib/tpl # wget --no-check-certificate http://andreas-haerter.com/downloads/dokuwiki-template-monobook/latest-update
  • extract it to lib/tpl
lib/tpl # tar xvf 2011-12-10_monobook-update.tar.gz 
  • rename it to default
lib/tpl # mv default/ default-save
lib/tpl # mv monobook/ default
  • set admin -> Configuration Settings -> Load 'monobook/user/user.js'
  • adapt :wiki:navigation to contain
* [[:start]]
* [[http://yourhost/dokuwiki/doku.php?do=recent|Recent Changes]]
* [[http://yourhost/dokuwiki/doku.php?id=wiki&do=admin&page=statistics|Statistics]]

syntax

URL rewriting

Want a pretty URL like www.foo.com/products instead of www.foo.com/doku.php?id=products?

See http://www.dokuwiki.org/rewrite

pcre

There are a lot of issues regarding pcre. One is that you may not be able to log in if you have not compiled pcre with the option --enable-utf8. So, here is how to compile pcre to work with dokuwiki:

./configure --enable-utf8 && make -j8 && make install

TroubleShooting

Plugin cannot be unpacked

Symptom:

The plugin manager was unable to decompress the downloaded file. This maybe as a result of a bad download, in which case you should try again; or the compression format may be unknown, in which case you will need to download and install the plugin manually.

Solution: Install the zlib package for php, e.g. php5-zlib

See also