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 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.

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.

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.

• Paramètres de base
  • title
  • start
  • lang
  • template
  • savedir
  • basedir
  • baseurl
  • dmode
  • fmode
  • allowdebug
• Paramètres d'affichage
  • recent
  • breadcrumbs
  • youarehere
  • fullpath
  • typography
  • dformat
  • signature
  • toptoclevel
  • maxtoclevel
  • maxseclevel
  • camelcase
  • deaccent
  • useheading
  • refcheck
  • refshow
  • target
• Paramètres d'authentification
  • useacl
  • autopasswd
  • authtype
  • passcrypt
  • defaultgroup
  • superuser
  • manager
  • profileconfirm
  • disableactions
  • sneaky_index
  • auth_security_timeout
• Paramètres anti-spam
  • usewordblock
  • relnofollow
  • indexdelay
  • mailguard
  • iexssprotect
• Paramètres d'édition
  • usedraft
  • htmlok
  • phpok
  • locktime
  • cachetime
• Paramètres média
  • gdlib
  • im_convert
  • jpg_quality
  • fetchsize
• Options de Syndication
  • rss_type
  • rss_linkto
  • rss_content
  • rss_update
  • rss_show_summary
  • notify
  • subscribers
  • registernotify
• Paramètres avancés
  • userewrite
  • useslash
  • sepchar
  • canonical
  • autoplural
  • mailfrom
  • compress
  • gzip_output
  • hidepages
  • sitemap
  • recent_days
  • broken_iua
  • xsendfile
  • xmlrpc
  • renderer_xhtml
• Paramètres réseaux
  • updatecheck
  • compression
  • send404
  • proxy
  • safemodehack
  • ftp

Le texte ci-dessous sera supprimé une fois la réorganisation du Wiki terminée. Merci de ne pas le supprimer pour le moment.

Cette option paramètre les permissions que vous souhaitez appliquer aux fichiers que vous créez. Ce que vous paramétrez ici est le mode de paramétrage de vos fichiers en octal (ne pas utiliser de chaînes de caractères, mais un nombre commençant toujours par 0). Par défaut les fichiers sont créés avec la permission 0644 (rw-r-r-).

• Type: Number
• Default: 0644

Cette option fixe les permissions que vous souhaitez accorder aux répertoires que vous créez. Ce que vous paramétrez ici est le mode de paramétrage de vos répertoires en octal (ne pas utiliser de chaînes de caractères, mais un nombre commençant toujours par 0). Par défaut les répertoires sont créés avec la permission 0755 (rwxr-xr-x).

• Type: Number
• Default: 0755

Habituellement DokuWiki peut détecter seul le répertoire dans lequel il est installé. Mais parfois ceci ne fonctionne pas pour différentes raisons. Si DokuWiki ne semble pas fonctionner correctement et n’affiche pas des éléments tels que des images pour les pages Web, vous pouvez indiquer ce répertoire ici.

Le chemin que vous devez placer ici, est le chemin d'accès depuis la racine du serveur jusqu’ à votre installation de DokuWiki. Par exemple si votre wiki est disponible à l’adresse http://www.yourserver.com/dokuwiki/ vous devez indiquer /dokuwiki / dans l’option basedir. Prenez garde à bien mettre les barres obliques au début et à la fin.

• Type : String
• Default :

Cette option indique la langue de l’interface. Voir le support multilingue.

• Type :String
• Default : fr

Cette option indique le chemin du répertoire où tous les fichiers seront stockés. Il s’agit d’un chemin relatif à l’option ''basedir'' expliquée ci-dessus. Le répertoire doit être accessible en écriture.

• Type :String
• Default :./data

A l’intérieur de ce répertoire se trouvent de multiples sous répertoires et le changelog. Vous pouvez modifier leur emplacement avec les paramètres de configuration suivants :

Pour le rendre plus simple et pour répondre aux besoins de supports, DokuWiki est susceptible d’afficher une grande quantité de lignes de déboguage si on le lui demande. Cela peut être utile pour dépanner tout genre de problèmes de configuration lors de la première installation du Wiki. Mais DokuWiki révèle également beaucoup d'informations au sujet du serveur sur lequel il est en fonction. Pour des raisons de sécurité il faut invalider cette option et invalider de ce fait la fonction de déboguage une fois que la mise au point de votre Wiki est établie avec succès.

• Type: Boolean
• Default: 1

C'est le nom de la page par défaut qui est chargée quand aucune autre page n’est connue sous le nom de « homepage » .

• Type: String
• Default: start

C'est le nom de votre installation du Wikiki. Modifiez le pour le titre qui vous plaît. Si vous voulez faire fonctionner plusieurs installations de DokuWiki sur le même serveur, elles doivent avoir chacune un titre différent !

• Type: String
• Default: DokuWiki

Si le titre contient des caractères accentués (comme ä,ü) ou d’autres caractères spéciaux, ceux-ci sont affichés comme points d'interrogation. Pour éviter cela, utilisez $conf['title']=utf8_encode("Titlestring");

Cette option fixe le nom du modèle (template) employé par votre installation de Wiki. Pour plus de détails référez-vous aux templates

• Type: String
• Default: default

Activez cette option pour voir le chemin complet du système de fichier pour le document affiché.

• Type: boolean
• Default: 0

Cette option définit le nombre de documents affichés dans les Modifications Récentes.

• Type: Number
• Default: 20

Cette option définit le nombre de pages récemment visitées à afficher dans la piste (breadcrumbs). Fixez la valeur à 0 pour désactiver cette fonction.

• Type: Number
• Default: 10

Cette option active une alternative à l'option breadcrumbs (la piste) affichant la hiérarchie des espaces de noms de la page affichée. Vous pouvez désactiver la piste standard (breadcrumbs) si vous activez cette option.

• Type: Boolean
• Default: 0

Permet de convertir certaines combinaisons de caractères en leurs contreparties typographiquement correctes.

• Type: Boolean
• Default: 1

Cette option (désactivée par défaut) autorise l’encapsulation HTML en utilisant les balises <html>. Ceci autorise l’insertion de code HTML et peut casser la mise en page. La conformité XHTML, si elle est mauvaise, est remplacée par HTML.

• Type: Boolean
• Default: 0

Cette option (désactivée par défaut) autorise l’encapsulation PHP en utilisant les balises <php>. Ceci autorise l’insertion de code PHP dans les pages. C'est une énorme faille de sécurité si cette option est utilisée pour un site en accès libre !

• Type: Boolean
• Default: 0

Cette option configure la façon dont les dates sont formatées. La valeur est transmise directement à la fonction PHP date. Certaines personnes peuvent préférer fixer cette valeur à d.m.Y H:i.

• Type: String
• Default: Y/m/d H:i

dfsdfs

Cette option précise à quoi devrait ressembler la chaîne de caractères des signatures pour les utilisateurs identifiés. Vous pouvez utiliser toutes les variables définies par la fonction PHP strftime et les variables spéciales suivantes :

• Type: String
• Default: --- //[[@MAIL@|@NAME@]] @DATE@//

Certaines personnes peuvent préférer quelque chose de plus court comme : --- //[[@MAIL@|@USER@]] %b%e//. Si vous voulez avoir des pages utilisateurs vous pourriez utiliser quelque chose comme cela : --- //[[user:@USER@|@NAME@]] @DATE@//

Cette option fixe le nombre maximum de niveaux d’en-têtes (de 0 à 5) à inclure dans la table des matières qui est générée automatiquement sur chaque page.

• Type: Number (0-5)
• Default: 3

Cette option fixe le nombre maximum de profondeur de niveaux d’en-têtes (de 0 à 5) à créer comme étant des sections éditables séparées.

• Type: Number (0-5)
• Default: 3

Une valeur 0 désactive les boutons d’édition des sections de pages.

Activez cette option pour utiliser les liens de type CamelCase. C’est une façon controversée de pratiquer les liens dans les Wikis. Si vous activez l’option et la désactivez plus tard vous pouvez créer des. pages orphelines (anglais).

• Type: Boolean
• Default: 0

Quand cette option est fixée à 1, les caractères accentués dans les noms de pages seront remplacés par leur équivalent ASCII non accentués. Par exemple ü deviendra ue ou à deviendra a. Quand l’option est fixée à 2, la romanisation des noms de page est activée : les symboles des alphabets non latins seront remplacés par des équivalents ASCII fermés. La valeur 0 stoppe totalement ces transformations.

• Type: Number (0-2)
• Default: 1

Quand cette option est activée, un lien vers un nom de page wiki utilisera automatiquement la première entête dans la page pour chacun des cas suivants :

• Le titre de la page, suivant les indications du navigateur ou dans les résultats du moteur de recherche.
• Le texte pour un lien à la page, à moins que le contenu du lien ne spécifie un titre explicite
• Le titre des entrées de flux RSS pour la page

Pour plus d'information, lisez Utilisation de la première entête comme nom de page.

• Type: Boolean
• Default: 0

Vérifie les références avant d'effacer des fichiers de médias.

• Type: Boolean
• Default: 1

Nombre de références devant être affichées (5 est une bonne valeur).

• Type: Boolean
• Default: 5

Active l'utilisation d'une liste noire (blacklist) contre les spammeurs de Wiki.

• Type: Booléen
• Défaut: 1

Autorise l'indexation par les moteurs de recherche après un temps donné en secondes.

• Type: Number
• Défaut: 60*60*24*5 (5 jours par exemple)

Utiliser rel=nofollow pour les liens externes du type <a rel=“nofollow” …>. Plus d'informations sur nofollow ici (anglais) et différentes perspectivesici (anglais).

• Type: Booléen
• Défaut: 1

Cette page est partiellement traduite !

Veuillez suivre ce lien pour afficher le texte original en anglais. Revenez ensuite ici pour y coller votre traduction !

Plus d'informations sur la traduction des pages.

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

• Philippe LAPEYRIE