À propos

“Jekyll and Bootstrap 5 theme for perfectionists. Step-by-step instructions to build your blog, portfolio, and documentation site with no mistakes, unless you’re a n00b.”

Un thème Jekyll pensé pour Docker avec Bootstrap 5, un installateur alimenté par l'IA et des publications sémantiques automatisées — conçu pour que votre premier docker-compose up fonctionne du premier coup, sur n'importe quelle machine.

Qu’est-ce que Zer0-Mistakes ?

Zer0-Mistakes est un thème Jekyll bien pensé — accompagné de son RubyGem (jekyll-theme-zer0) — destiné aux développeurs qui veulent une plateforme de publication moderne, adaptée aux conteneurs et compatible GitHub Pages, qui fonctionne dès le premier essai. Le nom reflète le principe directeur : chaque valeur par défaut, script et workflow de ce projet existe pour éviter aux nouveaux utilisateurs les petites erreurs qui font dérailler une configuration Jekyll.

Il repose sur quatre piliers :

• 🐳 Développement centré sur Docker — docker-compose up est la seule commande dont vous avez besoin pour commencer à coder, quel que soit votre système d’exploitation ou votre version de Ruby.
• 🤖 Installation alimentée par l’IA — un installateur auto-réparateur (install.sh) qui détecte et corrige automatiquement les problèmes d’environnement courants.
• 🎨 Bootstrap 5 + prise en charge du remote-theme — une interface moderne et responsive qui fonctionne sur GitHub Pages sans aucune étape de build personnalisée.
• 🚀 Publications sémantiques automatisées — analyse des conventional commits, génération de changelog et publication du gem en une seule commande.

En bref

Ce monde a été créé par Amr Abdel-Motaleb et est maintenu par :

Et, surtout, propulsé par :

Aperçu de l’architecture

Le thème suit une architecture modulaire en couches. Les sites de production le consomment comme remote theme sur GitHub Pages, tandis que le développement local utilise les mêmes fichiers montés dans un conteneur Jekyll.

flowchart LR
    A[Author writes<br/>Markdown + front matter] --> B{Environment?}
    B -- Local dev --> C[Docker Compose<br/>jekyll serve]
    B -- Production --> D[GitHub Pages<br/>build]
    C --> E[_layouts + _includes<br/>+ _sass + assets]
    D --> F[remote_theme:<br/>bamr87/zer0-mistakes]
    F --> E
    E --> G[Static HTML site]
    G --> H[(Reader's browser)]
    H -. consent .-> I[PostHog<br/>analytics]

Le système de double configuration (_config.yml pour la production, _config_dev.yml pour les surcharges locales) est ce qui permet à la même arborescence source de servir les deux modes sans modification.

Prérequis

Pour exécuter ce site — ou tout site construit sur le gem jekyll-theme-zer0 — en local, vous avez besoin de l’une des chaînes d’outils suivantes :

Recommandé (centré sur Docker) :

• Docker Desktop 4.0+ (ou Docker Engine + Docker Compose v2)
• Git 2.30+

Alternative (Ruby natif) :

• Ruby 3.0+ (3.3 recommandé ; correspond à la matrice CI du gem)
• Bundler 2.x (gem install bundler)
• Git 2.30+

Aucune connaissance préalable de Jekyll n’est requise — l’installateur et le fichier Docker Compose gèrent la résolution des dépendances pour vous.

Démarrage rapide

Le moyen le plus rapide de mettre en place un nouveau site avec ce thème :

# 1. AI-powered one-line install (creates a new site in ./my-site)
curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash -s my-site

# 2. Start the development environment
cd my-site
docker-compose up

# 3. Open http://localhost:4000 in your browser

Si vous préférez ajouter le thème à un site Jekyll existant, insérez ces lignes dans votre Gemfile et votre _config.yml :

# Gemfile
gem "jekyll-theme-zer0"

# _config.yml — for local builds
theme: jekyll-theme-zer0

# _config.yml — for GitHub Pages
remote_theme: bamr87/zer0-mistakes

Puis exécutez bundle install && bundle exec jekyll serve.

Coordonnées

Si vous avez des questions, des commentaires ou des suggestions, n’hésitez pas à nous contacter à :

• 📧 E-mail : amr@zer0-mistakes.com
• 🐛 Problèmes / rapports de bugs : github.com/bamr87/zer0-mistakes/issues
• 💬 Discussions / idées : github.com/bamr87/zer0-mistakes/discussions
• 📦 Gem sur RubyGems : rubygems.org/gems/jekyll-theme-zer0

FAQ

Ai-je besoin de connaître Ruby pour utiliser ce thème ? Non. Si vous utilisez le workflow centré sur Docker ou que vous consommez le thème comme remote theme sur GitHub Pages, Ruby est entièrement abstrait. Vous n’en avez besoin que si vous souhaitez contribuer au thème lui-même.

Est-ce compatible avec GitHub Pages ? Oui. Le _config.yml de production utilise remote_theme: "bamr87/zer0-mistakes", qui figure sur la liste d’autorisation de GitHub Pages. Aucun workflow Actions personnalisé n’est requis pour un déploiement de base.

Pourquoi « zer0-mistakes » ? Le thème cible le niveau n00b (voir level dans _config.yml) et chaque valeur par défaut est choisie pour éviter les erreurs les plus courantes lors de la prise en main de Jekyll : mauvaise version de Ruby, extensions natives cassées, problèmes de Bundler propres à la plateforme et pièges des templates Liquid.

Le site me suit-il ? Les analytics (PostHog) ne se chargent qu’en production et uniquement après que le visiteur a accepté la bannière de consentement aux cookies. Voir _includes/analytics/posthog.html et _includes/components/cookie-consent.html pour l’implémentation complète.

Dépannage

Pour en savoir plus, consultez le README du projet et la documentation de l’installateur auto-réparateur.

Étapes suivantes

Maintenant que vous savez ce qu’est Zer0-Mistakes, voici la suite :

• 🎨 Fonctionnalités du thème — liste complète des composants, mises en page et intégrations
• 🧩 Exemples de composants Bootstrap — extraits d’interface prêts à copier-coller
• 📊 Tableau de bord des statistiques du site — métriques de contenu en temps réel
• ⚙️ Référence de configuration — chaque option _config.yml expliquée
• 🤖 Guide de développement avec l’IA — comment travailler sur ce thème avec Copilot, Codex, Cursor et consorts
• 🚀 Système de publication automatisé — comment sont produits les versions, journaux des modifications et publications de gem

Ressources connexes

• AGENTS.md — point d’entrée multi-outils pour les agents de codage IA
• CONTRIBUTING.md — comment proposer des modifications
• CHANGELOG.md — historique des versions