Jekyll

Jekyll est le générateur de site statique qui propulse Zer0-Mistakes. Cette section couvre tout ce dont vous avez besoin pour travailler efficacement avec Jekyll.

Démarrage rapide

Prérequis

• Suivez le Guide d’installation
• Ayez Docker Desktop en cours d’exécution (ou Ruby + Bundler installés)

Exécuter en local

# With Docker (recommended)
docker-compose up

# Without Docker
bundle exec jekyll serve --config "_config.yml,_config_dev.yml"

Votre site sera accessible à l’adresse http://localhost:4000.

Concepts clés

Structure des répertoires

Fichiers de configuration

Collections de contenu

Zer0-Mistakes organise le contenu en collections sous pages/ :

• _posts/ - Articles de blog
• _docs/ - Documentation
• _quests/ - Tutoriels et parcours d’apprentissage
• _about/ - Pages « À propos »

Commandes essentielles

# Build the site
docker-compose exec jekyll jekyll build

# Build with verbose output
docker-compose exec jekyll jekyll build --verbose

# Check for configuration issues
docker-compose exec jekyll jekyll doctor

# Clean build artifacts
docker-compose exec jekyll jekyll clean

Sujets de documentation

Configuration et installation

• Configuration de Jekyll — Paramètres et options du site
• Front Matter — Métadonnées et options de page
• Coloration syntaxique — Mise en évidence du code
• Pagination — Navigation entre les articles

Fonctionnalités

Consultez la section Fonctionnalités pour :

• Diagrammes Mermaid — Organigrammes et diagrammes
• Mathématiques MathJax — Notation mathématique
• Commentaires Giscus — Commentaires via GitHub Discussions
• Analytique PostHog — Analytique respectueuse de la vie privée

Déploiement

Consultez la section Déploiement pour :

• GitHub Pages — Hébergement gratuit avec GitHub
• Netlify — Fonctionnalités d’hébergement avancées
• Domaine personnalisé — Utilisez votre propre domaine

Ressources

• Documentation officielle de Jekyll
• Dépôt GitHub de Jekyll
• Langage de templates Liquid

Voir aussi

• Ruby et Bundler — Gestion des dépendances Ruby
• Templating Liquid — Référence du langage de templates
• Développement Docker — Flux de travail basé sur les conteneurs

Voir aussi

• [[Liquid]]
• [[Ruby]]
• [[Docker]]
• [[Customization]]
• [[front-matter]]