DokuWiki

DokuWiki

Créateur de livres
Ajouter cette page à votre livre

Créateur de livres
Retirer cette page de votre livre

Ceci est une ancienne révision du document !

fr:DokuWiki
DokuWiki
https://www.dokuwiki.org/dokuwiki : site web officiel
https://github.com/splitbrain/dokuwiki gitHub repository

A côté d’un blog (tel que WordPress), utile pour créer un site “vitrine” composé“ essentiellement de pages statiques et d’articles pouvant être commentés, il est intéressant de proposer des pages d’informations dont le contenu est susceptible de s’enrichir régulièrement.

Il est aussi courant de partager en lecture certains documents de manière limitée, avec des personnes ou des groupes de personnes contrôlés, ou de les partager dans un but collaboratif avec des permissions supplémentaires d’écriture. Lzq (modifications et ajouts de pages, de “répertoires”.

Si à cela vous ajoutez les souhaits d’une présentation uniforme, d’un langage de formatage simplifié mais puissant, la nécessité de conserver les versions successives d’un travail, de les organiser dans une arborescence, alors le logiciel à installer est un wiki, et le logiciel DokuWiki est particulièrement indiqué, pour les raisons suivantes :

c'est un logiciel libre éprouvé, très suivi et tenu à jour par une communauté importante
l'utilisation se fait dans un navigateur web
le langage de balise est simple, et l'environnement propose un éditeur avec barre d’outils
il n'exige pas de connaissance préalable
aucune base de données n’est nécessaire
l'outil collaboratif est éprouvé, et utilisé par des sites web reconnus
la gestion des droits d’accès par utilisateurs ou groupes (ACL) est très évoluée
DokuWiki et des sites tiers proposent de nombreuses extension (plugins) et thèmes (templates)
DokuWiki conserve un historique des versions et possède un moteur d'indexation et de recherche efficace

Documentation :
- DokuWiki Installation
- https://www.dokuwiki.org/wiki:dokuwiki

Puisqu’il n’y a pas de base de données, l’installation est plus simple que celle de la plupart des CMS. A partir d’une fenêtre de terminal (Linux, Mac), ou d’un client ssh comme PuTTY (Windows) :

Connexion et identification sur le serveur : ssh username@dns or username@ip_address (ou via les paramètres de PuTTY);
se placer dans le répertoire web : cd /var/www/html
créer un répertoire pour le wiki : sudo mkdir wiki00
s’y placer : cd wiki00
télécharger la dernière version de DokuWiki : sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
décompresser l’archive : sudo tar -xzvf dokuwiki-stable.tgz –strip-components=1
effacer l’archive : sudo rm dokuwiki-stable.tgz
owner & permissions (https://www.dokuwiki.org/install:permissions#unix)
- sudo chown -R www-data:www-data /var/www/html/wiki00
- cd /var/www/html/wiki00 (si on n'y était pas)
- fichiers : sudo find . ! -type d -exec chmod 660 {} \;
- répertoires : sudo find . -type d -exec chmod 770 {} \;

~~mettre tous les fichiers récursivement en accès rw pour owner et groupe (nummat) : find . -type f -exec chmod 0660 {} \;~~
mettre tous les dossiers récursivement en accès rwx pour owner (nummat) et rws pour le groupe (nummat), et en pré-attribuant ce groupe pour les futures créations de répertoires par le serveur (set guid actif) : find . -type d -exec chmod 2770 {} \;

on peut à présent régler la configuration de base de DokuWiki via un navigateur web, en pointant sur http://dns/wiki00/install.php ou http://ip_address/wiki00/install.php. Documentation spécifique : https://www.dokuwiki.org/installer pour la description des options :
- Wiki Name
- Enable ACL
- Superuser
- Full Name
- E-Mail
- Password
- Once Again
- Initial ACL policy
- Allow users to register themselves
sudo rm install.php (effacement du script d'installation)

Une fois tout cela accompli, le wiki est pré-configuré et (presque) opérationnel ! Après l'initialisation, il convient d’effectuer rapidement quelques réglages de la configuration. Pour y arriver, il faut tout d’abord se connecter, et ensuite se diriger vers le menu d’administration. Avec le canevas de présentation (template) par défaut, on trouvera en bas de la page les boutons de connexion et d’administration. Choisissez alors les “Paramètres de configuration”. Une fois sur la page vous pourrez effectuer de nombreux réglages, dont ceux-ci qui me paraissent très utiles, voire indispensables :

choisir la langue de l’interface language fr
mode de création des répertoires : choisir 02770 (au lieu de 0755) (set gid, cf. http://www.dokuwiki.org/config:dmode)
mode de création des fichiers : choisir 0660 (au lieu de 0644)
Dans les paramètres d’authentification, rubrique “Actions à désactiver dans DokuWiki”, désactiver (cocher) l’action “s’enregistrer”, sauf si vous voulez permettre à n’importe quel quidam de s’inscrire et appartenir au groupe “user”
pour le délai avant indexation (paramètres anti-spam), vous pouvez vous contenter de 60*5 plutôt que 60*60*24*5, qui contraint à une attente de 24H après édition, avant que l’indexation par un robot de moteur de recherche ne redevienne possible
Si comme administrateur vous souhaitez être averti à chaque modification effectuée par un autre utilisateur, indiquez votre email derrière “Notifier les modifications à cette adresse de courriel” (paramètres d’édition)
ensuite, vous pouvez aussi activer l’abonnement aux pages, ce qui aura pour effet de générer un envoi par email notifiant la modification. Le délai peut être réglé par l’option suivante (“Délai après lequel les listes d’abonnement …”)
Mentionner dans ce dernier cas l’expéditeur des notifications par courriel du wiki (paramètres avancés)

Plus tard, notamment si vous ajoutez des extensions (plugins) possédant leurs propres paramètres de configuration, vous pourrez revenir sur ce menu d’administration !

message à l'installation : “It seems your data directory is not properly secured. Please read https://www.dokuwiki.org/security

sécurisation via apache2 https://www.dokuwiki.org/security#web_access_security sudo nano /etc/apache2/sites-available/default pour changer AllowOverride None en AllowOverride all pour /var/www et penser à faire un sudo service apache2 restart

Comment utiliser plusieurs instances de DokuWiki

en cas de migration, effacement de fichiers obsolètes : sudo grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf

réinstallation

cd /var/www puis effacement de l'éventuelle version antérieure : sudo rm -rf wiki
cd /home/dvillersadm copie d'une archive dokuwiki à réinstaller à cet emplacement
extraction par sudo tar -xzvf ./dokuwiki500299_2013-08-28_03:17:01.tar.gz
cd /home/dvillersadm/home/500299/public_html
sudo mv wiki /var/www puis cd /var/www
owner & permissions https://www.dokuwiki.org/install:permissions#unix
sudo chown -R www-data:www-data /var/www/wiki
cd /var/www/wiki
fichiers : sudo find . ! -type d -exec chmod 660 {} \;
répertoires : sudo find . -type d -exec chmod 770 {} \;