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.

Vous préférez un navigateur à un terminal ? Le Générateur de site vous guide vers le même résultat étape par étape, avec Claude qui vérifie votre machine, rédige votre configuration et votre contenu, et démarre Docker à votre place.

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 gestion du consentement, désactivé en développement

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/installation/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 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)

Aucun verrouillage platform: n’est défini — Docker construit votre architecture native par défaut, ce qui est le comportement souhaité. Forcer linux/amd64 exécute l’image sous l’émulation QEMU et coûte 3 à 10× plus cher lors des installations et des compilations de gems natives. Si un outil tiers affiche cet avertissement, vous pouvez l’ignorer sans risque. Exportez DOCKER_DEFAULT_PLATFORM=linux/amd64 uniquement lorsque vous avez besoin d’une parité x86 explicite avec la production.

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 la Configuration de la machine → s’il s’agit de votre première fois, ou passez directement aux Options d’installation pour choisir votre parcours.