Configuration de la machine

Installez les outils dont vous avez besoin avant de commencer le développement Jekyll. Ce guide couvre macOS, Windows et Linux.

Vous préférez une configuration guidée ? Le Site Builder exécute ces mêmes vérifications en direct sur votre machine, affiche la commande d’installation adaptée à votre système d’exploitation, puis vous accompagne dans la configuration et le lancement d’un site complet avec Claude à vos côtés. Cette page est la référence manuelle derrière son étape Prérequis.

flowchart LR
    A([Start]) --> B[Install Docker Desktop]
    B --> C[Install Git]
    C --> D[Configure Git]
    D --> E[Install GitHub CLI]
    E --> F[Authenticate gh]
    F --> G([Ready for Jekyll Setup])

Aperçu des prérequis

Étape 1 — Installer Docker Desktop

Docker exécute votre site Jekyll dans un conteneur isolé afin de ne jamais vous confronter aux conflits de versions de Ruby.

macOS (Homebrew)

brew install --cask docker
# Then open Docker.app to complete setup
open /Applications/Docker.app

Windows (Winget)

winget install Docker.DockerDesktop
# Restart, then launch Docker Desktop from the Start menu

Linux

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker          # apply group without logging out

Vérifier :

docker --version && docker compose version

Étape 2 — Installer Git

macOS

brew install git

Windows

winget install Git.Git

Linux

sudo apt install git       # Debian/Ubuntu
sudo dnf install git       # Fedora/RHEL

Étape 3 — Configurer Git

Remplacez les valeurs ci-dessous par votre véritable nom d’utilisateur GitHub et l’adresse e-mail no-reply issue de github.com/settings/emails :

git config --global user.name "YourGitHubUsername"
git config --global user.email "ID+username@users.noreply.github.com"
git config --global core.editor "code --wait"

Vérifier :

git config --global --list

Étape 4 — Installer GitHub CLI

macOS

brew install gh

Windows

winget install GitHub.cli

Linux

sudo apt install gh        # Debian/Ubuntu (after adding the gh apt repo)
# Full instructions: https://cli.github.com/manual/installation

S’authentifier :

gh auth login
# Choose: GitHub.com → HTTPS → Login with a web browser
# Copy the one-time code shown, press Enter, paste in the browser

Étape 5 — Installer VS Code (recommandé)

macOS

brew install --cask visual-studio-code

Windows

winget install Microsoft.VisualStudioCode

Linux

sudo snap install code --classic

Extensions utiles pour le travail avec Jekyll :

code --install-extension redhat.vscode-yaml
code --install-extension yzhang.markdown-all-in-one
code --install-extension sissel.shopify-liquid
code --install-extension ms-vscode-remote.remote-containers
code --install-extension ms-azuretools.vscode-docker

Tout vérifier

docker --version && docker compose version
git --version
gh --version
code --version

macOS : installer tous les outils avec Homebrew

Si vous êtes sous macOS et que vous n’avez pas encore Homebrew, installez-le d’abord :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Installez ensuite tout en une seule fois :

brew install git gh
brew install --cask docker visual-studio-code

Dépannage

Docker : permission refusée (Linux)

sudo usermod -aG docker $USER && newgrp docker

Docker Desktop ne démarre pas (Windows)

Assurez-vous que Hyper-V ou WSL 2 est activé. Exécutez wsl --install dans une invite PowerShell avec privilèges élevés, puis redémarrez.

Le port 4000 est déjà utilisé

lsof -i :4000          # find the PID
kill <PID>             # free the port

Ressources connexes

• Site Builder — le parcours guidé qui exécute pour vous ces vérifications de prérequis.
• Référence du Site Builder — ce que l’assistant génère, les outils qu’il expose et ses limites de sécurité.
• Configuration de Jekyll — l’étape suivante une fois ces outils installés.