Zeste de Savoir

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

• Lien du site : zestedesavoir

Fonctionnalités implementées

• Membres
• Tutoriels
• Articles
• 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

• Intallation sur Windows
• Intallation sur Linux
• Intallation sur OS X

Mettre à jour votre version locale de ZdS

Après avoir mis à jour votre dépot, vous devez executer les commandes suivantes (depuis la racine de votre projet) pour mettre à jour les dépendances.

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

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/users.yaml fixtures/forums.yaml fixtures/topics.yaml fixtures/mps.yaml fixtures/categories.yaml

Cela va créer plusieurs entitées :

• 3 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
• 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

Conseils de developpement

Avant de faire une Pull Request (PR), vérifiez que votre code passe tous les tests unitaires et qu'il est compatible PEP-8 en exécutant les commandes suivantes, pour le back :

python manage.py test
flake8 --exclude=migrations,urls.py --max-line-length=120 --ignore=F403,E126,E127,E128 zds

Pour le front :

gulp test

Si vous modifiez le modèle (les fichiers models.py), n'oubliez pas de créer les fichiers de migration :

python manage.py schemamigration app_name --auto

Si vous avez une connexion lente et que vous ne voulez travailler que sur une branche précise, vous pouvez toujours ne récupérer que celle-ci :

git clone https://github.com/zestedesavoir/zds-site.git -b LA_BRANCHE --depth 1

En savoir plus

• Comment déployer ZDS sur un serveur de production ?
• Contribuer
• Comment contribuer : comprendre comment suivre le workflow (sur zds)

Zeste de Savoir est basé sur un fork de Progdupeu.pl (Dépôt Bitbucket).