installer
Il est facile d'installer µwiki. Le processus se fait en trois temps : télécharger l'archive depuis ce site sur votre machine, modifier quelques paramètres, puis télécharger le dossier depuis votre machine sur votre serveur.
télécharger µwiki
- simplement depuis la fenêtre du navigateur, cliquez sur ce lien : archive et vérifiez son téléchargement qui se fait normalement par défaut sur le bureau de votre ordinateur ;
- décompressez l'archive ce qui produit un dossier dont le nom est du genre « microwiki_aaaammjj » (année, mois, jour), qui devrait être identique à la date présente sur la dernière ligne au bas de cette page ;
- ce dossier contient :
- les éléments essentiels qui contiendront vos données :
- le fichier « config.php », contenant les paramètres de configuration du wiki, modifiables au besoin,
- le dossier « pages » contenant les pages du wiki au format texte pur, et la matière première du wiki,
- le dossier « data » contenant vos images et autres ressources, autre matière première du wiki,
- le dossier « history » contenant des sous-dossiers associés à chaque page et contenant les sauvegardes successives ;
- la mécanique :
- le fichier « index.php », pivot du wiki,
- le dossier « meca », contenant la mécanique du wiki,
- le dossier « themes», contenant quelques thèmes proposés à l'essai,
- le dossier « lightbox, contenant toute la mécanique des effets Lightbox.
- les éléments essentiels qui contiendront vos données :
- et c'est terminé, µwiki est prêt à être paramétré !
paramétrer µwiki
- avec un éditeur de texte "brut" (BlocNote/NotePad sur Windows, TextEdit ou Smultron sur Mac, KEdit sur Linux) ouvrez le fichier « config.php », localisez la ligne (en principe ligne 9) et remplacez le nom "µwiki" par le nom que vous souhaitez donner à votre wiki (sans guillemet !), en conservant bien les guillemets encadrant ce nom, et sans toucher pour l'instant au reste du code, et enregistrez les modifications ;
- modifiez le nom du dossier « microwiki_aaaammjj » en un nom facile à écrire, par exemple : « monwiki ».
- le paramétrage (minimum) de µwiki est terminé !
télécharger votre µwiki sur le serveur
- on suppose que vous avez un compte chez un fournisseur d'accès, par exemple chez free ; dans ce cas votre adresse de site est dans le genre « http://prenom.nom.free.fr/ »,
- et que vous disposez d'un logiciel FTP (Filezilla sur Windows ou Linux, CyberDuck ou Fetch sur Mac) vous permettant de gérer votre compte, et principalement télécharger vers et depuis le serveur ; chez FREE, le serveur FTP s'appelle ftpperso.free.fr ; votre identificateur (prenom.nom) et votre mot de passe (???) vous seront demandés,
- téléchargez par FTP ce dossier dans votre compte sur le serveur,
!!! attention !!!
c'est une bonne idée de créer à la racine de votre compte (à côté de votre dossier microwiki) un dossier vide nommé exactement « sessions » ; certains serveurs en ont besoin, et notamment FREE, pour gérer les sessions, et donc l'identification,- vérifiez le fonctionnement depuis votre navigateur en tapant l'adresse : « http://prenom.nom.free.fr/monwiki/ ».
- vous pouvez maintenant commencer à travailler dans votre µwiki !
mettre à jour µwiki
Même un aussi petit projet que µwiki est appelé à de fréquentes mises à jour. Bonne nouvelle, elles sont totalement indépendantes des données que vous avez créées et qui sont contenues dans le fichier « config.php », le dossier « pages » et le dossier « data ». Les mises à jour sont essentiellement le fait des dossiers de la partie mécanique, meca (pour les aspects techniques) et themes (pour les aspects graphiques), que vous remplacez simplement par ceux que vous trouvez dans la dernière archive microwiki.
personnaliser µwiki
Les chaines de caractères qui s'affichent dans les boutons texte et autres messages (au départ écrits en français) peuvent facilement être modifiées, et traduites dans d'autres langues. L'opération est réalisée dans le fichier « strings.php » de façon analogue à la modification du titre dans le fichier « config.php » ; ne procédez à cette manip que si vous savez ce que vous faites, et faites-en une sauvegarde au préalable, c'est plus prudent. L'encodage du texte (UTF-8) vous donne même la possibilité de créer un µwiki dans un alphabet non occidental comme l'arabe ou le japonais. Intéressé :-) ?