Differences

This shows you the differences between two versions of the page.

--- informatique:logiciels:dokuwiki [2013/10/14 20:45] – modification externe 127.0.0.1
+++ informatique:logiciels:dokuwiki [2021/12/13 15:59] (current) – [Fichier de conf en lecture seule] pteu
@@ Line 5: / Line 5: @@
 {{http://www.dokuwiki.org/_media/wiki:dokuwiki-128.png }}
-[[http://www.dokuwiki.org|Dokuwiki]] est un moteur de [[http://fr.wikipedia.org/wiki/Wiki|wiki]] sur lequel tourne ce site. Il est libre et a la particularité de ne pas se reposer sur une BDD de type MySQL ou PgSQL : il enregistre ses informations dans des fichiers. Ainsi il est facile de migrer le Wiki d'une machine à l'autre, avec un simple //copier/coller//.
+[[http://www.dokuwiki.org|Dokuwiki]] est un moteur de [[http://fr.wikipedia.org/wiki/Wiki|wiki]] sur lequel tourne ce site. Il est libre et a la particularité de ne pas se reposer sur une BDD de type MySQL ou PgSQL : il enregistre ses informations dans des fichiers. Ainsi il est facile de migrer le Wiki d'une machine à l'autre, avec un simple //copier/coller// (voir plus bas).
@@ Line 12: / Line 12: @@
 Dokuwiki est doté d'une [[http://www.dokuwiki.org/plugins|multitude de plugins]] afin d'ajouter des fonctionnalités au concept de base ; voici ceux que j'utilise :
   * [[http://wiki.splitbrain.org/plugin:cloud|cloud]] : permet d'afficher les mots les plus utilisés sous forme de nuage (similaire aux nuages de tags que l'on connait)
-  * [[http://wiki.splitbrain.org/plugin:discussion|discussion]] : permet d'ajouter un espace de commentaires sur chaque page, à l'instar des moteurs de blogs
   * [[http://wiki.splitbrain.org/plugin:note|note]] : permet de créer des notes (Note/Important/Tip/Warning) dans des cadres
+  * sidebar : (en fait c'est un thème) affiche le menu de gauche qui permet de lister et naviguer dans le site
+Et ceux que j'ai utilisés, PI :
+  * [[http://wiki.splitbrain.org/plugin:discussion|discussion]] : permet d'ajouter un espace de commentaires sur chaque page, à l'instar des moteurs de blogs
   * [[http://wiki.splitbrain.org/plugin:pagelist|pagelist]] : affiche un index des pages contenues dans un espace de nom (càd un répertoire)
   * [[http://wiki.splitbrain.org/plugin:pagemove|pagemove]] : outil pour facilement déplacer une page d'un répertoire à un autre
-  * [[http://wiki.splitbrain.org/plugin:searchindex|searchindex]] permet de créer et mettre à jour un index de mots-clé pour faire des recherches plus rapide sur le wiki. **NB : avec dokuwiki 2011-05-25a (le packet d'Ubuntu 12.04) ce plugin cause des erreurs javascript faisant disparaitre la toolbar d'édition de page.**
+  * [[http://wiki.splitbrain.org/plugin:searchindex|searchindex]] permet de créer et mettre à jour un index de mots-clé pour faire des recherches plus rapides sur le wiki. **NB : avec dokuwiki 2011-05-25a (le paquet d'Ubuntu 12.04) ce plugin cause des erreurs javascript faisant disparaitre la toolbar d'édition de page.**
   * [[http://wiki.splitbrain.org/plugin:tag|tag]] permet d'implémenter des tags pour "catégoriser" les pages
 =====Sauvegarde du wiki=====
-Comme dit plus haut, il est très simple de sauver un wiki ; pour cela il faut sauvegarder les dossiers suivants (valable avec Debian et Ubuntu) :
+Comme dit plus haut, il est très simple de sauver un wiki ; pour cela il faut sauvegarder les dossiers suivants (valable au moins avec Debian et Ubuntu) :
-  * ''/etc/dokuwiki'' qui contient le configuration
+  * ''/etc/dokuwiki'' qui contient la configuration (dokuwiki.php et local.php par exemple)
   * ''/usr/share/dokuwiki'' : racine (pour le serveur web)
-  * ''/var/lib/dokuwiki'' : qui contient toutes les données du wiki (les pages, l'historique des changements et les images)
+  * ''/var/lib/dokuwiki'' (data) : qui contient toutes les données du wiki : les pages, l'historique des changements (attic) et les images (media)
-On peut sauvegarder tout cela très facilement avec un :
+On peut sauvegarder tout cela très facilement dans une archive dans le répertoire /tmp avec un :
 <code bash>
-tar cjvf dokuwiki_`date +%Y-%m-%d`.tar.bz2 /etc/dokuwiki /usr/share/dokuwiki /var/lib/dokuwiki
+tar cjvf /tmp/dokuwiki_`date +%Y-%m-%d`.tar.bz2 /etc/dokuwiki /usr/share/dokuwiki /var/lib/dokuwiki
 </code>
@@ Line 34: / Line 37: @@
 =====Restauration du wiki=====
-Pour faire simple, il suffit de restaurer le zip de la sauvegarde ; mais dans la pratique il faut faire attention à ces aspects (attention les chemins sont ceux d'une distribution Debian/Ubuntu) :
+Pour faire simple, il suffit de restaurer le zip de la sauvegarde ; mais dans la pratique il faut faire attention aux aspects suivants (attention les chemins sont ceux d'une distribution Debian/Ubuntu) :
   * dans ''/var/lib/dokuwiki/data'', restaurer :
     * les pages (pages)
-    * les modifications (attic **et meta**)
+    * les modifications (**attic** et **meta**)
     * les images (media)
   * modifier ''/etc/dokuwiki/apache.conf'' ("Allow from all")
@@ Line 45: / Line 48: @@
 J'ai retenu cela :
 <code bash>
-chown www-data /var/lib/dokuwiki/data
+chown -r www-data /var/lib/dokuwiki/data
 chown www-data /var/lib/dokuwiki/lib/plugins
 </code>
-J'ajouterai qu'avec le package Ubuntu actuel (Version : 0.0.20110525a-2) il faut aussi passer ces commandes :
+J'ajouterai qu'il faut aussi passer ces commandes :
 <code bash>
-# les fichiers de conf doivent être writable par la webUI
+# les fichiers de conf doivent être modifiables par le serveur web
 chown www-data /etc/dokuwiki
 chown www-data /etc/dokuwiki/local.php
 </code>
+Qui permettent d'éviter le problème d'enregistrement des paramètres, dans le "Configuration Manager" :
+<WRAP center round important 80%>
+The settings file can not be updated, if this is unintentional, ensure the local settings file name and permissions are correct.
+</WRAP>
 Et dans mon cas je dois modifier l'alias :
@@ Line 69: / Line 77: @@
 =====Tips=====
+====Fichier de conf en lecture seule====
+Lors de la restauration de mon wiki j'ai eu le message suivant lorsque j'ai édité les paramètres :
+<WRAP center round info 60%>
+Le fichier des paramètres ne peut être modifié, si ceci n'est pas intentionnel, vérifiez que le nom et les droits du fichier sont corrects.
+</WRAP>
+Pas de possibilité de modifier les paramètres via le navigateur donc. Pour corriger cela, il faut vérifier que les fichiers suivants sont accessibles en écriture au serveur web (sous Debian, c'est l'utilisateur et le groupe **www-data**) : ''acl.auth.php'', ''local.php'' et ''users.auth.php''.
+Exemple :
+<code bash>
+ll /etc/dokuwiki/local.php
+-rw-r--r-- 1 www-data www-data   714 oct.  14 23:42 local.php
+</code>
+Le répertoire ''/etc/dokuwiki'' doit également être accessible en écriture à www-data :
+<code bash>
+chgrp www-data /etc/dokuwiki
+chmod g+w /etc/dokuwiki
+</code>
 ====Problème de présentation====
-Le plugin tag pose un problème de présentation avec le thème sidebar, car il ne positionne pas le "floating" avec les menus de droite (l'index des grands titres). Pour résoudre ce problème, il faut modifier la feuille de style CSS. Si on utilise le paquet ubuntu, le plus simple est de surcharger les styles dans le fichier idoine : ''/etc/dokuwiki/userstyle.css''
+Le plugin tag pose un problème de présentation avec le thème sidebar, car il ne positionne pas le "floating" avec les menus de droite (l'index des grands titres). Pour résoudre ce problème, il faut modifier la feuille de style CSS. Si on utilise le paquet Ubuntu, le plus simple est de surcharger les styles dans le fichier idoine : ''/etc/dokuwiki/userstyle.css''
 <code bash>
 vi /etc/dokuwiki/userstyle.css
@@ Line 91: / Line 120: @@
 ====Reconstruire l'index de recherche====
-La barre de recherche interne se base sur un index de mots qui est, normalement, construit au fur et à mesure que les pages sont visitées (via un include dans la page de votre template). Mais, pour certaines raisons (votre template ne comporte pas l'include de la fonction d'indexage, ou vous venez d'importer beaucoup de pages d'un autre wiki dans votre répertoire data), le recherche peut ne pas être pertinente faute d'indexage correct de ses page.
+La barre de recherche interne se base sur un index de mots qui est, normalement, construit au fur et à mesure que les pages sont visitées (via un include dans la page de votre template). Mais, pour certaines raisons (votre template ne comporte pas l'include de la fonction d'indexage, ou vous venez d'importer beaucoup de pages d'un autre wiki dans votre répertoire data), le recherche peut ne pas être pertinente faute d'indexage correct de ses pages.
-Le script php **indexer.php**, situé dans le répertoire ''bin/'' (''/usr/share/dokuwiki/bin'' sous Ubuntu), permet de réindexer votre wiki. Utilisation (vérifier au préalable que le client php CLI est installé, et que le fichier indexer.php est exécutable) :
+Le script php **indexer.php**, situé dans le répertoire ''bin/'' (''/usr/share/dokuwiki/bin'' sous Debian/Ubuntu), permet de réindexer votre wiki. Utilisation (vérifier au préalable que le client php CLI est installé, et que le fichier indexer.php est exécutable) :
 <code bash>
@@ Line 102: / Line 131: @@
 #      -q, --quiet    don't produce any output
-/usr/share/dokuwiki/bin/indexer.php -c
+cd /usr/share/dokuwiki/bin/
+sudo -u www-data php indexer.php -c
  [..]
  informatique:os:ubuntu... Indexer: finished