zds-site icon indicating copy to clipboard operation
zds-site copied to clipboard

Cœur du projet technique de Zeste de Savoir

|Build Status| |Coverage Status| |Requirements Status| |Dependency Status| |Licence GPL|

Qu'est-ce que Zeste de Savoir ?

Zeste de Savoir <https://zestedesavoir.com>__ est un site internet communautaire dédié au partage de la connaissance pour tous. Il est propulsé par le framework Django <https://www.djangoproject.com/>__ et Python <https://www.python.org/>__ 3.

Zeste de Savoir était à l'origine un fork de Progdupeupl (voir le dépôt Git <https://github.com/progdupeupl/pdp_website>__).

Notre projet technique

Notre projet technique est constitué de plusieurs éléments :

  • zds-site <https://github.com/zestedesavoir/zds-site>__, le cœur du projet technique ;
  • zmarkdown <https://github.com/zestedesavoir/zmarkdown>__, notre moteur Markdown amélioré pour les besoins du site ;
  • ansible-zestedesavoir <https://github.com/zestedesavoir/ansible-zestedesavoir>__, notre outil pour déployer Zeste de Savoir sur un serveur de production ;
  • latex-template <https://github.com/zestedesavoir/latex-template>__, notre gabarit LaTeX pour générer des fichiers PDF ;
  • extensions-notificateurs <https://github.com/zestedesavoir/extensions-notificateurs>__, nos extensions de navigateur pour recevoir des notifications.

Contribuer à Zeste de Savoir

Notre documentation technique <https://docs.zestedesavoir.com>__ devrait vous être utile pour bien appréhender notre projet.

Merci de prendre connaissance du Code de Conduite de Contributeurs <https://github.com/zestedesavoir/zds-site/blob/dev/CODE_OF_CONDUCT.md>__ 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 <https://zestedesavoir.com/forums/communaute/dev-zone/>__ ou sur le canal #dev-de-zds de notre Discord <https://discord.gg/ue5MTKq>__ !

Installation

Cette procédure détaillée <https://docs.zestedesavoir.com/install.html>__ 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

  • Contribuer à Zeste de Savoir <https://docs.zestedesavoir.com/contributing.html>__
  • Workflow et détails pratiques <https://docs.zestedesavoir.com/workflow.html>__
  • Un mélange des deux <https://zestedesavoir.com/forums/sujet/324/comment-contribuer-comprendre-comment-suivre-le-workflow/>__

.. |Build Status| image:: https://github.com/zestedesavoir/zds-site/actions/workflows/ci.yml/badge.svg :target: https://github.com/zestedesavoir/zds-site/actions .. |Coverage Status| image:: https://coveralls.io/repos/github/zestedesavoir/zds-site/badge.svg?branch=dev :target: https://coveralls.io/github/zestedesavoir/zds-site?branch=dev .. |Requirements Status| image:: https://requires.io/github/zestedesavoir/zds-site/requirements.svg?branch=dev :target: https://requires.io/github/zestedesavoir/zds-site/requirements/?branch=dev .. |Dependency Status| image:: https://david-dm.org/zestedesavoir/zds-site.svg :target: https://david-dm.org/zestedesavoir/zds-site .. |Licence GPL| image:: https://img.shields.io/badge/license-GPL-blue.svg :target: https://www.gnu.org/licenses/quick-guide-gplv3.fr.html