Tutoriel

GitHub, de zéro à la mise en ligne

Créer un dépôt, le connecter en SSH (Windows compris), versionner votre code et publier votre site sur GitHub Pages.

1. C’est quoi, GitHub ?

Git est un logiciel de gestion de versions : il photographie votre projet à chaque étape (« commit »), permet de revenir en arrière et de travailler à plusieurs sans s’écraser. GitHub est le service web qui héberge vos dépôts Git en ligne : sauvegarde, partage, collaboration (issues, pull requests) et même hébergement de sites statiques avec GitHub Pages.

Compte gratuit sur github.com/signup. Sous Windows, installez Git pour Windows (qui fournit Git Bash) ; sous Linux, sudo apt install git.

2. Première configuration (une seule fois)

git config --global user.name "Votre Nom"
git config --global user.email "vous@exemple.fr"

Cet e-mail apparaîtra dans vos commits — utilisez le même que votre compte GitHub.

3. Se connecter en SSH (recommandé)

La clé SSH remplace le mot de passe : GitHub reconnaît votre machine. À faire une fois par ordinateur.

Étape A — Générer la clé identique sur Windows (Git Bash), Linux et macOS

ssh-keygen -t ed25519 -C "vous@exemple.fr"

Appuyez sur Entrée pour accepter l’emplacement proposé ; la phrase de passe est facultative.

Étape B — Démarrer l’agent SSH et charger la clé Linux · macOS · Git Bash

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Étape B — Version Windows PowerShell en administrateur, une seule fois

Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

Étape C — Afficher la clé publique pour la copier Linux · macOS · Git Bash

cat ~/.ssh/id_ed25519.pub

Étape C — Version Windows invite de commandes cmd

type %USERPROFILE%\.ssh\id_ed25519.pub

Puis sur GitHub : photo de profil → Settings → SSH and GPG keys → New SSH key → collez la clé → Add SSH key.

Étape D — Vérifier la connexion

ssh -T git@github.com

La réponse « Hi votre-pseudo! You've successfully authenticated » confirme que tout fonctionne.

4. Créer un dépôt et pousser son projet

Sur GitHub : bouton + (en haut à droite) → New repository → nommez-le (ex : mon-site) → Public → Create repository (sans README si vous poussez un projet existant).

cd mon-projet

git init
git add .
git commit -m "Premier commit"

git branch -M main
git remote add origin git@github.com:votre-pseudo/mon-site.git
git push -u origin main

Rechargez la page GitHub : vos fichiers sont en ligne.

Récupérer un dépôt existant sur une autre machine

git clone git@github.com:votre-pseudo/mon-site.git

5. Le cycle de travail quotidien

CommandeRôle
git statusVoir ce qui a changé depuis le dernier commit
git diffDétail ligne par ligne des modifications
git add .Préparer tous les fichiers modifiés (ou les nommer un par un)
git commit -m "message"Photographier l’état préparé, avec un message descriptif
git pushEnvoyer les commits vers GitHub
git pullRécupérer les changements présents sur GitHub

Exemple d’une session de travail

git status
git add index.html styles.css
git commit -m "Ajoute la grille responsive du dashboard"
git push

6. Héberger son site avec GitHub Pages (github.io)

GitHub Pages sert gratuitement les sites statiques (HTML/CSS/JS — parfait pour les TP du module). Deux formules :

Activation : dans le dépôt → Settings → Pages (menu latéral) → section « Build and deployment » → Source : Deploy from a branch → Branch : main et dossier / (root) → Save.

Exemple complet — publier le TP03 en ligne

cd TP_Portail_Captif

git init
git add .
git commit -m "TP03 - portail captif"

git branch -M main
git remote add origin git@github.com:votre-pseudo/tp03-portail-captif.git
git push -u origin main

Puis sur GitHub : Settings → Pages → « Deploy from a branch » → main / (root) → Save.
Quelques minutes plus tard, le site est servi sur https://votre-pseudo.github.io/tp03-portail-captif/.

7. Pour aller plus loin