Installation

Dernière modification : 2007/10/30 19:19

Installation de WiKiss


Prés-requis

Le seul prés-requis pour utiliser WiKiss (outre un serveur web) est PHP5.

Pour une bonne gestion de l'utf-8, il est recommandé que le module mbstring soit compilé avec php.

Téléchargement

Vous pouvez télécharger :
décompressez alors le fichier obtenu dans un répertoire temporaire.

Configuration

Il suffit d'éditer le fichier _config.php et de changer les valeurs à votre convenance.
Voir Configuration pour plus de détails.

Pensez à changer le mot de passe par défaut qui est test

Installation

Transférez l'ensemble des fichiers sur votre serveur web par exemple avec un client ftp.
Selon la configuration de votre hébergeur, il se peut que les droits ne soient pas corrects. Pour corriger cela faites un chmod 775 sur tous les fichiers et répertoires.

Et voila !

Vous pouvez maintenant utiliser votre WiKiss.

Migration depuis WiKiss

0.2.1 → 0.3

  1. Sauvegardez vos pages, votre historique et votre fichier _config.php
  2. copiez le fichier index.php dans votre wiki
  3. si vous avez modifié votre template, une nouvelle balise est nécessaires : RSS, de même des décorations peuvent être ajoutées autour de certaines balises
  4. sinon, copiez simplement les fichiers style.css et template.html
  5. enfin copiez le nouveau répertoire plugins ainsi que son contenu
  6. aucune modification de votre ancien _config.php n'est nécessaire
Note : le format des ancres sur les titres à changé, il faut donc modifier ceux que vous auriez fait à la main (cela n'impacte pas les tables des matières)

Procédure générique

Avant toute chose, sauvegardez vos pages, votre historique et votre fichier _config.php.

Si vous mettez à jour une version antérieure de WiKiss, deux possibilités s'offrent à vous :

Copiez simplement tous les fichiers dans votre ancienne installation. Mais attention vous perdrez les pages Acceuil, Aide votre configuration (_config.php) ainsi que les éventuelles personnalisations de votre template.
Il vous faudra alors les récupérer via votre historique et votre sauvegarde préalable.
Cette méthode est déconseillée.

Pour faire une mise à jour de granularité plus fine, suivez cette procédure :
  1. Sauvegardez vos pages, votre historique et votre fichier _config.php
  2. copiez le fichier index.php dans votre wiki
  3. si vous n'avez pas personnalisé votre interface, copiez aussi style.css et template.html
  4. si besoin (voir Changelog) ajoutez les nouveaux paramètres nécessaires dans _config.php

Migration depuis TigerWiki


Plusieurs incompatibilités sont présentes entre TigerWiki 2.2x et WiKiss 0.2 :
  • le contenu des pages est maintenant en utf-8
  • le nom des pages est maintenant en utf-8
  • la syntaxe des titres a changée (! est maintenant de type h1 au lieu de h3)
Un outil automatique de conversion est la pour vous aider. Voici la procédure :
  1. sauvegardez vos pages et historique : copiez dans un endroit sur les répertoires pages/ et historique/
  2. sauvegardez votre fichier de configuration : _config.php
  3. installez WiKiss en suivant la procédure ci-dessus
  4. recopiez vos pages, vos historiques dans votre nouvelle installation
  5. recopiez vos variables à partir de votre fichier de configuration (PASSWORD, LANG, LOCAL_HOUR, PAGES_DIR, BACKUP_DIR)
  6. affichez l'outil de conversion en allant sur http://votre.url.fr/votre/wikiss/tigerwiki2wikiss.php. La liste de toutes vos pages ainsi que leur encodage actuel s'affiche
  7. cliquez sur Do It!
  8. vous pouvez aussi écraser votre ancien fichier Aide.txt par celui fournit avec WiKiss, il contient les détails sur les nouvelles syntaxes
  9. vous pouvez maintenant effacer le fichier tigerwiki2wikiss.php
Attention: un bug de php peut vous poser problème. Si vous avez une page dont le dernier caractère est spécial, son historique ne sera plus accessible (par exemple Accentué). Pour le retrouver, il faut renommer le répertoire historique/Accentu en historique/Accentué mais en utf-8. Pour cela vous pouvez recopier le nom de la page (pages/Accentué.txt affiché pages/Accentué.txt si votre système est en iso-8859-15) et renommer historique/Accentué ainsi.