DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:config

Configuration de DokuWiki

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 qui permet aux administrateurs de modifier les options de configuration depuis leur navigateur préféré.

Pour lancer le Gestionnaire de configuration, se connecter en tant qu'administrateur ou superutilisateur et cliquer sur le bouton Administrer.

Que peut-on configurer dans DokuWiki ?

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 noms d'utilisateur, les mots de passe (chiffrés) et la liste des Contrôles d'Accès sont stockés dans les fichiers users.auth.php et acl.auth.php, disponibles dans le répertoire conf.

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 de téléverser 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 particuliers, comme « © ». Ce comportement est contrôlé via les fichiers acronyms.conf, smileys.conf et entities.conf.

Récapitulation de tous les fichiers de configuration

Tous les fichiers de configuration se trouvent dans le dossier ./conf, ou /etc/dokuwiki si DokuWiki est installé via un paquet Debian ou rpm.

Les fichiers se terminant par .conf sont généralement fournis avec DokuWiki tandis que les fichiers local.conf doivent être créés 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.php
local.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 au téléversement
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
license.php license.local.php license liste des licences de contenu disponibles
scheme.conf scheme.local.conf urlschemes Protocoles d'URL reconnus comme liens
mediameta.php exif Métadonnées éditables pour les images
wordblock.conf wordblock.local.conf blacklist Liste noire anti-spam
plugins.required.php plugins.local.php
plugins.protected.php
voir ci-dessous Activation/Désactivation d'extensions
userscript.js javascript Ajouter du JavaScript
userstyle.css css Personnaliser les styles CSS

Fichiers de configuration de thème

Des fichiers de configuration supplémentaires se trouvent dans /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), par exemple style.ini. Style.ini est un fichier texte qui est lu par le thème par défaut que l'utilisateur peut configurer, par exemple La couleur de fond (background-color).

Activer/désactiver des greffons

Les greffons installés sont activés par défaut. Ils peuvent être désactivés en utilisant le Gestionnaire d'Extensions qui écrit dans le fichier plugins.local.php. Vous pouvez protéger certains greffons en les plaçant dans conf/plugins.protected.php.

Par défaut, DokuWiki charge ses fichiers de configuration dans l'ordre suivant :

  1. conf/plugins.php – greffons par défaut
  2. conf/plugins.local.php – mis à jour par le Gestionnaire d'Extensions
  3. conf/plugins.required.php – ces greffons ne peuvent pas être contrôlés par le Gestionnaire d'Extensions
  4. conf/plugins.protected.php – écrase les paramètres définis dans les autres fichiers

L'ordre de chargement des fichiers de configuration est défini par la variable globale $config_cascade. En utilisant un fichier preload.php vous pouvez changer ce comportement.

Options de configuration

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 :

  • Numbers : variables de type nombres qui peuvent être écrites telles quelles. Exemple : 9
  • Strings : variables de type chaînes de caractères qui doivent être mises entre apostrophes. Exemple : 'foo bar'
  • Booleans : variables de type logique qui peuvent valoir false (faux) ou true (vrai) ou de façon équivalente 1 ou 0
  • Arrays : variables de type tableau qui contiennent des valeurs multiples d'un des types ci-dessus.

Options disponibles

Crédits

If you create translate or modify whole or part of this page, add your name and your email here.

fr/config.txt · Dernière modification : 2020-08-03 20:56 de Digitalin

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki