Développement
Guides pour les développeurs souhaitant contribuer au thème Jekyll Zer0-Mistakes et l'étendre.
Contribuer à Zer0-Mistakes
Cette section fournit des guides pour les contributeurs du thème — les développeurs qui souhaitent contribuer, étendre ou modifier le thème Jekyll Zer0-Mistakes lui-même.
La référence technique approfondie (architecture, scripts, systèmes, mécanismes internes d’automatisation des versions) se trouve dans le
docs/répertoire du dépôt. Cette section fournit l’aperçu accessible aux contributeurs ; le répertoiredocs/contient la référence technique complète.
Premiers pas
Avant de contribuer, assurez-vous d’avoir :
- Docker Desktop installé (recommandé)
- Git configuré avec des clés SSH
- Une compréhension de base de Jekyll et Ruby
Guides pour développeurs
Build et publication
| Guide | Description |
|---|---|
| Gestion des versions | Versionnage sémantique, gestion du changelog et publication de gems |
| Incrémentation de version | Flux de travail automatisé d’incrémentation de version |
| Pipeline CI/CD | Flux d’intégration et de déploiement continus |
Qualité et sécurité
| Guide | Description |
|---|---|
| Tests | Structure de la suite de tests et normes de développement |
| Sécurité | Analyse CodeQL et bonnes pratiques de sécurité |
| Mises à jour des dépendances | Gestion automatisée des dépendances |
Documentation et outillage
| Guide | Description |
|---|---|
| Documentation | Architecture de documentation double et flux de travail |
| Scripts | Bibliothèque d’automatisation de scripts shell |
| PRD | Document d’exigences produit |
Commandes rapides
# Run all tests
./test/test_runner.sh
# Build the gem
./scripts/build.sh
# Create a release
./scripts/release.sh
# Bump version
./scripts/version.sh patch # or minor, major
Flux de développement
graph LR
A[Fork Repo] --> B[Create Branch]
B --> C[Make Changes]
C --> D[Run Tests]
D --> E[Submit PR]
E --> F[Code Review]
F --> G[Merge]
G --> H[Release]
Contribuer
- Forkez le dépôt
- Créez une branche de fonctionnalité (
feature/my-feature) - Effectuez vos modifications avec des tests
- Soumettez une pull request
Consultez CONTRIBUTING.md pour des directives détaillées.
Connexe
Voir aussi
- [[Docker]]
- [[Jekyll]]
- [[Customization]]
- [[Installation]]