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

Voir l'instance en ligne.

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

Elles sont reportées essentiellement dans le bug tracker.

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

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 --fake-initial

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

Si vous êtes sur Windows, la première commande ne fonctionnera pas, préférez ceci :

python .\manage.py loaddata (dir .\fixtures\*.yaml)
python .\manage.py load_factory_data .\fixtures\advanced\aide_tuto_media.yaml

Cela va créer plusieurs entitées :

• 8 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 ;
  • decal/decal : le compte qui possède un identifiant Profile différent de l'identifiant user pour permettre de tester des cas ou ces id sont différents ;
  • dev/dev : Utilisateur dans le groupe des développeurs ;
• 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 mises en avant sur la page d'accueil.

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

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

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

En contribuant, vous vous engagez à respecter le Code de Conduite Contributeurs.

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