Configuration GitHub et déploiement

Authentifiez-vous auprès de GitHub, forkez le thème et déployez votre site sur GitHub Pages.

flowchart LR
    A([Machine Setup done]) --> B[gh auth login]
    B --> C[Fork bamr87/zer0-mistakes]
    C --> D[./scripts/fork-cleanup.sh]
    D --> E[docker-compose up]
    E --> F[git push origin main]
    F --> G[GitHub Actions builds site]
    G --> H([username.github.io live 🚀])

Prérequis

• Configuration de la machine terminée (Docker, Git, GitHub CLI)
• Un compte GitHub

Étape 1 — S’authentifier avec GitHub CLI

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

Vérifiez :

gh auth status

Étape 2 — Forker le dépôt

Forkez bamr87/zer0-mistakes dans votre compte. Le plus simple est de le nommer <your-username>.github.io afin que GitHub Pages déploie à la racine de votre domaine — aucun baseurl nécessaire.

Via GitHub CLI :

gh repo fork bamr87/zer0-mistakes --clone
cd zer0-mistakes

Ou via l’interface web de GitHub :

1. Rendez-vous sur github.com/bamr87/zer0-mistakes
2. Cliquez sur Fork → définissez le nom sur <your-username>.github.io
3. Cliquez sur Create fork, puis clonez :

git clone https://github.com/<your-username>/<your-username>.github.io.git
cd <your-username>.github.io

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

Étape 3 — Exécuter le script de nettoyage du fork

L’assistant interactif supprime le contenu spécifique au thème et configure le dépôt pour votre site :

./scripts/fork-cleanup.sh

Il vous demandera le titre de votre site, l’URL, le nom de l’auteur et d’autres paramètres de base, puis les écrira dans _config.yml.

Étape 4 — Démarrer le serveur de développement

docker-compose up

Rendez-vous sur http://localhost:4000 pour confirmer que votre site personnalisé fonctionne.

Étape 5 — Activer GitHub Pages

Dans votre dépôt forké sur GitHub.com :

1. Settings → Pages
2. Source : Deploy from branch
3. Branch : main → / (racine)
4. Cliquez sur Save

Après le premier push, GitHub Actions construit le site et il apparaît à :

https://<your-username>.github.io

Étape 6 — Pousser vos modifications

git add -A
git commit -m "feat: initial site personalization"
git push origin main

Suivez le déploiement : onglet Actions → workflow pages build and deployment.

Workflow Git pour le développement continu

# New feature branch
git checkout -b feat/my-feature

# Make changes, then commit
git add -A
git commit -m "feat(posts): add first blog post"

# Push and open PR
git push origin feat/my-feature
gh pr create --fill

Fusionnez dans main pour déclencher un déploiement Pages.

Dépannage

Forker vers un nom de dépôt différent (pas username.github.io)

Ajoutez baseurl à _config.yml :

baseurl: "/repo-name"
url: "https://username.github.io"

Échec de la construction Pages

# Check the Actions tab in GitHub for build logs
# Common fix: ensure _config.yml has no YAML syntax errors
bundle exec jekyll build --config '_config.yml,_config_dev.yml' --trace

gh auth login échoue

Assurez-vous que le port 443 (HTTPS) est ouvert. Essayez le drapeau --web ou créez un jeton d’accès personnel et utilisez gh auth login --with-token.

Incohérence du remote origin

git remote -v                                       # verify remotes
git remote set-url origin https://github.com/<you>/<repo>.git