Configuration de DokuWiki

cette page est périmée ! voir le 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 :

• Numbers : variable de type nombres, ils peuvent être écrits simplement. Exemple : 9
• Strings : variable type chaînes de caractères elles doivent être mises entre apostrophes. Exemple : 'foo bar'
• Booleans : variable de type logique elle peut valoir false (faux) ou true (vrai) ou de façon équivalente 1 ou 0.
• Arrays : 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

<?php
$conf['useacl']      = 1; //Utiliser la liste de contrôle d'accès pour limiter l'accès ?
?>

Il y a maintenant un 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 à interwiki, les crochets inclus, les templates (modèles), les smiley, les abréviations, les entités et les feuilles de styles.

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

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