Differences

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

--- informatique:logiciels:dokuwiki [2012/09/13 15:28] – sauvegarde/restauration pteu
+++ 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
+  * [[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 suivant (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)
+  * ''/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>
 =====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 :
-  * dans /var/lib/dokuwiki/data, restaurer :
+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)
+    * les modifications (**attic** et **meta**)
     * les images (media)
-  * modifier /etc/dokuwiki/apache.conf ("Allow from all")
+  * modifier ''/etc/dokuwiki/apache.conf'' ("Allow from all")
-  * compléter le fichier /etc/dokuwiki/local.php (personnalisation de dokuwiki)
+  * compléter le fichier ''/etc/dokuwiki/local.php'' (personnalisation de dokuwiki)
-  * récupérer les utilisateurs du précédent wiki : fichier /etc/dokuwiki/users.auth.php
+  * récupérer les utilisateurs du précédent wiki : fichier ''/etc/dokuwiki/users.auth.php''
-  * régler les pb de droits : cf https://www.dokuwiki.org/install:permissions
+  * régler les problèmes de droits : cf https://www.dokuwiki.org/install:permissions
-<code>
+J'ai retenu cela :
-data/ and data/tmp/ directory: All files in and below these directories must be writable by the web process for DokuWiki to work.
+<code bash>
-    - lib/plugins/ directory: This directory must be writable by the web process for the plugin-Manager to work
+chown -r www-data /var/lib/dokuwiki/data
-    - lib/ directory: This directory must be readable by the public for style sheets to display. 755 works fine.
+chown www-data /var/lib/dokuwiki/lib/plugins
+</code>
+J'ajouterai qu'il faut aussi passer ces commandes :
+<code bash>
+# 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 :
+<code bash>
+vi /etc/apache2/conf.d/dokuwiki.conf
+ Alias      /dw                          /usr/share/dokuwiki/
 </code>
   * via l'interface web :
-    * réinstaller les plugins
+    * réinstaller les plugins : sidebar, note, cloud (pas searchindex car il fait disparaitre la toolbar d'édition de page)
     * faire une passe sur la configuration au cas ou (Admin/configuration en webUI)
@@ Line 55: / 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 70: / Line 113: @@
 }
 </code>
+====Disparition de la toolbar====
+  * voir https://www.dokuwiki.org/faq:toolbar
+====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 pages.
+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>
+# indexer.php
+#OPTIONS
+#      -h, --help     show this help and exit
+#      -c, --clear    clear the index before updating
+#      -q, --quiet    don't produce any output
+cd /usr/share/dokuwiki/bin/
+sudo -u www-data php indexer.php -c
+ [..]
+ informatique:os:ubuntu... Indexer: finished
+ done.
+ [..]
+</code>
+source : https://www.dokuwiki.org/cli#indexerphp