Dokuwiki

Anne dokuwiki web

Le wiki utilisé ici. J’ai utilisé dokuwiki pendant de nombreuses années avant de passer à hugo.

Installation

Téléchargement

mkdir TestDokuwiki
cd TestDokuwiki/
wget https://github.com/splitbrain/dokuwiki/archive/stable.tar.gz
tar -xzvf stable.tar.gz --strip-components=1
rm -f stable.tar.gz

Permission

Il faut s’assurer que le serveur ait bien les droits en écriture sur les différents fichiers, et par ailleurs, on veut aussi pouvoir continuer à éditer les fichiers en dehors du wiki. On va donc choisir de garder l’utilisateur (anne ici) comme propriétaire, et www-data comme groupe, avec un droit d'écriture pour le groupe.

chgrp -R www-data .
chmod -R g+rw data
chmod g+rw conf
chmod -R g+rw lib

Attention, lors de la création manuelle de nouveaux fichiers, il faudra penser à ajuster les droits.

Installation

  • Ouvrir https://anne.pacalet.fr/TestDokuwiki/install.php.
  • configurer
  • rm -f install.php

Créer une première page start comme recommandé sur la page d’accueil pour vérifier que tout va bien.

Déplacement

On va maintenant déplacer les fichiers qui n’ont pas besoin d'être accessibles hors de la racine du site web comme recommandé dans Move Directories out of DocRoot.

cd
mkdir Dokuwiki
cd Dokuwiki
mv ../public_html/TestDokuwiki/data .
mv ../public_html/TestDokuwiki/conf .
mv ../public_html/TestDokuwiki/bin .
vim conf/local.php

Ajouter la ligne :

$conf['savedir'] = '/home/anne/Dokuwiki/data';

Ajouter le fichier : inc/preload.php (dans TestDokuwiki) :

<?php
// DO NOT use a closing php tag. This causes a problem with the feeds,
// among other things. For more information on this issue, please see:w
// http://www.dokuwiki.org/devel:coding_style#php_closing_tags

define('DOKU_CONF','/home/anne/Dokuwiki/conf/');

Comme les fichiers créés par l’interface appartiennent à www-data, si je veux les éditer en dehors du wiki, il faut changer les droits Directory creation mode et File creation mode dans l’interface d’administration ou dans le fichier conf/dokuwiki.php.

Plusieurs wiki

Dans la documentation, on trouve comment installer une ferme de wiki. Mais je pense que ce n’est intéressant que lorsqu’on en a un grand nombre. Pour avoir juste quelques wiki, je pense qu’il est plus facile de simplement faire plusieurs installations, ce qui de plus les rend réellement indépendants.

Cache

Si on a besoin de certaines pages se recalcule à chaque fois plutôt que d’utiliser la version dans le cache, il faut y ajouter la ligne :

~~ NOCACHE ~~

Si on veut forcer le recalcul d’une page, il faut ajouter purge=true à son url, par exemple :

https://anne.pacalet.fr/Notes/doku.php?id=start&purge=true

Plugins

Txt2tags

Indispensable pour moi, le format txt2tags. C’est existence du plugin txt2tags qui m’a convaincu de tester dokuwiki !

cd TestDokuwiki/lib/plugins/
wget https://bitbucket.org/farvardin/txt2tags-tools/downloads/txt2tags_dokuwiki.zip
unzip txt2tags_dokuwiki.zip
rm -f txt2tags_dokuwiki.zip

Et c’est tout. Après cette première étape, les fichiers .t2t.txt doivent être géré correctement. Mais pour ne pas avoir à nommer les fichiers .t2t.txt (ou créer des pages nommées .t2t depuis le wiki) il faut éditer le fichier action.php du plugin, et commenter la ligne :

if(substr($ID,-4) != '.t2t') return true;

En fait, ce que ça fait, c’est que ça ajoute des balises < t2t> et </ t2t> autour du texte. Cela signifie que si on veut profiter aussi de possibilité de la syntaxe dokuwiki, comme la coloration syntaxique du code par exemple, il suffit de faire :

</ t2t><code bash>
  $ cmd bash
</code>< t2t>

et hop !

Attention, du coup, si on veut utiliser les boutons de l'éditeur du wiki, il faut la configurer (cf. la doc du plugin). Moi, je n’en ai pas besoin, car j’utilise vim, même depuis firefox…

Il faut noter qu’on peut modifier la configuration pour ajouter des action preprop/postproc dans le fichier lib/plugins/txt2tags/config.t2t, mais il faudrait aussi y ajouter un css associé si on veut faire des boites ou des choses du genre (TODO).

Upgrade

Le plugin upgrade permet de faire la mise à jour à partir de la page d’administration. Attention à quand même faire un backup avant de commencer.

Si l’avertissement continue à s’afficher même quand la mise à jour a été faire, voir là. En résumé : attendre un jour, ou faire touch ./doku.php ou effacer data/cache/messages.txt. Attention : si le répertoire data a été déplacé comme expliqué ci-dessus, c’est là qu’il faut effacer ce fichier.

Récupérer éventuellement les modifications de style faites dans lib/tpl/dokuwiki/, c’est-à-dire faire un diff avec l’ancienne version, et propager les éventuelles modifications dans son style à soi (voir ci-dessous).

Autres

  • plugin:tag
  • plugin:cloud
    • pensez à remettre mes couleurs dans lib/plugins/cloud/style.css lors d’une mise à jour.

Styles (template)

Il y a vraiment beaucoup de choix de thèmes, mais attention, il y en a qui sont obsolètes. Pour en essayer un, il faut utiliser le Gestionnaire d’extension dans l’interface d’administration pour chercher et installer de nouveaux thèmes. Après, il faut aller dans Paramètre de configuration pour choisir le thème à utiliser parmi ceux installés.

  • template:dokuwiki : le thème de base qui n’est pas très sexy, mais qui est bien compatible avec les toutes dernière fonctionnalité. On peut ajuster un peu le style dans lib/tpl/dokuwiki/style.ini.
  • template:starter : n’est pas vraiment un thème à utiliser, mais plutôt un modèle de départ si on veut développer son propre thème.

Pour ma part, je suis partie de template:dokuwiki, et j’ai copié lib/tpl/dokuwiki/ sous un autre nom pour y faire mes modifications.

Images

Les fichiers media/wiki/favicon.ico et media/wiki/logo.png sont utilisés (au moins par le template dokuwiki en tout cas).

Voir aussi :

Table des matières
Tags
Dernières notes