Both sides previous revisionPrevious revisionNext revision | Previous revision |
informatique:logiciels:dokuwiki [2014/04/03 15:42] – relecture pteu | informatique:logiciels:dokuwiki [2021/12/13 15:59] (current) – [Fichier de conf en lecture seule] pteu |
---|
{{http://www.dokuwiki.org/_media/wiki:dokuwiki-128.png }} | {{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). |
| |
| |
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 : | 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: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 | * [[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: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: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 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: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 | * [[http://wiki.splitbrain.org/plugin:tag|tag]] permet d'implémenter des tags pour "catégoriser" les pages |
| |
| |
=====Sauvegarde du wiki===== | =====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 la 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> | <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> | </code> |
| |
chown www-data /etc/dokuwiki/local.php | chown www-data /etc/dokuwiki/local.php |
</code> | </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 : | Et dans mon cas je dois modifier l'alias : |
Lors de la restauration de mon wiki j'ai eu le message suivant lorsque j'ai édité les paramètres : | Lors de la restauration de mon wiki j'ai eu le message suivant lorsque j'ai édité les paramètres : |
| |
<note>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.</note> | <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 le fichier suivant est accessible en écriture au serveur web : | |
| 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> | <code bash> |
ll /etc/dokuwiki/local.php | ll /etc/dokuwiki/local.php |
</code> | </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==== | ====Problème de présentation==== |
| |
# -q, --quiet don't produce any output | # -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 | informatique:os:ubuntu... Indexer: finished |