Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

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

Méthode toujours valable :

  1. Cliquez sur Download ou personnalisez le téléchargement en cochant les options voulues puis cliquez sur Start Download en bas.
  2. Enregistrez le fichier .tgz où vous voulez (par ex. dans le répertoire Téléchargements)
  3. Décompressez l'archive de distribution → répertoire dokuwiki-xxxxxxxxxxxxxx/
  4. 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.
  5. 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

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. subnumberlist

  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. 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