====== Configuration de DokuWiki ======
**cette page est périmée** ! voir le [[wiki:config|document source]]
La plupart des caractéristiques de DokuWikis sont configurées dans le fichier ''conf/dokuwiki.php''. Vous trouverez ici une description de chaque option. Ne craignez pas la longueur de cette page. **Pour la majorité des utilisateurs DokuWiki fonctionnera sans avoir à modifier le fichier de configuration.**
Quelques notes au sujet du fichier de configuration. Le fichier est constitué de fragments de code PHP aussi la syntaxe de PHP doit elle être préservée. Par exemple chaque ligne doit finir par un point-virgule. Il y a de multiples types de variables :
***Number**s : variable de type nombres, ils peuvent être écrits simplement. Exemple : 9
***String**s : variable type chaînes de caractères elles doivent être mises entre apostrophes. Exemple : '''foo bar'''
***Boolean**s : variable de type logique elle peut valoir ''false'' (faux) ou ''true'' (vrai) ou de façon équivalente ''1'' ou ''0''.
***Array**s : variable de type tableau qui contient des valeurs multiples d'un des types ci-dessus.
**Conseil** : Le fichier de configuration inclut le fichier ''conf/local.php'' s'il existe. Ceci permet de modifier quelques options sans toucher à la configuration par défaut. Ceci devrait rendre les mises à jour plus simples.
Voici un exemple du fichier **conf/local.php**
Il y a maintenant un [[fr:plugin:config|plugin de configuration]] qui permet aux administrateurs de modifier la configuration de leur wiki en mode interactif depuis Dokuwiki.
Il y a de nombreux endroits pour personnaliser votre installation de DokuWiki. Allez voir à [[wiki:fr:interwiki|interwiki]], les crochets inclus, les templates (modèles), les smiley, les abréviations, les entités et les [[wiki:fr:css|feuilles de styles]].
===== Archivage des données et permissions =====
==== fmode ====
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
==== dmode ====
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
==== basedir ====
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 :
==== lang ====
Cette option indique la langue de l’interface. Voir [[wiki:fr:multilanguage|le support multilingue]].
* Type :String
* Default : ''fr''
==== savedir ====
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|''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 [[wiki:fr:changelog|changelog]]. Vous pouvez modifier leur emplacement avec les paramètres de configuration suivants :
^Paramètre^Répertoire de sauvegarde par défaut^
|datadir|pages|
|olddir|attic|
|mediadir|media|
|cachedir|cache|
|lockdir|locks|
|changelog|changes.log|
|metadir|meta|
==== allowdebug ====
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''
===== Options d’affichage =====
==== start ====
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''
==== title ====
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");
==== template ====
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 [[wiki:fr:tpl:templates|templates]]
*Type: String
*Default: ''default''
==== fullpath ====
Activez cette option pour voir le chemin complet du système de fichier pour le document affiché.
*Type: boolean
*Default: ''0''
==== recent ====
Cette option définit le nombre de documents affichés dans les //Modifications Récentes//.
*Type: Number
*Default: ''20''
==== breadcrumbs ====
Cette option définit le nombre de pages récemment visitées à afficher dans [[wiki:fr:breadcrumbs|la piste]] (breadcrumbs). Fixez la valeur à 0 pour désactiver cette fonction.
*Type: Number
*Default: ''10''
==== youarehere ====
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''
==== typography ====
Permet de convertir certaines combinaisons de caractères en leurs contreparties typographiquement correctes.
*Type: Boolean
*Default: ''1''
==== htmlok ====
Cette option (désactivée par défaut) autorise l’encapsulation HTML en utilisant les balises ''%%%%''. 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''
==== phpok ====
Cette option (désactivée par défaut) autorise l’encapsulation PHP en utilisant les balises ''%%%%''. 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''
==== dformat ====
Cette option configure la façon dont les dates sont formatées. La valeur est transmise directement à la fonction PHP [[phpfn>date]]. Certaines personnes peuvent préférer fixer cette valeur à ''d.m.Y H:i''.
*Type: String
*Default: ''Y/m/d H:i''
==== signature ====
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 [[phpfn>strftime]] et les variables spéciales suivantes :
^variable^ sera substituée par^
|@USER@|Le nom de l’identifiant de l’utilisateur|
|@NAME@|Le nom complet de l’utilisateur|
|@MAIL@|L’adresse Email de l’utilisateur|
|@DATE@|La date courante et l’heure formatée comme spécifié ci dessus avec [[config#dformat|dformat]]|
*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@//%%''
==== maxtoclevel ====
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''
==== maxseclevel ====
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.
==== camelcase ====
Activez cette option pour utiliser les liens de type [[http://fr.wikipedia.org/wiki/CamelCase|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.
[[wiki>OrphanPage|pages orphelines]] (anglais).
*Type: Boolean
*Default: ''0''
==== deaccent ====
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''
==== useheading ====
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 [[wiki:fr:useheading|Utilisation de la première entête comme nom de page]].
*Type: Boolean
*Default: ''0''
==== refcheck ====
Vérifie les références avant d'effacer des fichiers de médias.
*Type: Boolean
*Default: ''1''
==== refshow ====
Nombre de références devant être affichées (5 est une bonne valeur).
*Type: Boolean
*Default: ''5''
===== Spécificités antispam =====
==== usewordblock ====
Active l'utilisation d'une liste noire (blacklist) contre les spammeurs de Wiki.
*Type: Booléen
*Défaut: 1
==== indexdelay ====
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)
==== relnofollow ====
Utiliser rel=''nofollow'' pour les liens externes du type ''''.
//Plus d'informations sur nofollow [[http://googleblog.blogspot.com/2005/01/preventing-comment-spam.html|ici]] (anglais) et différentes perspectives[[http://www.nonofollow.net/index.php?title=Main_Page|ici]] (anglais).//
*Type: Booléen
*Défaut: 1
==== mailguard ====
----
:-( Cette page est partiellement traduite ! :-(
Veuillez suivre [[wiki:config|ce lien]] pour afficher
le texte original en anglais. Revenez ensuite ici
pour y coller votre traduction !
[[wiki:fr:note|Plus d'informations]] sur la traduction des pages.
===== Credits =====
//If you create translate or modify whole or part of this page, add your name and your email here.//
*//[[|Philippe LAPEYRIE]]//