svn:Configuration

Dernière modification : 2008/07/28 15:07

Configuration de WiKiss

Tout se fait en modifiant le fichier _config.php à la racine de votre installation.
Voici la liste des paramètres :

Ajustement des heures / fuseaux horaires

Peut-être avez-vous remarqué après quelques essais que les heures affichées ne sont pas véridiques. Cela veut donc dire que l'heure du serveur que vous utilisez (où se situent vos fichiers) ne correspond pas avec l'heure chez vous. Pour changer ceci, très simple.
Ouvrir le fichier index.php dans un éditeur de texte (Notepad sous Win32, TextEdit sous MacOS, ou équivalent) et se rendre à la ligne 8 où se trouve la variable LOCAL_HOUR. Cela représente le nombre d'heures entre vous et le serveur sur lequel est hébergé votre wiki. Si l'heure est par exemple 14:00 et que chez vous, il est 11:00, inscrivez entre les guillemets -3.

Protection par mot de passe

Attention Le mot de passe par défaut est test, Pensez à le changer !

Si vous ne souhaitez pas que vos pages soient modifiables par n'importe qui, assignez alors une valeur à la variable PASSWORD (ligne 3). Cela ajoutera un champ mot de passe dans l'édition des pages.
Si votre wiki doit être en accès libre, affectez une chaine vide ("") à cette variable.
L'utilisation d'un mot de passe est fortement recommandée.

Droits d'écriture

WiKiss se base sur les droits d'accès du système de fichier pour savoir si une page est en écriture ou non. Vous devez donc utiliser la commande chmod pour modifier ces droits.
Pour verrouiller une page, effectuez un CHMOD 444 sur le fichier de votre choix (généralement dans le répertoire pages de votre installation). Vous verrez alors Page verrouillée en lieu et place du lien Éditer.
Pour la déverrouiller, faites un CHMOD 775.

Historique des pages

Pour ne pas utiliser le système d'historique automatique, ne spécifiez pas la variable BACKUP_DIR du fichier de configuration. Il n'y aura alors aucune sauvegarde de l'historique. Le répertoire historique est alors inutile.

Encodage

L'encodage des pages est en utf-8. L'ancienne variable CHARSET de TigerWiki est maintenant inutile.

Langue

La langue par défaut de votre Wiki est contenue dans la variable LANG. Elle conditionne aussi les pages Wikipédia affichées avec la syntaxe [?Wiki].
Pour plus de détails sur le changement de langue de l'interface et la gestion de plusieurs Langues, voyez la page dédiée.

Format des dates

Vous pouvez changer celui-ci avec la variable TIME_FORMAT. Pour les détails sur la syntaxe voir la documentation de php

Personnalisation de l'interface

Pour tout ce qui touche WiKiss esthétiquement, cela se passe dans le fichier template.html et sa feuille de style par défaut style.css. Voici la liste des balises (valeurs entre accolades) et ce qu'elles affichent :
  • WIKI_TITLE : Titre de votre wiki.
  • PAGE_TITLE_BRUT : Nom de la page actuellement affichée.
  • PAGE_TITLE : Identique à la valeur précédente, sauf avec un hyperlien vers celle-ci.
  • LAST_CHANGE : Affichage de texte avant la date de modification.
  • TIME : Affichage de la date et de l'heure de la dernière modification de la page actuellement visitée.
  • HOME : Lien vers la page principale de votre wiki.
  • RECENT_CHANGES : Lien vers la page listant les dernières modifications effectuées.
  • EDIT : Lien vers le mode d'édition.
  • HELP : Lien vers la page Aide.
  • HISTORY : Lien vers le mode historique listant toutes les modifications effectuées sur la page éditée.
  • CONTENT : Contenu de la page demandée.
  • ERROR : Espace d'affichage d'erreur.
  • SEARCH : Champ et bouton de recherche interne.
  • WIKI_VERSION : Affichage de la version utilisée.
  • DATE : L'heure et la date actuel (Le contenu de l'affichage peut être modifié via la variable TIME_FORMAT).
  • IP : Adresse IP de l'utilisateur actuel.
  • COOKIE : Affichage de l'option d'effacement du cookie de mot de passe (affiché si existant).
  • : table des matières (si demandée pour cette page)
Chacune de ces variables peuvent être déplacée sans problème.

Les variables contenant du texte d'affichage peuvent être modifiées dans le fichier _config.php (pour modifier la langue d'affichage par exemple).

Décoration des balises

À partir de WiKiss 0.3, certaines balises peuvent être entourées de décorations qui ne seront utilisées que si la balise est utile dans le contexte de la page. Cela permet par exemple d'intégrer des balises dans une liste.
Les balises concernées sont :
  • HOME
  • RECENT_CHANGES
  • EDIT
  • HELP
  • HISTORY
  • TOC
Dans le fichier de template, il suffit d'ajouter du texte à l'intérieur des accolades :
 {<li>HELP</li>} 

ainsi, le texte d'aide sera intégré dans une liste HTML si il est présent dans la page affichée. À noter en restriction le texte devant la balise ne doit pas comporter d'accolade fermante : }

Cela est aussi valable pour certains plugins :

Cette documentation est principalement recopiée de la documentation de TigerWiki


%TOC%