Documentation de Zeste De Savoir
Qu’est-ce que Zeste de Savoir ?
Zeste de Savoir est un site internet communautaire dédié au partage de la connaissance pour tous. Il est propulsé par le framework Django et Python 3.
Zeste de Savoir était à l’origine un fork de Progdupeupl (voir le dépôt Git).
Notre projet technique
Notre projet technique est constitué de plusieurs éléments :
zds-site, le cœur du projet technique ;
zmarkdown, notre moteur Markdown amélioré pour les besoins du site ;
ansible-zestedesavoir, notre outil pour déployer Zeste de Savoir sur un serveur de production ;
latex-template, notre gabarit LaTeX pour générer des fichiers PDF ;
extensions-notificateurs, nos extensions de navigateur pour recevoir des notifications.
Contribuer à Zeste de Savoir
Notre documentation technique devrait vous être utile pour bien appréhender notre projet.
Merci de prendre connaissance du Code de Conduite de Contributeurs et de le respecter pour garder ce projet ouvert et accueillant !
Nous contacter
N’hésitez pas à discuter avec nous sur le forum Dev Zone de Zeste de Savoir ou sur le canal #dev-de-zds
de notre Discord !
Installation
Cette procédure détaillée devrait vous permettre d’installer le projet en autonomie. Si vous rencontrez des difficultés, n’hésitez pas à nous contacter !
Conseils pour débuter
Sommaire
- Guides pas-à-pas
- Installation
- Contribuer à Zeste de Savoir
- Workflow et détails pratiques
- Le back-end
- Documentation technique du back-end
- Le front-end
- API
- Makefile et autres outils
- Makefile
- Raffraichir le nombre de caractère d’un contenu
- Anonymisation des +/-1
- Paramètrer le moteur de Captcha
- Le chargement de jeux de données (fixtures)
- Générer les PDFs des différents contenus
- Intégration du reformatage du code Python avec Git
- Commande de nettoyage des alertes et notifications
- Installer un plugin de recherche à votre navigateur
- Générer les rapports de release
- Selenium
- Problème de lenteur lors du dev ?