Installation

Dernière modification : -


// 2007/10/30 20:19 / 86.220.228.127
! 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|http://www.php.net/manual/fr/ref.mbstring.php] soit compilé avec php.

!! Téléchargement
Vous pouvez télécharger :
* une [version stable|http://download.tuxfamily.org/wikiss/] (recommandé)
* la version de [développement|http://svn.tuxfamily.org/viewvc.cgi/trunk.tar.gz?root=wikiss_svn&view=tar]
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|?page=Utilisation] votre ''WiKiss''.

!Migration depuis WiKiss
!!0.2.1 --> 0.3
# '''Sauvegardez''' vos pages, votre historique et votre fichier ''_config.php''
# copiez le fichier ''index.php'' dans votre wiki
# si vous avez modifié votre template, une nouvelle balise est nécessaires : RSS, de même des [décorations|?page=Configuration] peuvent être ajoutées autour de certaines balises
# sinon, copiez simplement les fichiers ''style.css'' et ''template.html''
# enfin copiez le nouveau répertoire ''plugins'' ainsi que son contenu
# 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 :
# '''Sauvegardez''' vos pages, votre historique et votre fichier ''_config.php''
# copiez le fichier ''index.php'' dans votre wiki
# si vous n'avez pas personnalisé votre interface, copiez aussi ''style.css'' et ''template.html''
# 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 :
# '''sauvegardez''' vos pages et historique : copiez dans un endroit sur les répertoires ''pages/'' et ''historique/''
# '''sauvegardez''' votre fichier de configuration : ''_config.php''
# installez WiKiss en suivant la procédure ci-dessus
# recopiez vos pages, vos historiques dans votre nouvelle installation
# recopiez vos variables à partir de votre fichier de configuration (PASSWORD, LANG, LOCAL_HOUR, PAGES_DIR, BACKUP_DIR)
# 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
# cliquez sur ''Do It!''
# vous pouvez aussi écraser votre ancien fichier ''Aide.txt'' par celui fournit avec WiKiss, il contient les détails sur les nouvelles syntaxes
# vous pouvez maintenant effacer le fichier ''tigerwiki2wikiss.php''

'''Attention:''' un [bug de php|http://us3.php.net/manual/fr/function.mb-detect-encoding.php#55228] 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.

TOC