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 $renderer

remplacez tous les &$handler par Doku_Handler $handler

Avoir installé Java, voir Java, un langage multi-plateformes

Avoir 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 Downloader

Dokuwiki : Mise à niveau

Mé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 Filezilla

Ouvrez votre serveur

Localement, 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.php

Choisissez votre langue: : fr, puis Mettre à jour

Nom du wiki : Donnez le titre de votre Wiki

Cochez Activer le contrôle d'accès (recommandé)

Super-utilisateur : son nom d'user

Nom : Son nom véritable

Adresse de courriel : Son courriel

Mot de passe : Son mot de passe, et confirmez-le

Politique de contrôle d'accès initiale : choisissez le degré de fermeture du wiki

Ne 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 plugin

Mé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écessaires

Mettez à jour les plugins et les templates

Effacez le cache en faisant un touch de conf/local.php pour sauver la configuration

Mettre à jour l'index si besoin

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

Paramètres de Dokuwiki

Raccourcis interwiki

Thèmes :

Dokuwiki : Thème Monobook

Dokuwiki : Thème vector

Ajouter 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écharger

a2s : Diagramme ASCII

addnewpage : Ajouter une nouvelle page

alphalist2 : affiche par ordre alphabétique les listes ordonnées ou non

backup : Outil de sauvegarde pour DokuWiki

bookcreator : créer un livre (PDF, ODT ou text)

captcha : utilise une vérification par image (CAPTCHA) pour déjouer les spambots

charpicker : modifie la liste des caractères dans le sélecteur de caractères spéciaux de DokuWiki

cli : plugin Command Line Interface pour Dokuwiki

cloud : nuage des mots les plus fréquemment utilisés

color : écrit du texte en couleur

confmanager : gérer divers fichiers .conf

copypage : crée une nouvelle page à partir d'une page existante

custombuttons : ajout de boutons personnalisés à la barre d'outils

definitionlist : syntaxe pour les listes de définitions

diagram : construit des diagrammes

diffpreview : ajoute un bouton pour visualiser les différences en mode édition

ditaa : convertit en image les diagrammes de flux ASCII

dropfiles : permet de télécharger des fichiers par drang'n'drop dans la zone d'édition d'une page

dw2pdf : Exporter du contenu DokuWiki au format PDF

edittable : édition de tableaux dans Dokuwiki

folded : Sections de page repliables

gallery : crée une galerie d'images à partir d'un espace de nom ou d'un RSS

hidden : cache ou montre des détails

keyboard : Marque le texte de Dokuwiki comme des touches du clavier

loglog : enregistre les connexions, les déconnexions et l'activité de l'administrateur dans un fichier

mathpublish : ajoute des formules mathématiques : Voir https://www.dokuwiki.org/plugin:mathpublish

move : déplace et renomme des pages et des fichiers multimédias

multiorphan : GUI pour trouver toutes sortes de pages et de médias orphelins ou recherchés

nbsp : espace insécable

stale : "touche" les fichiers de configuration (successeur de toucher)

odt : Export OpenOffice.org/LibreOffice.org

pagelist : liste les pages dans un format agréable

qna : FAQ

sortablejs : permet de trier les tableaux par colonnes

subnumberlist

sync : synchroniser des dokuwikis

tab : syntaxe spéciale pour les tabulations

tablecalc : faire des calculs dans une table comme avec Excel

templatepagename : pages de modèle c_template et i_template

tag : assigner des tags aux pages de Dokuwiki

toolbox : ajoute divers outils à la barre d'outils de l'éditeur

translate : un plugin de traduction qui n'exige pas que le nom de la page soit le même dans toutes les langues

translation : configuration facile d'un wiki multi-langue

typography : capacités de mise en page

upgrade : Mettez à jour votre DokuWiki en quelques clics depuis l'interface d'administration

vshare : intégration de vidéos provenant de divers sites de partage de vidéos

wrap : conteneurs

wrapadd : styles supplémentaires pour le plugin WRAP

yalist : Plugin de liste universel simple

Plugin Site Export

Text (exportation / rendu)

Numérotation automatique avec des compteurs CSS

Numérotation des titres par CSS uniquement (remplace numberedheadings)

Numérotation automatique des titres par CSS

Cacherevisionseraser : Nettoyeur du cache et des révisions

bureaucracy : Voir https://www.dokuwiki.org/plugin:bureaucracy

doodle2 : Voir https://www.dokuwiki.org/plugin:doodle2

French Typography : Voir https://www.dokuwiki.org/plugin:french_typography

odt2dw : Voir https://www.dokuwiki.org/plugin:odt2dw

translation : 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 uparrow codebutton2 jcapture : Voir Dokuwiki : plugin jcapture 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

2. **Tutoriels** :
- **[[tutoriel:internet:dokuwiki:Dokuwiki:icones:start|]]**
- **[[tutoriel:internet:dokuwiki:pgtelechargement]]**
- **Créer une ferme de dokuwikis : **[[http://doc.nfrappe.fr/doku.php?id=logiciel:internet:dokuwiki:start1#installation|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.