Installez d'abord toute les dépendances requises.
Ensuite indiquez le répertoire de $KIWI_PROJECT/kiwi dans votre PYTHONPATH. Par exemple sous Ubuntu, il vous faudra ajouter (ou l'éditer si elle existe déja) la ligne suivante à votre fichier $HOME/.profile :
PYTHONPATH=$PYTHONPATH:$HOME/mon/chemin/vers/kiwi
Relancez ensuite votre session ou rechargez votre configuration shell pour que cette modification soit effective. De cette façon Kiwi sera toujours disponible en tant que module Python.
Le projet Kiwi contient deux répertoires qui sont kiwi et examplesite. Le premier est le module Python à installer, le second est un exemple tout prêt pour utiliser Kiwi en tant que site autonome, c'est à dire sans l'importer dans un de vos projet Django.
Dès lors que vous avez suivi toute les étapes précédentes sans problèmes, vous pourrez l'utiliser directement en faisant les commandes suivantes depuis le répertoire examplesite :
(Reportez vous à la documentation de Django pour plus de détails sur les commandes)
python manage.py syncdb
python manage.py runserver 0.0.0.0:8001
Le serveur est accessible sur le nom ou l'adresse IP de votre machine de la façon suivante :
http://votremachine:8001/
Utilisez l'interface d'administration pour remplir votre Wiki avec des documents :
http://votremachine:8001/admin/
Pensez à renseigner dans le modèle Site la bonne URL que vous souhaitez utiliser pour accéder à votre serveur.
Attention, les données comportent déjà un super-utilisateur, vous devez donc avoir répondu non à la question de la commande python manage.py syncdb que vous avez pu faire dans l'étape précédente. Si ce n'est pas le cas, remettez votre base de donnés à zéro et relancez la commande en répondant non cette fois ci.
Pour une démonstration complète avec du contenu, vous pouvez charger les données de la documentation qui sont fournis dans Kiwi. Il vous suffit de lancer la commande suivante depuis le répertoire examplesite :
python manage.py loaddata kiwi_doc.json
Relancez le serveur et voila. Attention, le site configuré utilise le port 8001, si vous en utilisez un autre pensez à le mettre à jour dans le modèle Site.
Il y aura deux utilisateurs déja inscrits :
root, mot de passe root, le super-utilisateur pour pouvoir administrer complètement le site.demo, mot de passe demo, un utilisateur pour la rédaction, qui ne possède que les droits pour ajouter, éditer et supprimer des Documents, ainsi que des Révisions (nécessaire pour supprimer des documents qui y sont liés).Comme Kiwi est installé en tant que module Python de votre PYTHONPATH, il est tout de suite intégrable dans votre projet, la première chose pour l'activer est donc de le rajouter comme application installée dans les settings de votre projet Django, dans INSTALLED_APPS ajoutez donc juste une entrée kiwi.
Ensuite, charge à vous d'intégrer au moins ses urls. Vous pouvez aussi faire vos propres templates en les mettant dans le répertoire templates/kiwi/ de votre projet, ils écraseront ceux déja fournis dans Kiwi.