Ceci est une ancienne révision du document !


DokuWiki

Description de l'installation et de la configuration de ce Wiki.

Les principaux avantages de dokuwiki sont :

  • une installation simple pour avoir un wiki fonctionnel
  • le support de plugins permettant d'augmenter les fonctionnalités
  • le support de template permettant la personnalisation complète de l'interface
  • l'ensemble des données sont stockées en fichiers texte permettant leur accès même en cas de problème du serveur web.

Pour choisir le wiki qui vous convient, allez faire un tour sur http://www.wikimatrix.org.

Cette page décrit l'installation et la personnalisation de DokuWiki, de nombreuses parties sont optionnelles ou réalisables ultérieurement.

Installation

Sécurité

Plugins

Templates

Authentification LDAP

Astuces

Patch de sécurité

Ce patch permet de masquer complètement les sections inaccessibles, par défaut même si il n'est pas possible de visualiser les pages, il possible de vérifier leur existence et leur titre.

wiki:/opt/wiki# patch -p 1 < /root/doku_hide.patch
patching file inc/common.php
patching file inc/parser/xhtml.php
patching file inc/parserutils.php
patching file inc/template.php
wiki:/opt/wiki#

Remarque : le contenu des pages est caché par défaut, l'affichage des liens d'une page dépend de la personne qui a déclenché la génération de la page.

Astuce : si les droits de lecture sont appliqués sur le wiki complet, alors l'utilisateur peut savoir si un répertoire existe ou non. Pour éviter cela, il suffit de n'autoriser en lecture que les répertoires autorisés.

Remarque 2 : ne pas oublier d'activer “sneaky_index” pour sécuriser l'index.

Détails des failles corrigées

  • inc/parser/xhtml.php : dans le contenu d'une page, les liens internes révèlent si la page existe à cause du style utilisé
  • inc/parserutils.php : lorsque useheading est à 1, les références vers une page interdite révèlent le nom de la page (dans le titre, dans youarehere et dans le contenu des pages)
  • inc/template.php : lorsque youarehere est activé, le style des éléments du chemin révèlent si ils existent
  • inc/common.php : breadcrumb - n'ajoute pas la page à la liste si l'accès est interdit

Recréer l'index de recherche

Il peut être parfois nécessaire de regénérer l'index de recherche, par exemple après une migration. Pour cela il existe un outils en ligne de commande nommé indexer.php.
Pour l'utiliser il faut avoir php en ligne de commande installé (paquet php5-cli).

/opt/dokuwiki/bin# su www-data
/opt/dokuwiki/bin$ php indexer.php
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#

Ajouter la licence Creative Commons en pieds de page

Le pieds de page est par défaut dans /usr/share/dokuwiki/lib/tpl/default/footer.html Vous pouvez le modifier, par exemple pour activer l'image “cc” en bas, il faut ajouter :

  <a target="_blank" href="http://creativecommons.org/licenses/by-nc-sa/2.0/" rel="license" title="Creative Commons License"><img src="<?=DOKU_TPL?>images/button-cc.gif" width="80" height="15" alt="Creative Commons License" border="0" /></a>

Créer un Index Sitemap

L'index Sitemap permet d'indexer complètement le wiki sous Google.

Pour le créer il faut :

  • créer le fichier sitemap.xml.gz avec des droits d'écriture
# cd /opt/dokuwiki
/opt/dokuwiki# touch sitemap.xml.gz
/opt/dokuwiki# chown www-data sitemap.xml.gz
/opt/dokuwiki#
  • activer la génération du fichier dans /etc/dokuwiki/local.php :
$conf['sitemap']     = 1;                //Create a google sitemap? How often? In days.

Le fichier http://www.bouthors.fr/wiki/sitemap.xml.gz est ensuite généré par dokuwiki.

Backup

Avec le paquet debian

  • /etc/dokuwiki/apache.conf
  • /etc/dokuwiki/local.php
  • /usr/share/dokuwiki/lib/tpl/default/footer.html
  • /var/lib/dokuwiki/

Avec une installation manuelle :

  • /opt/dokuwiki

Links

linux/dokuwiki.1294260378.txt.gz · Dernière modification: 2011/01/05 21:46 par matthieu
Recent changes RSS feed Debian Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki