Table des matières

Dokuwiki : un wiki opensource sans base de données

Pré-requis

  1. Avoir installé php,php-gd,php-xml ou 

    ...@...:~$ sudo apt install {php,php-{gd,xml}}

    Remarque pour PHP 7 :
    Pour les plugins qui donnent des erreurs, éditez le fichier lib/plugins/<plugin>/syntax.php pour le modifier comme indiqué dans les messages d'erreur :

    • remplacez tous les &$renderer par Doku_Renderer $renderer
    • remplacez tous les &$handler par Doku_Handler $handler
  2. Avoir installé Java, voir Java, un langage multi-plateformes
  3. Avoir mis en place les liens interwiki, en particulier les liens apt: (cf. Configuration)
  4. Avoir désactivé le redimensionnement des icônes (cf. Désactiver le redimensionnement des icônes)

Installation

  1. DokuWiki Downloader
  2. Dokuwiki : Mise à niveau

Méthode toujours valable :

  1. Allez sur la page https://download.dokuwiki.org/
  2. Cliquez sur Download ou personnalisez le téléchargement en cochant les options voulues puis cliquez sur Start Download en bas.
  3. Enregistrez le fichier .tgz où vous voulez (par ex. dans le répertoire Téléchargements)
  4. Décompressez l'archive de distribution → répertoire dokuwiki-xxxxxxxxxxxxxx/
  5. Lancez Filezilla
    1. Ouvrez votre serveur
    2. Localement, ouvrez le répertoire dokuwiki-xxxxxxxxxxxxxx/
    3. et envoyez tout le répertoire dokuwiki sur votre espace Web.
  6. Ouvrez la page de votre futur site https://monsite.tld/install.php
    1. Choisissez votre langue: : fr, puis Mettre à jour
    2. Nom du wiki : Donnez le titre de votre Wiki
    3. Cochez Activer le contrôle d'accès (recommandé)
    4. Super-utilisateur : son nom d'user
    5. Nom : Son nom véritable
    6. Adresse de courriel : Son courriel
    7. Mot de passe : Son mot de passe, et confirmez-le
    8. Politique de contrôle d'accès initiale : choisissez le degré de fermeture du wiki
    9. Ne cochez pas Permettre aux utilisateurs de s'enregistrer eux-mêmes. (sauf si vous le voulez…)
    10. Veuillez choisir la licence sous laquelle vous souhaitez placer votre contenu : : Cochez la licence désirée

      Si le message d'erreur suivant apparaît :erreur de l'installateur au démarrage, voir la page http://www.dokuwiki.org/install:permissions. Les réglages à appliquer sont, en se plaçant dans le répertoire web (/var/www) :

      ...@...:~ $ cd /var/www
$ sudo chgrp -R www-data doc/
$ sudo chmod -R g+w doc/

      groupe www-data pour tout le wiki
      en écriture pour le groupe

  1. Sécurisation :
    1. sous Apache 2, activez les .htaccess : Créez avec les droits d'administration le fichier /etc/apache2/sites-available/monsite.conf pour y écrire :
      /etc/apache2/sites-available/monsite.conf
          <Directory /var/www/>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
    </Directory>
    2. Autre méthode : éditez avec les droits d'administration le fichier default pour le modifier comme ceci :
      • dans la définition VirtualHost, utiliser la directive LocationMatch en ajoutant juste en dessous de la directive Directory :
        <Directory /var/www/dokuwiki>
    order deny,allow
    allow from all
</Directory>

<LocationMatch "/dokuwiki/(data|conf|bin|inc)/">
    order allow,deny
    deny from all
    satisfy all
</LocationMatch>
  2. Mise à jour :
    1. Le mieux est d'utiliser le plugin
    2. Méthode manuelle, en local sur le serveur :
      1. Faites une sauvegarde complète du wiki :

        ...@...:~ $ cp -a /path/to/wiki/ /path/to/wikibackup

      2. Téléchargez dans le répertoire de dokuwiki la nouvelle version trouvée sur http://splitbrain.org/go/dokuwiki :

        ...@...:~ $ cd /path/to/wiki/
...@...:~ $ wget http://.../dokuwiki-xxxx-xx-xx.tgz

      3. Extrayez-le à la racine de dokuwiki en écrasant les fichiers existants :

        ...@...:~ $ tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1

      4. Effacez l'archive téléchargée :

        ...@...:~ $ rm dokuwiki-xxxx-xx-xx.tgz

      5. Effacez install.php :

        ...@...:~ $ rm /path/to/wiki/install.php

      6. Effacez les anciens fichiers qui ne sont plus utilisés (Liste de ces fichiers sur http://www.dokuwiki.org/install:upgrade) :
        1. copiez/collez la liste dans un fichier texte sur le système (par exemple /tmp/removeold.txt)
        2. puis lancez :

          ...@...:~ $ grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fd

          Seuls les fichiers existants sont effacés.

      7. Réglez les permissions, sans oublier les éventuels nouveaux répertoires sous data/
      8. Comparez votre .htaccess avec le .htaccess.dist fourni pour les changements nécessaires
      9. Mettez à jour les plugins et les templates
      10. Effacez le cache en faisant un touch de conf/local.php pour sauver la configuration
      11. Mettre à jour l'index si besoin
      12. Ces étapes sont sans danger tant qu'on ne change que les versions locales des fichiers de configuration (comme conf/local.php au lieu de conf/dokuwiki.php).
        DokuWiki ne remplacera pas ces fichiers locaux.
        Si on utilise toujours le config manager, on est en sécurité car il sauve toujours dans local.php.
        De même, les données utilisateur et l'information ACL ne seront jamais remplacées car DokuWiki ne fournit que des exemples (avec une extension .dist).

Configuration

  1. Paramètres de Dokuwiki
  2. Raccourcis interwiki
  3. Thèmes :
    1. Dokuwiki : Thème Monobook
    2. Dokuwiki : Thème vector
  4. Ajouter ses propres boutons à la barre d'outils

Utilisation

  1. Greffons intéressants : Copiez l'adresse du lien (clic droit dessus), collez-la dans la case URL du gestionnaire de plugins et cliquez sur Télécharger
    1. a2s : Diagramme ASCII
    2. addnewpage : Ajouter une nouvelle page
    3. alphalist2 : affiche par ordre alphabétique les listes ordonnées ou non
    4. backup : Outil de sauvegarde pour DokuWiki
    5. bookcreator : créer un livre (PDF, ODT ou text)
    6. captcha : utilise une vérification par image (CAPTCHA) pour déjouer les spambots
    7. charpicker : modifie la liste des caractères dans le sélecteur de caractères spéciaux de DokuWiki
    8. cli : plugin Command Line Interface pour Dokuwiki
    9. cloud : nuage des mots les plus fréquemment utilisés
    10. color : écrit du texte en couleur
    11. confmanager : gérer divers fichiers .conf
    12. copypage : crée une nouvelle page à partir d'une page existante
    13. custombuttons : ajout de boutons personnalisés à la barre d'outils
    14. definitionlist : syntaxe pour les listes de définitions
    15. diagram : construit des diagrammes
    16. diffpreview : ajoute un bouton pour visualiser les différences en mode édition
    17. ditaa : convertit en image les diagrammes de flux ASCII
    18. dropfiles : permet de télécharger des fichiers par drang'n'drop dans la zone d'édition d'une page
    19. dw2pdf : Exporter du contenu DokuWiki au format PDF
    20. edittable : édition de tableaux dans Dokuwiki
    21. folded : Sections de page repliables
    22. gallery : crée une galerie d'images à partir d'un espace de nom ou d'un RSS
    23. hidden : cache ou montre des détails
    24. keyboard : Marque le texte de Dokuwiki comme des touches du clavier
    25. loglog : enregistre les connexions, les déconnexions et l'activité de l'administrateur dans un fichier
    26. mathpublish : ajoute des formules mathématiques : Voir https://www.dokuwiki.org/plugin:mathpublish
    27. move : déplace et renomme des pages et des fichiers multimédias
    28. multiorphan : GUI pour trouver toutes sortes de pages et de médias orphelins ou recherchés
    29. nbsp : espace insécable
    30. stale : "touche" les fichiers de configuration (successeur de toucher)
    31. odt : Export OpenOffice.org/LibreOffice.org
    32. pagelist : liste les pages dans un format agréable
    33. qna : FAQ
    34. sortablejs : permet de trier les tableaux par colonnes
    35. subnumberlist
    36. sync : synchroniser des dokuwikis
    37. tab : syntaxe spéciale pour les tabulations
    38. tablecalc : faire des calculs dans une table comme avec Excel
    39. templatepagename : pages de modèle c_template et i_template
    40. tag : assigner des tags aux pages de Dokuwiki
    41. toolbox : ajoute divers outils à la barre d'outils de l'éditeur
    42. translate : un plugin de traduction qui n'exige pas que le nom de la page soit le même dans toutes les langues
    43. translation : configuration facile d'un wiki multi-langue
    44. typography : capacités de mise en page
    45. upgrade : Mettez à jour votre DokuWiki en quelques clics depuis l'interface d'administration
    46. vshare : intégration de vidéos provenant de divers sites de partage de vidéos
    47. wrap : conteneurs
    48. wrapadd : styles supplémentaires pour le plugin WRAP
    49. yalist : Plugin de liste universel simple

  1. Plugin Site Export
  2. Text (exportation / rendu)
  3. Numérotation automatique avec des compteurs CSS
  4. Cacherevisionseraser : Nettoyeur du cache et des révisions
  5. bureaucracy : Voir https://www.dokuwiki.org/plugin:bureaucracy
  6. doodle2 : Voir https://www.dokuwiki.org/plugin:doodle2
  7. French Typography : Voir https://www.dokuwiki.org/plugin:french_typography
  8. odt2dw : Voir https://www.dokuwiki.org/plugin:odt2dw
  9. translation : Voir https://www.dokuwiki.org/plugin:translation ; se configure dans les paramètres de configuration (administration)

  1. extlist : syntaxe étendue pour les listes FIXME : modifie les réglages des listes !!!

Le greffon jquery est maintenant intégré à Dokuwiki. Il ne faut surtout pas l'installer car cela provoque des problèmes comme la disparition des boutons de l'éditeur !

Greffons qui ne marchent plus et font disparaître l'affichage

Note avec PHP 7 :

Pour les plugins qui donnent des erreurs, éditez le fichier lib/plugins/<plugin>/syntax.php pour le modifier comme indiqué dans les messages d'erreur :

  • remplacez tous les &$renderer par Doku_Renderer $renderer
  • remplacez tous les &$handler par Doku_Handler $handler
  1. Tutoriels :
    1. Désactiver le redimensionnement des icônes
    2. Créer une page de fichiers à télécharger
    3. Créer une ferme de dokuwikis : Installez un dokuwiki sur votre serveur en le nommant fermier

Désinstallation

Sur le serveur, effacez le répertoire racine du Dokuwiki.

Voir aussi

Basé sur « Dokuwiki - C'est mieux quand c'est simple » par doc.ubuntu-fr.org.