{{tag>en en:linux en:server en:web en:wiki}} 
====== DokuWiki ======
Dokuwiki is one of the best open source wiki.\\
You will find here how to install it and configure a wiki similar to this site.

The main features of Dokuwiki are :
  * an easy install to get a running wiki
  * the ability to add new features with plugins
  * template support to customize the look & feel
  * all datas are saved as files, so you still have access to them if your web server isn't working.

If you need help to choose with wiki suits you, check http://www.wikimatrix.org.

This page descibes how to install and customize Dokuwiki, most parts are optional.

:!: Last updated for version 2011-05-25 "Rincewind"

===== Installation =====
To understand how to install a brand new Dokuwiki, look at [[en:linux:dokuwiki:install]].

===== Security =====
Dokuwiki allows to define access rights on the different pages, for more details, look at [[en:linux:dokuwiki:secu]].

===== Plugins =====
Plugins are a good way to improve features, like multilingual support or wysiwyg edition.\\
The plugins I use are described here : [[en:linux:dokuwiki:plugins]].

===== Templates =====
The template system allows to easily change the look and feel of the wiki, [[en:linux:dokuwiki:templates]] explains how to install the template of this website.

===== LDAP Authentication =====
Look at [[en:linux:dokuwiki:ldap]]

===== Hints and tips =====
==== Regenerate the search index ====
You may need to regenerate the search index, for example after a migration. There is a command line for that : indexer.php.\\
To use it, you need the cli of php (package php5-cli).

<code>
/opt/dokuwiki/bin# su www-data
/opt/dokuwiki/bin$ php indexer.php -c
Searching pages... 96 pages found.
cuisine:caramelbeurresale... done.
cuisine:crepes... done.
cuisine:start... done.
cuisine:tatin... done.
...
/opt/dokuwiki/bin$ exit
exit
/opt/dokuwiki/bin#
</code>

==== Create the sitemap ====
The Sitemap index is read by Google to index the website.

To enable it, you need to change the "sitemap" option to 1

The sitemap file is available with the path /wiki/doku.php?do=sitemap, example : http://www.bouthors.fr/wiki/doku.php?do=sitemap.

===== Backup =====
List of files to backup.

With an install from debian repository :
  * /etc/dokuwiki/apache.conf
  * /etc/dokuwiki/local.php
  * /usr/share/dokuwiki/lib/tpl/default/footer.html
  * /var/lib/dokuwiki/

With a manual install for sources :
  * /opt/dokuwiki

===== Links =====
  * http://wiki.splitbrain.org/wiki:dokuwiki
  * http://wiki.splitbrain.org/wiki:sitemap