README.md

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
• 5 unes misent en avant sur la page d'accueil

Pour en savoir plus sur cette commande, consulter la documentation.

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).