Veuillez noter que ce projet est liée à un code de conduite des contributeurs. En participant à ce projet vous acceptez de respecter ses termes.
Utilisez le modèle : [Nom_du_lien](url_du_lien) - Descriptif du lien.
Cette liste est ouverte à tous. Y contribuer est simple: vous avez besoin uniquement d'un compte GitHub.
Voici un guide pas à pas pour contribuer à cette liste:
- Rendez vous sur le dépôt de la liste sur GitHub
- Cliquez sur le fichier
README.md
: - Cliquez sur le bouton
edit
: - Vous pouvez éditer le contenu du fichier dans votre navigateur. Assurez vous de suivre les bonnes pratiques ci-dessus. Le fichier utilise le language GitHub Flavored Markdown avec une (introduction pour les débutant et la spécification détaillée pour un usage expert.
- Indiquez dans le formulaire de bas de page pourquoi vous proposez ces changements et cliquez sur "Propose file change":
- Envoyez votre Pull Request.
- Attendez une relecture et répondez aux éventuelles demandes de modification.
- Votre contribution est fusionnée si elle répond à toutes les exigences du projet.
Merci pour votre contribution.
Cette Awesome list est utilisée pour générer un site web statique à l'aide de Mkdocs. Pour tester en local la génération vous avez besoin d'installer nox au préalable. Ensuite nox s'occupe d'installer toutes les dépendances nécessaires dans un environnement virtuel:
$ nox -s docs
Cette commande a deux comportements:
- En mode interactif (typiquement quand vous lancez la commande dans votre terminal),
elle génère le contenu du site statique
et lance un serveur pour le consulter à l'aide de son navigateur en consultant l'URL
http://127.0.0.1:8000/
- En mode non-interactif (dans un script de Continuous Integration par exemple),
elle génère le contenu du site statique dans le répertoire
site
.