Zeste de Savoir

Site internet communautaire codé à l'aide du framework Django 1.7 et de Python 2.7.

Voir l'instance en ligne.

Fonctionnalités implémentées

• Tutoriels
• Articles
• Membres
• Forums
• Messages privés
• Galeries d'images
• Recherche

Fonctionnalités à venir

Elles sont reportées essentiellement dans le bugtraker.

Comment démarrer une instance de ZdS ?

Installation d'une version locale de ZdS

• Installation du backend sur Windows
• Installation du backend sur Linux
• Installation du backend sur OS X
• Installation du frontend
• Installation de Solr pour gérer la recherche

Mettre à jour votre version locale de ZdS

Après avoir mis à jour votre dépôt, vous devez exécuter les commandes suivantes (depuis la racine de votre projet) pour mettre à jour les dépendances.

pip install --upgrade -r requirements.txt -r requirements-dev.txt
python manage.py migrate

Données de test

Pour bénéficier de données de test, exécutez les commandes suivantes, dans l'ordre, à la fin des précédentes :

python manage.py loaddata fixtures/*.yaml
python manage.py load_factory_data fixtures/advanced/aide_tuto_media.yaml

Cela va créer plusieurs entitées :

• 6 utilisateurs (utilisateur/mot de passe) :
  • user/user : Utilisateur normal
  • staff/staff : Utilisateur avec les droits d'un staff
  • admin/admin : Utilisateur avec les droits d'un staff et d'un admin
  • anonymous/anonymous : Utilisateur qui permet l'anonymisation des messages sur les forums
  • Auteur externe/external : Utilisateur qui permet de récupérer les tutoriels d'anciens membres et/ou de publier des tutoriels externes.
  • ïtrema/ïtrema : Utilisateur de test supplémentaire sans droit
• 3 catégories
• 11 forums
• 3 sujets avec une réponse
• 1 message privé (MP) avec 3 participants
• 3 catégories et 2 sous-catégories
• 4 aides pour l'écriture des tutoriels

La documentation complète

Voir la documentation en ligne.

La documentation de ZdS est générée par Sphinx, et elle doit être mise à jour à chaque modification ou ajout d'une fonctionnalité du site. Les sources se trouvent ici.

Pour générer la documentation en local, rendez-vous dans le répertoire zds-site/doc/ depuis votre terminal, et lancez la commande make html. Vous pourrez ensuite la consulter en ouvrant le fichier zds-site/doc/build/html/index.html

Conseils de développement

Vous trouverez tout sur la page dédiée de la documentation

En savoir plus

• Comment déployer ZDS sur un serveur de production ?
• Comment contribuer et conseils de développement
• Comment contribuer : comprendre comment suivre le workflow (sur zds)
• Les détails du workflow utilisé sur Zeste de Savoir

Zeste de Savoir est basé sur un fork de Progdupeupl (voir le dépôt Git).