Guide de démarrage rapide

Faites fonctionner votre site Jekyll zer0-mistakes en moins de 5 minutes. Choisissez le parcours qui correspond à votre objectif :

flowchart TD
    A([Start]) --> B{What's your goal?}
    B --> C[New site, local dev]
    B --> D[Personal GitHub Pages site]
    B --> E[Add theme to existing repo]
    B --> F[Zero-install / cloud]

    C --> C1["Option A: Install wizard\ncurl … | bash + docker-compose up"]
    C --> C2["Option B: GitHub Template\ngh repo create --template"]
    D --> D1["Option D: Fork/Clone\ngh repo fork + fork-cleanup.sh"]
    E --> E1["Option E: Remote theme\nremote_theme: bamr87/zer0-mistakes"]
    E --> E2["Option F: Ruby Gem\ngem 'jekyll-theme-zer0'"]
    F --> F1["Option C: Codespaces\nOne click, browser-based"]

⚡ Démarrage le plus rapide (1 commande)

mkdir my-site && cd my-site
curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash
docker-compose up

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

Ce que vous obtenez

• Environnement Docker — configuration de développement cohérente sur macOS, Linux et Windows (WSL)
• Bootstrap 5.3.3 — intégré, responsive, compatible mode sombre
• Rechargement en direct — le navigateur se met à jour à chaque enregistrement de fichier
• Compatible GitHub Pages — poussez vers main, le site se déploie automatiquement
• Analytique respectueuse de la vie privée — PostHog avec barrière de consentement, désactivée en dev

Options d’installation

Option A — Assistant d’installation

mkdir my-site && cd my-site
curl -fsSL https://raw.githubusercontent.com/bamr87/zer0-mistakes/main/install.sh | bash
docker-compose up

Option B — Modèle GitHub

1. Rendez-vous sur github.com/bamr87/zer0-mistakes
2. Cliquez sur Use this template → Create a new repository
3. Clonez votre nouveau dépôt et exécutez docker-compose up

Ou via le CLI :

gh repo create my-site --template bamr87/zer0-mistakes --clone
cd my-site && docker-compose up

Option C — GitHub Codespaces

Ou : page du dépôt → Code → Codespaces → Create codespace on main.

Option D — Fork/Clone (site personnel)

Forkez dans <your-username>.github.io pour obtenir votre propre site GitHub Pages :

gh repo fork bamr87/zer0-mistakes --clone
cd zer0-mistakes
./scripts/fork-cleanup.sh   # interactive config wizard
docker-compose up

Activez Pages : Settings → Pages → Branch: main → Save.

Consultez docs/FORKING.md pour le guide complet fork → configuration → personnalisation.

Option E — Thème distant

# _config.yml
remote_theme: "bamr87/zer0-mistakes"
plugins:
  - jekyll-remote-theme

Activez GitHub Pages dans les Settings → Pages de votre dépôt.

Option F — Gem Ruby

# Gemfile
gem "jekyll-theme-zer0"

# _config.yml
theme: "jekyll-theme-zer0"

bundle install && bundle exec jekyll serve

Guides de configuration

Dépannage rapide

Port 4000 déjà utilisé

lsof -i :4000          # see what's running
docker-compose down    # stop any existing containers
docker-compose up      # restart

Avertissements de plateforme Docker (Apple Silicon)

C’est normal — docker-compose.yml définit déjà platform: linux/amd64. Le site fonctionne normalement.

Erreurs de compilation Jekyll

docker-compose exec jekyll bundle exec jekyll doctor
docker-compose exec jekyll bundle exec jekyll build --trace

Validez votre configuration :

docker-compose exec -T jekyll bundle exec jekyll build \
  --config '_config.yml,_config_dev.yml'

Besoin d’aide ?

Commencez par Configuration de la machine → s’il s’agit de votre première fois, ou passez directement aux Options d’installation pour choisir votre parcours.