Table des matières

DokuWiki

À intégrer :

Introduction

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. Il permet facilement les modifications et ajouts de pages, de “répertoires”.

→ définir un wiki (cf. aussi Using DokuWiki as a lightweight CMS)

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 :

Références :

Historique du projet

Installation et administration système

Procédure de base

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) :

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 :

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 !

Quelques premières améliorations (extensions,...)

DokuWiki peut être étendu par des extensions (plugins) dont certaines sont particulièrement utiles. Ces extensions sont installées à partir du panneau d'administration. Sélectionner la page “Gestionnaire d'extensions”, qui permet de lister les plugins installés. Il est facile d'en installer d'autres, via l'onglet “Rechercher et installer” : taper “upgrade” pour obtenir la liste des extensions correspondant à ce critère. Le plugin “Upgrade plugin” apparaît normalement en tête, et il suffit de cliquer sur le bouton “installer”. En retournant sur le panneau d'administration, on dispose à présent de la fonctionnalité “Mise à jour du wiki” qui sera utile lors de la sortie d'une mise à jour du logiciel, pour lesquelles des messages d'avertissement seront affichés.

Le thème graphique de DokuWiki peut aussi être modifié en sélectionnant un des nombreux thèmes listés à la page https://www.dokuwiki.org/template. Les thèmes s'installent comme les extensions, mais un seul thème à la fois peut être activé, via le gestionnaire de configuration. Bootstrap3 est un exemple de thème fréquemment utilisé.

Réécriture d'URL (jolis URL)

RewriteEngine on
#
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
RewriteRule ^index.php$               doku.php

Sécurisation, configuration

message à l'installation : “It seems your data directory is not properly secured. Please read https://www.dokuwiki.org/security

Solution :

Quelle est la structure du wiki sur le serveur ?

Comment utiliser plusieurs instances de DokuWiki ?

Mises à jour

Sauvegardes

En mode manuel, avec création d'une copie sous un autre nom

Migration

réinstallation (à vérifier en 2020 !)

Pages et syntaxe d'écriture

Structure en namespaces

Utilisateurs, groupes

Les utilisateurs enregistrés peuvent ouvrir une session en utilisant le bouton de connexion. Si l’administrateur du wiki ne l'a pas désactivé, les visiteurs peuvent s'enregistrer sur le wiki. Sinon, ils doivent demander un code d'accès par un autre moyen. Suivant les réglages du site, les pages et fonctionnalités (droit d'édition,…) sont accessibles de manière différente et en fonction des utilisateurs (voir les ACL).

Des groupes d'utilisateurs partageant les mêmes droits peuvent être créés. Les groupes sont représentés par un préfixe, le caractère: @ suivi du nom du groupe. Il existe des groupes spéciaux, comme @ALL (tout le monde, même les utilisateurs non connectés) et @user (tous les inscrits).

ACL (Access Control List)

Des restrictions d'accès peuvent être liées aux pages et aux espaces de noms. Il y a sept permissions, d'importances croissantes :

  1. aucune (none)
  2. lire (read)
  3. modifier (edit)
  4. créer (create)
  5. téléverser sur le serveur (upload)
  6. effacer (delete)
  7. administrer (admin)

Les accès sont déterminés pour des utilisateurs ou groupes d'utilisateur. On utilise le groupe @ALL (tout le monde) pour limiter l'accès à tous les utilisateurs (comme configuration par défaut) et autoriser dans une règle suivante certaines permissions pour quelques utilisateurs (ou groupes) choisis.

Détails : https://www.dokuwiki.org/fr:acl

Le gestionnaire Multimédia

Le Wiki permet de sauvegarder et d'afficher des fichiers media : images, sons et vidéos, avec les possibilités d'interaction classiques pour ces deux dernier formats (démarrer, arrêter, défiler avec un curseur temporel). D'autres fichiers peuvent aussi être mis à disposition : pdfs, documents de suites bureautiques, archives compressées,…

Pour insérer un fichier directement dans une page en cours d'édition, mieux vaut utiliser le gestionnaire disponible dans la barre d'outil d'édition. Sinon, vous pouvez gérer vos médias à l'aide du Gestionnaire Multimédia en mode pleine page.

Les documents sont sauvegardés dans une arborescence identique aux namespaces des pages.

Pour l'insertion des images, sons ou vidéos, il est possible de régler la taille et la position (droite, gauche, centrée) de l'affichage.

  • Des types mime additionnels peuvent être ajoutés via le fichier de configuration local mime.local.conf (you need to create
  • En préfixant le type par un point d'exclamation (!), cela force le navigateur à proposer la bote de dialogue de téléchargement.

Références

Extensions

Exemples en fonction : dokuwiki_extensions

FIXME :

FIXME Logo & favicon ??

Divers

Thèmes (templates)

La conception : namespaces, groupes et droits

Exemple : une ASBL consacrée aux logiciels libres

Activités : ateliers mensuels, activités extérieures, activités récréatives, documentation, répertoire de logiciels, fonctionnement de l'ASBL (AG, réunions du CA, secrétariat, trésorerie, inventaire matériel…)

Groupes et utilisateurs : inscrits sur le site, membres de l'ASBL, membres du CA, administrateurs systèmes, groupes de travail thématiques, éditeurs/rédacteurs,…

Exemple : l'enseignement communal à Gnuville

Sous-parties : l'échevinat, l'enseignement fondamental (maternel et primaire), l'enseignement secondaire (général, technique de transition, technique de qualification et professionnel), l'enseignement de promotion sociale (niveaux secondaire et supérieur), l'académie de Musique (enseignement artistique), l'enseignement spécialisé, le CPMS

Les métiers : l'administration (direction générale, directions, comptabilité), les infrastructures (bâtiments, techniques générales, informatique), l'enseignement (y compris éducation artistique et culturelle, disciplines scientifiques et techniques, gymnastique et sport, langues) le psycho-médical, le soutien pédagogique,…

Les implantations : administration, écoles (maternelles, primaires, fondamentales), centre PMS, Régie des bâtiments,…

Les bénéficiaires : élèves du fondamental (4500 et leurs parents), élèves du secondaire (3000), élèves

Groupes : parents (fondamental), élèves secondaires

Scripts DokuWiki

Passage en https, avec des certificats SSL classiques, ou via Let's encrypt

Astuces

Dépannage

Les problèmes sont assez rares !

Communauté et développement

Des sites en DokuWiki

Produits incorporant DokuWiki en option :

Des analyses, comparaisons,... sur DokuWiki

Dans la presse et les blogs...