====== 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 [[fr:plugin:config|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 [[fr:acl|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 [[fr:mime|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 « (c) ». Ce comportement est contrôlé //via// les fichiers [[fr:abbreviations|acronyms.conf]], [[fr:smileys|smileys.conf]] et [[fr:entities|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'' | [[fr:abbreviations]] | Abréviations automatiques | | ''entities.conf'' |''entities.local.conf'' | [[fr:entities]] | Remplacement automatique de texte | | ''interwiki.conf'' |''interwiki.local.conf'' | [[fr:interwiki]] | Raccourcis interwiki | | ''mime.conf'' |''mime.local.conf'' | [[fr:mime]] | Configuration des types MIME autorisés au téléversement | | ''smileys.conf'' |''smileys.local.conf'' | [[fr:smileys]] | Smileys | | |''acl.auth.php'' | voir [[fr:acl]] | Contrôle d'Accès | | |''users.auth.php'' | voir [[fr:acl]] | Utilisateurs et mots de passe | | ''license.php'' |''license.local.php'' | [[.:config:license]] | liste des licences de contenu disponibles | | ''scheme.conf'' |''scheme.local.conf'' | [[urlschemes]] | Protocoles d'URL reconnus comme liens | | ''mediameta.php'' | | [[fr:exif]] | Métadonnées éditables pour les images | | ''wordblock.conf'' |''wordblock.local.conf'' | [[fr:blacklist]] | Liste noire anti-spam | |''plugins.required.php'' |''plugins.local.php''\\ ''plugins.protected.php'' | voir ci-dessous | Activation/Désactivation d'extensions | | |''userscript.js'' | [[devel:javascript]] | Ajouter du JavaScript | | |''userstyle.css'' | [[devel: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 ''[[Devel: 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 [[fr:plugin:extension|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 : - ''conf/plugins.php'' -- greffons par défaut - ''conf/plugins.local.php'' -- mis à jour par le Gestionnaire d'Extensions - ''conf/plugins.required.php'' -- ces greffons ne peuvent pas être contrôlés par le Gestionnaire d'Extensions - ''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 [[devel:preload|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 [[fr:plugin:config|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'' : 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 : ***Number**s : variables de type nombres qui peuvent être écrites telles quelles. Exemple : ''9'' ***String**s : variables de type chaînes de caractères qui doivent être mises entre apostrophes. Exemple : ''%%'foo bar'%%'' ***Boolean**s : variables de type logique qui peuvent valoir ''false'' (faux) ou ''true'' (vrai) ou de façon équivalente ''1'' ou ''0'' ***Array**s : variables de type tableau qui contiennent des valeurs multiples d'un des types ci-dessus. ==== Options disponibles ==== * **Paramètres de base** * [[fr:config:title]] * [[fr:config:startpage|start]] * [[fr:config:lang]] * [[fr:config:template]] * [[fr:config:tagline]] * [[fr:config:sidebar]] * [[fr:config:license]] * [[fr:config:savedir]] * [[fr:config:basedir]] * [[fr:config:baseurl]] * [[fr:config:dmode]] * [[fr:config:fmode]] * [[fr:config:allowdebug]] * **Paramètres d'affichage** * [[fr:config:recent]] * [[fr:config:recent_days]] * [[fr:config:breadcrumbs]] * [[fr:config:youarehere]] * [[fr:config:fullpath]] * [[fr:config:typography]] * [[fr:config:dformat]] * [[fr:config:signature]] * [[fr:config:showuseras]] * [[fr:config:toptoclevel]] * [[fr:config:tocminheads]] * [[fr:config:maxtoclevel]] * [[fr:config:maxseclevel]] * [[fr:config:camelcase]] * [[fr:config:deaccent]] * [[fr:config:useheading]] * [[fr:config:sneaky_index]] * [[fr:config:hidepages]] * **Paramètres d'authentification** * [[fr:config:useacl]] * [[fr:config:autopasswd]] * [[fr:config:authtype]] * [[fr:config:passcrypt]] * [[fr:config:defaultgroup]] * [[fr:config:superuser]] * [[fr:config:manager]] * [[fr:config:profileconfirm]] * [[fr:config:rememberme]] * [[fr:config:disableactions]] * [[fr:config:auth_security_timeout]] * [[fr:config:securecookie]] * [[fr:config:remote]] * [[fr:config:remoteuser]] * **Paramètres anti-spam** * [[fr:config:usewordblock]] * [[fr:config:relnofollow]] * [[fr:config:indexdelay]] * [[fr:config:mailguard]] * [[fr:config:iexssprotect]] * **Paramètres d'édition** * [[fr:config:usedraft]] * [[fr:config:htmlok]] * [[fr:config:phpok]] * [[fr:config:locktime]] * [[fr:config:cachetime]] * **Paramètres de liens** * [[fr:config:target|target (wiki, interwiki, extern, media, windows)]] * **Paramètres média** * [[fr:config:mediarevisions]] * [[fr:config:gdlib]] * [[fr:config:im_convert]] * [[fr:config:jpg_quality]] * [[fr:config:fetchsize]] * [[fr:config:refcheck]] * ** Options de Notification ** * [[fr:config:subscribers]] * [[fr:config:subscribe_time]] * [[fr:config:notify]] * [[fr:config:registernotify]] * [[fr:config:mailfrom]] * [[fr:config:mailprefix]] * [[fr:config:htmlmail]] * **Options de Syndication** * [[fr:config:sitemap]] * [[fr:config:rss_type]] * [[fr:config:rss_linkto]] * [[fr:config:rss_content]] * [[fr:config:rss_media]] * [[fr:config:rss_update]] * [[fr:config:rss_show_summary]] * **Paramètres avancés** * [[fr:config:updatecheck]] * [[fr:config:userewrite]] * [[fr:config:useslash]] * [[fr:config:sepchar]] * [[fr:config:canonical]] * [[fr:config:fnencode]] * [[fr:config:autoplural]] * [[fr:config:compress]] * [[fr:config:cssdatauri]] * [[fr:config:gzip_output]] * [[fr:config:send404]] * [[fr:config:compression]] * [[fr:config:broken_iua]] * [[fr:config:xsendfile]] * [[fr:config:renderer_xhtml]] * [[fr:config:readdircache]] * [[fr:config:search_nslimit]] * [[fr:config:search_fragment]] * **Paramètres réseaux** * [[fr:config:dnslookups]] * [[fr:config:jquerycdn]] * [[fr:config:proxy|proxy (host, port, user, pass, ssl)]] * [[fr:config:trustedproxy]] * [[fr:config:safemodehack]] * [[fr:config:ftp|ftp (host, port, user, pass, root)]] ===== Crédits ===== //If you create translate or modify whole or part of this page, add your name and your email here.// * [[user>schplurtz|schplurtz]] *//[[|Philippe LAPEYRIE]]// *//[[|Cyril]]// * //Laynee// * //Digitalin//