La plupart des fonctionnalités de DokuWiki peuvent être configurées grâce à différentes options. Le moyen le plus simple de configurer DokuWiki est d'utiliser le Gestionnaire de configuration.
Pour lancer le Gestionnaire de Configuration, se connecter en tant qu'administrateur ou superutilisateur et cliquer sur le bouton Admin du bas de page.
Les options « système » de DokuWiki se trouvent dans le fichier conf/dokuwiki.php. Cependant, ce fichier contient les valeurs par défaut du système. Pour le personnaliser, il vaut mieux éditer le fichier conf/local.php ou le créer si besoin. Pour voir ce que vous pouvez configurer depuis ce fichier, voir la liste des options disponibles ci-dessous.
Les nom d'utilisateur, les mots de passe (cryptés) et la liste des Contrôles d'Accès sont stockés dans les fichiers users.auth.php et acl.auth.php
Quand vous uploadez un nouveau fichier via le Gestionnaire de médias, vous pouvez parfois tomber sur le message “Upload denied. This file extension is forbidden!” Ce comportement est contrôlé depuis le fichier conf/mime.conf. Pour qu'il soit possible d'uploader certains types de fichier, il faut le spécifier dans le fichier mime.conf.
Quand vous éditez vos pages, DokuWiki peut remplacer automatiquement du texte lors de l'affichage de la page. C'est le cas pour les acronymes, comme « HTML », les smileys ou certains caractères spéciaux, comme « © ». Ce comportement est contrôlé via les fichiers acronyms.conf, smileys.conf et entities.conf.
Tous les fichiers de configuration se trouvent dans le dossier ./conf.
Les fichier se terminant par .conf sont généralement fournis avec DokuWiki tandis que les fichiers local.conf doivent être crées par l'administrateur du wiki.
Si cela est possible, il faut toujours utiliser des fichiers local.conf pour que vos réglages soient conservés à la prochaine mise à jour de DokuWiki.
| fichier .conf | fichier .local.conf | type de configuration | en bref |
|---|---|---|---|
dokuwiki.php | local.phplocal.protected.php | voir ci-dessous | configuration générale du wiki |
acronyms.conf | acronyms.local.conf | abbreviations | abréviations automatiques |
entities.conf | entities.local.conf | entities | remplacement automatique de texte |
interwiki.conf | interwiki.local.conf | interwiki | raccourcis interwiki |
mime.conf | mime.local.conf | mime | configuration des types MIME autorisés en upload |
smileys.conf | smileys.local.conf | smileys | smileys |
acl.auth.php | voir acl | Contrôle d'Accès | |
users.auth.php | voir acl | Utilisateurs et mots de passe | |
mediameta.php | exif | Métadonnées éditables pour les images | |
wordblock.conf | wordblock.local.conf | blacklist | Liste noire anti-spam |
userscript.js | javascript | Ajouter du JavaScript | |
userstyle.css | css | Personnaliser les styles CSS |
La plupart des fonctionnalités de DokuWiki peuvent être configurées grâce à différentes options. Le moyen le plus simple de configurer DokuWiki est d'utiliser le Gestionnaire de configuration.
Les réglages disponibles sont listés ci-dessous. Les valeurs par défaut sont stockées dans le fichier conf/dokuwiki.php. Si vous voulez modifier un réglage, vous devriez le faire dans un fichier conf/local.php : cela garantit que vos réglages ne seront pas perdus lors d'une future mise à jour. Le Gestionnaire de configuration utilisera ce fichier automatiquement. On peut utiliser le fichier conf/local.protected.php pour y mettre des réglages qui ne peuvent pas êtres modifiés.
Voici un exemple de fichier conf/local.php :
<?php $conf['title'] = "Le Wiki de Pierre"; $conf['useacl'] = 1; $conf['superuser'] = 'pierre'; ?>
Quelques notes au sujet du fichier de configuration. Le fichier est constitué de fragments de code PHP. La syntaxe de PHP doit donc être préservée. Par exemple chaque ligne doit finir par un point-virgule. Il y a plusieurs types de variables :
9'foo bar'false (faux) ou true (vrai) ou de façon équivalente 1 ou 0If you create translate or modify whole or part of this page, add your name and your email here.