floss:dokuwiki

Ceci est une ancienne révision du document !


DokuWiki

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

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
    • 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 {} \;

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

  • 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
  • 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 {} \;
  • À classer :
    • pandoc, conversions,…
  • travail collaboratif
    • includes
Ce site web utilise des cookies. En utilisant le site Web, vous acceptez le stockage de cookies sur votre ordinateur. Vous reconnaissez également que vous avez lu et compris notre politique de confidentialité. Si vous n'êtes pas d'accord, quittez le site.En savoir plus
  • floss/dokuwiki.1578559514.txt.gz
  • Dernière modification : 2020/01/09 09:45
  • de villersd