Dokuwiki : un wiki opensource sans base de données

Pré-requis

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 $rendererremplacez tous les &$handler par Doku_Handler $handlerAvoir installé Java, voir Java, un langage multi-plateformesAvoir mis en place les liens interwiki, en particulier les liens apt: (cf. Configuration)Avoir désactivé le redimensionnement des icônes (cf. Désactiver le redimensionnement des icônes)

Installation

DokuWiki DownloaderDokuwiki : Mise à niveauMéthode toujours valable :

Allez sur la page https://download.dokuwiki.org/Cliquez sur Download ou personnalisez le téléchargement en cochant les options voulues puis cliquez sur Start Download en bas.Enregistrez le fichier .tgz où vous voulez (par ex. dans le répertoire Téléchargements)Décompressez l'archive de distribution -> répertoire dokuwiki-xxxxxxxxxxxxxx/Lancez FilezillaOuvrez votre serveurLocalement, ouvrez le répertoire dokuwiki-xxxxxxxxxxxxxx/et envoyez tout le répertoire dokuwiki sur votre espace Web.Ouvrez la page de votre futur site https://monsite.tld/install.phpChoisissez votre langue: : fr, puis Mettre à jourNom du wiki : Donnez le titre de votre WikiCochez Activer le contrôle d'accès (recommandé)Super-utilisateur : son nom d'userNom : Son nom véritableAdresse de courriel : Son courrielMot de passe : Son mot de passe, et confirmez-lePolitique de contrôle d'accès initiale : choisissez le degré de fermeture du wikiNe cochez pas Permettre aux utilisateurs de s'enregistrer eux-mêmes. (sauf si vous le voulez...)Veuillez choisir la licence sous laquelle vous souhaitez placer votre contenu : : Cochez la licence désiréeSi 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

Sécurisation :sous Apache 2, activez les .htaccess : Créez avec les droits d'administration le fichier /etc/apache2/sites-available/monsite.conf pour y écrire :

<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
</Directory>

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>

Mise à jour :Le mieux est d'utiliser le pluginMéthode manuelle, en local sur le serveur :Faites une sauvegarde complète du wiki :

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

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

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

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

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

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

Effacez install.php :

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

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

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

Seuls les fichiers existants sont effacés.Réglez les permissions, sans oublier les éventuels nouveaux répertoires sous data/Comparez votre .htaccess avec le .htaccess.dist fourni pour les changements nécessairesMettez à jour les plugins et les templatesEffacez le cache en faisant un touch de conf/local.php pour sauver la configurationMettre à jour l'index si besoinCes é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

Paramètres de DokuwikiRaccourcis interwikiThèmes :Dokuwiki : Thème MonobookDokuwiki : Thème vectorAjouter ses propres boutons à la barre d'outils

Utilisation

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échargera2s : Diagramme ASCIIaddnewpage : Ajouter une nouvelle pagealphalist2 : affiche par ordre alphabétique les listes ordonnées ou nonbackup : Outil de sauvegarde pour DokuWikibookcreator : créer un livre (PDF, ODT ou text)captcha : utilise une vérification par image (CAPTCHA) pour déjouer les spambotscharpicker : modifie la liste des caractères dans le sélecteur de caractères spéciaux de DokuWikicli : plugin Command Line Interface pour Dokuwikicloud : nuage des mots les plus fréquemment utiliséscolor : écrit du texte en couleurconfmanager : gérer divers fichiers .confcopypage : crée une nouvelle page à partir d'une page existantecustombuttons : ajout de boutons personnalisés à la barre d'outilsdefinitionlist : syntaxe pour les listes de définitionsdiagram : construit des diagrammesdiffpreview : ajoute un bouton pour visualiser les différences en mode éditionditaa : convertit en image les diagrammes de flux ASCIIdropfiles : permet de télécharger des fichiers par drang'n'drop dans la zone d'édition d'une pagedw2pdf : Exporter du contenu DokuWiki au format PDFedittable : édition de tableaux dans Dokuwikifolded : Sections de page repliablesgallery : crée une galerie d'images à partir d'un espace de nom ou d'un RSShidden : cache ou montre des détailskeyboard : Marque le texte de Dokuwiki comme des touches du clavierloglog : enregistre les connexions, les déconnexions et l'activité de l'administrateur dans un fichiermathpublish : ajoute des formules mathématiques : Voir https://www.dokuwiki.org/plugin:mathpublishmove : déplace et renomme des pages et des fichiers multimédiasmultiorphan : GUI pour trouver toutes sortes de pages et de médias orphelins ou recherchésnbsp : espace insécablestale : "touche" les fichiers de configuration (successeur de toucher)odt : Export OpenOffice.org/LibreOffice.orgpagelist : liste les pages dans un format agréableqna : FAQsortablejs : permet de trier les tableaux par colonnessubnumberlistsync : synchroniser des dokuwikistab : syntaxe spéciale pour les tabulationstablecalc : faire des calculs dans une table comme avec Exceltemplatepagename : pages de modèle c_template et i_templatetag : assigner des tags aux pages de Dokuwikitoolbox : ajoute divers outils à la barre d'outils de l'éditeurtranslate : un plugin de traduction qui n'exige pas que le nom de la page soit le même dans toutes les languestranslation : configuration facile d'un wiki multi-languetypography : capacités de mise en pageupgrade : Mettez à jour votre DokuWiki en quelques clics depuis l'interface d'administrationvshare : intégration de vidéos provenant de divers sites de partage de vidéoswrap : conteneurswrapadd : styles supplémentaires pour le plugin WRAPyalist : Plugin de liste universel simple

Plugin Site ExportText (exportation / rendu)Numérotation automatique avec des compteurs CSSNumérotation des titres par CSS uniquement (remplace numberedheadings)Numérotation automatique des titres par CSSCacherevisionseraser : Nettoyeur du cache et des révisionsbureaucracy : Voir https://www.dokuwiki.org/plugin:bureaucracydoodle2 : Voir https://www.dokuwiki.org/plugin:doodle2French Typography : Voir https://www.dokuwiki.org/plugin:french_typographyodt2dw : Voir https://www.dokuwiki.org/plugin:odt2dwtranslation : Voir https://www.dokuwiki.org/plugin:translation ; se configure dans les paramètres de configuration (administration)

extlist : syntaxe étendue pour les listes : 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 uparrowcodebutton2jcapture : Voir Dokuwiki : plugin jcaptureNote 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 $rendererremplacez tous les &$handler par Doku_Handler $handler
Tutoriels :Désactiver le redimensionnement des icônesCréer une page de fichiers à téléchargerCré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

(fr) https://doc.ubuntu-fr.org/dokuwiki

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