01
Quelle est la différence entre Git, GitHub et SSH ?
GitGitHubSSH
Bienvenue dans cette première fiche ! Avant de commencer à coder, il est essentiel de comprendre les outils que nous allons utiliser tout au long de ce parcours. Tu vas découvrir les trois piliers du développement moderne : Git (le gestionnaire de versions), GitHub (la plateforme de collaboration en ligne) et SSH (le protocole de connexion sécurisée), ainsi que la différence entre HTTPS et SSH.
FICHE 1
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
🔀Git vs GitHub
Git est un outil de gestion de versions en local. GitHub est une plateforme en ligne pour héberger et partager tes projets Git.
☁️Dépôt local vs distant
Le dépôt local vit sur ton ordinateur (privé, rapide). Le dépôt distant vit sur GitHub (accessible partout, sauvegardé).
🔐Pourquoi SSH ?
- Connexion sécurisée
- Pas de mot de passe à chaque fois
- Authentification par clé
- Idéal pour les développeurs
HTTPS vs SSH
| HTTPS | SSH | |
|---|---|---|
| Sécurité | Chiffré, mais moins sécurisé | Très sécurisé avec clé |
| Authentification | Identifiant + mot de passe | Clé SSH |
| Idéal pour | Projets simples | Projets pro & collaboratifs |
💡 EN RÉSUMÉ
Git suit les modifications en local.
→ GitHub héberge ton projet en ligne.
→ SSH sécurise la connexion entre ton ordinateur et GitHub.
02
Comment installer Git sur Windows en quelques clics ?
InstallationWindowsgit-scm.com
Passons à la pratique ! Dans cette fiche, tu vas télécharger et installer Git sur ton ordinateur Windows depuis le site officiel, avec les options par défaut recommandées, puis vérifier que tout fonctionne avec une simple commande dans le terminal.
FICHE 2
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
1Télécharger
Va sur git-scm.com et clique sur « Download for Windows ».
2Installer
Ouvre le fichier téléchargé et clique sur Next à chaque étape (options par défaut), puis Install.
3Vérifier
$ git --version
git version 2.44.0.windows.1
⭐ CONSEIL
Utilise toujours Git Bash (recommandé) ou le Terminal pour exécuter les commandes Git.
03
Pourquoi Git a-t-il besoin de connaître ton identité ?
git configIdentité.gitconfig
Une étape rapide mais essentielle. Git a besoin de savoir qui tu es pour associer chaque commit à ton identité. Tu vas configurer ton nom et ton email une seule fois, et cette configuration s'appliquera automatiquement à tous tes futurs projets sur cet ordinateur.
FICHE 3
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Commandes à exécuter
git config --global user.name "Baba Niang"
git config --global user.email "baba.niang@email.com"
git config --list
💡 À quoi ça sert ?
- Informations ajoutées automatiquement à chaque commit.
- Identifie l'auteur des modifications.
- Configuration à faire une seule fois.
✅ BONNE PRATIQUE
Utilise toujours ton vrai nom ou un pseudo professionnel et une adresse email valable.
04
Comment une clé privée et une clé publique s'authentifient-elles ?
SSHClé privéeClé publique
Avant de générer quoi que ce soit, comprenons le mécanisme. SSH repose sur une paire de clés : une privée que tu gardes secrète, et une publique que tu partages avec GitHub. Cette fiche t'explique comment elles dialoguent ensemble pour t'authentifier sans jamais transmettre de mot de passe.
FICHE 4
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
🔒Clé privée
Reste secrète sur ton ordinateur. Jamais partagée, elle prouve que c'est bien toi.
🔑Clé publique
Partagée avec GitHub. Stockée là-bas pour vérifier ton identité.
🤝Authentification
GitHub envoie un défi chiffré que seule ta clé privée peut résoudre. S'il est correct, l'accès est autorisé.
🏠 Analogie simple
Clé privée = ta clé de maison, tu ne la donnes à personne. Clé publique = la copie que tu donnes à GitHub pour qu'il te reconnaisse.
💡 À RETENIR
SSH utilise une paire de clés : une privée (secrète) et une publique (partagée).
05
Quelle commande crée une paire de clés SSH sécurisée ?
ssh-keygened25519
Place à la pratique ! Tu vas utiliser ssh-keygen avec l'algorithme moderne ed25519 pour créer ta paire de clés en une seule commande, sans rien avoir à configurer manuellement.
FICHE 5
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
La commande
ssh-keygen -t ed25519 -C "email@gmail.com"
Ce que ça crée
🔑 Clé privée : ~/.ssh/id_ed25519
🔑 Clé publique : ~/.ssh/id_ed25519.pub
⭐ BONNE PRATIQUE
Utilise toujours l'algorithme ed25519. Ne partage jamais ta clé privée !
06
À quoi sert l'agent SSH au quotidien ?
ssh-agentssh-add
L'agent SSH, ta mémoire de session. Il garde ta clé privée en mémoire pendant que tu travailles, pour éviter de la ressaisir à chaque connexion. Tu vas le démarrer, y ajouter ta clé, puis récupérer ta clé publique à copier sur GitHub.
FICHE 6
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
1Démarrer l'agent
eval "$(ssh-agent -s)"
2Ajouter la clé
ssh-add ~/.ssh/id_ed25519
3Afficher la clé publique
cat ~/.ssh/id_ed25519.pub
⭐ BONNE PRATIQUE
Ne partage jamais ta clé privée ! Seule la clé publique (.pub) doit être ajoutée sur GitHub.
07
Où colle-t-on la clé publique sur GitHub ?
GitHub SettingsSSH keys
Direction les paramètres GitHub. Tu vas te rendre dans Settings → SSH and GPG keys, cliquer sur « New SSH key », donner un titre à ta clé, puis coller le contenu complet de ta clé publique pour autoriser la connexion.
FICHE 7
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
1Se connecter à GitHub
2Settings
3SSH and GPG Keys
4New SSH Key
5Coller la clé publique
6Add SSH key
⭐ À RETENIR
La clé privée reste sur ton PC. Ne la partage jamais !
08
Comment vérifier que ta clé SSH fonctionne vraiment ?
ssh -TDiagnostic
Le grand test ! Avec une seule commande, tu vas vérifier que GitHub reconnaît bien ta clé et que tu peux te connecter sans mot de passe. On regarde aussi les erreurs les plus fréquentes et comment les corriger.
FICHE 8
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Tester la connexion
$ ssh -T git@github.com
Hi BabaNiang! You've successfully authenticated,
but GitHub does not provide shell access.
⚠️ Erreurs fréquentes
| Problème | Solution |
|---|---|
| Permission denied | Clé non ajoutée à GitHub. |
| Connection timed out | Problème réseau/pare-feu. |
🚀 PROCHAINE ÉTAPE
Fiche 9 — Cloner un dépôt avec SSH.
9.0
Quelles 3 commandes pour créer et se placer dans un dossier ?
mkdircdpwd
On démarre un vrai projet ! Avant de parler Git, il faut un dossier où travailler. Tu vas apprendre les 3 commandes terminal indispensables : créer un dossier, y entrer, et vérifier où tu te trouves.
FICHE 9.0
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
📁mkdir
Crée un dossier. mkdir MonProjet
📂cd
Se déplace dans un dossier. cd MonProjet
📍pwd
Affiche le chemin actuel. pwd
⚡
Astuce : mkdir MonProjet && cd MonProjet fait les deux d'un coup.
💡 À RETENIR
mkdir crée, cd déplace, pwd affiche le chemin.
09
Que fait vraiment la commande git init ?
git init
Le vrai point de départ. git init transforme un simple dossier en dépôt Git capable de suivre l'historique de tes modifications. Tu vas voir ce qui se cache derrière cette commande et le dossier .git qu'elle crée.
FICHE 9
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
La commande
$ git init
Initialized empty Git repository in C:/Users/Baba/MonProjet/.git/
Ce qui se passe
Git crée un dossier caché .git contenant la configuration, l'historique des commits, les branches et tous les objets nécessaires.
⭐ À RETENIR
git init = point de départ d'un projet Git. Le dossier .git est caché, ne le modifie jamais !
09
Comment récupérer un projet distant sur ta machine ?
git cloneSSH
Autre point de départ possible : le clone. Plutôt que de partir de zéro, tu peux récupérer un projet déjà existant sur GitHub. Tu vas copier son URL SSH et utiliser git clone pour obtenir une copie locale complète, avec tout l'historique.
FICHE 9
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
La commande
git clone git@github.com:username/nom-du-depot.git
⚠️ Erreurs courantes
| Permission denied | Clé SSH non configurée. |
| Repository not found | URL incorrecte. |
💡 À RETENIR
Clone = copie complète du dépôt distant. SSH = connexion sécurisée sans mot de passe.
10
Comment relier un dépôt local existant à GitHub ?
git remotegit push
Le pont entre local et distant. Si tu as créé ton projet avec git init, il faut maintenant le relier à un dépôt GitHub vide avec git remote add origin, puis envoyer ton code avec git push.
FICHE 10
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
1Associer
git remote add origin URL
2Branche main
git branch -M main
3Envoyer
git push -u origin main
⭐ À RETENIR
origin = ton dépôt GitHub, main = branche principale.
11
Quelles commandes Git utilise-t-on tous les jours ?
addcommitpushpullbranch
Ta boîte à outils Git. Cette fiche récapitule les commandes que tu utiliseras au quotidien : add, commit, push, pull, log, clone, branch et remote. Garde-la sous la main comme antisèche !
FICHE 11
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
＋git add
Ajoute à la staging area.
✎git commit
Enregistre dans l'historique.
↑git push
Envoie vers GitHub.
↓git pull
Récupère depuis GitHub.
💡 À RETENIR
Maîtriser ces commandes te permet de travailler efficacement et de collaborer sereinement.
12
Untracked, Staged, Modified... comment s'y retrouver ?
UntrackedStagedModified
La commande que tu vas taper 100 fois par jour. git status te montre l'état actuel de ton dépôt : quels fichiers sont modifiés, staged ou non-suivis. Comprendre ce cycle de vie t'évite bien des surprises avant un commit.
FICHE 12
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Le cycle de vie d'un fichier
📄
UNTRACKEDgit add →
➕
STAGEDgit commit →
✔️
UNMODIFIEDmodification →
✏️
MODIFIED📌 À RETENIR
git status te dit toujours où en sont tes fichiers. Toujours vérifier avant de commit !
13
Pourquoi une étape intermédiaire avant le commit ?
git addStaging area
Le tri avant l'archivage. git add déplace tes modifications vers la zone de staging pour décider précisément ce qui sera inclus dans le prochain commit — fichier par fichier, ou même bloc par bloc avec git add -p.
FICHE 13
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
git add <fichier>
Ajoute un seul fichier précisément.
git add .
Ajoute tous les fichiers modifiés.
git add -p
Ajoute seulement certaines parties (hunks).
📌 À RETENIR
Seul ce qui est dans la staging area sera inclus dans le commit.
15
Comment empêcher Git de suivre tes fichiers sensibles ?
.gitignorenode_modules.env
Un dépôt propre est un dépôt professionnel. Le fichier .gitignore indique à Git quels fichiers ou dossiers ignorer complètement : dépendances lourdes, variables d'environnement sensibles, fichiers temporaires. Tu vas apprendre à l'écrire et à vérifier qu'il fonctionne.
FICHE 15
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Exemple de fichier
# Dépendances
node_modules/
# Environnement
.env
.env.*
# Temporaires
*.log
dist/
✅ Bonnes pratiques
- Ne jamais pusher de données sensibles.
- Adapte-le à chaque projet.
- Commite-le dans ton dépôt.
- Révise-le régulièrement.
🛡️ RÈGLE D'OR
Ne versionne que l'essentiel. Ignore le reste.
16A
Qu'est-ce qu'une branche concrètement ?
git branchgit switchHEAD
Travaille en toute sécurité. Les branches te permettent de développer une fonctionnalité sans jamais risquer de casser main. Tu vas découvrir le concept de pointeur (HEAD) et les deux commandes clés : git branch pour créer, git switch pour se déplacer.
FICHE 16A
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Commandes essentielles
| Action | Commande |
|---|---|
| 🔀 Créer une branche | git branch feature/login |
| ⇄ Changer de branche | git switch feature/login |
| ☰ Voir toutes les branches | git branch |
💡 À RETENIR
HEAD = ta position actuelle sur la dernière branche courante.
16B
Quelles sont les bonnes pratiques de nommage des branches ?
Bonnes pratiquesWorkflow
La pratique en exemple. Cette suite te montre un exemple complet dans le terminal, avant/après, et surtout les bonnes pratiques pour nommer et gérer tes branches comme un vrai développeur.
FICHE 16B
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
✅ Bonnes pratiques
- Noms clairs : feature/login, fix/bug-auth
- Une branche = une fonctionnalité
- Supprime les branches inutilisées : git branch -d nom
- Ne travaille jamais directement sur main
💡 Un bon workflow
main → nouvelle branche → développement → merge → suppression
📌 À RETENIR
Une branche est un pointeur sur un commit. main reste stable et prête pour la production.
17A
Qu'est-ce qu'un Fast-Forward Merge ?
git mergeFast-Forward
Réunir les historiques. git merge intègre le travail d'une branche dans une autre. Dans le cas le plus simple, le Fast-Forward, main avance simplement jusqu'au dernier commit de la branche fusionnée, sans créer de commit supplémentaire.
FICHE 17A
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Exemple dans le terminal
$ git checkout main
$ git merge feature
Fast-forward
👍 Avantages
- Historique linéaire
- Propre et simple
- Facile à lire
⭐ À RETENIR
Fast-Forward = pas de commit de merge, main avance simplement.
17B
Que se passe-t-il quand les branches ont divergé ?
3-Way MergeMerge commit
Quand ça ne peut plus avancer simplement. Si les deux branches ont chacune évolué, Git crée un commit de merge (3-Way Merge) pour réunir les deux historiques. Tu vas voir la différence avec le Fast-Forward et les bonnes pratiques associées.
FICHE 17B
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Comparaison rapide
| Type | Fast-Forward | 3-Way |
|---|---|---|
| Commit de merge créé ? | ✗ Non | ✓ Oui |
| main avance simplement ? | ✓ Oui | ✗ Non |
⚠️ ATTENTION
Un merge propre aujourd'hui, évite des problèmes demain !
18
Comment lire les marqueurs <<<<<<< HEAD ?
Conflit<<<<<<< HEAD
Ne panique pas ! Un conflit apparaît quand Git ne sait pas quelle version garder. Tu vas apprendre à lire les marqueurs de conflit, choisir la bonne version, et valider ta résolution méthodiquement.
FICHE 18
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Étapes pour résoudre
1Ouvrir le fichier
2Choisir et modifier
3Enregistrer
4git add
5git commit
🛡️ RÈGLE D'OR
Comprendre → Choisir → Modifier → Valider → Tester. Reste calme et méthodique.
19
Que fait git pull en une seule commande ?
git pullgit fetchgit merge
Dernière fiche du parcours ! git pull = git fetch + git merge en une commande : il télécharge les nouveautés du dépôt distant et les intègre dans ta branche locale. Réflexe indispensable avant de commencer à travailler.
FICHE 19
🔍 Clique sur l'image pour l'agrandir
Explication détaillée
Exemple
git pull origin main
Fast-forward
Quand l'utiliser ?
- Avant de commencer à travailler.
- Pour récupérer le travail des autres.
- Régulièrement, pour éviter les conflits.
🚀 ASTUCE BONUS
Lance git pull origin main puis git status pour être toujours à jour.
🎉 Bravo, tu as termine les 22 premieres fiches !
Tu maitrises maintenant Git, GitHub et SSH de A a Z. Continue avec les fiches de collaboration pour travailler en equipe !
20
Comment ajouter quelqu'un a ton projet ?
GitHubCollaboratorsInvitation
Travailler a plusieurs, c'est la force de GitHub. Dans cette fiche en 7 etapes, tu vas apprendre a inviter un collaborateur sur ton repository : ouvrir les parametres, rechercher un utilisateur, envoyer l'invitation et verifier qu'elle a bien ete prise en compte.
20A
20B
20C
20D
20E
20F
20G
Etape par etape
20A / 20G
Ouvrir le repository sur GitHub
💡 A RETENIR
Ouvrir Settings → Collaborators → Add people
→ Rechercher par nom d'utilisateur
→ Choisir le role (read/write/admin)
→ Envoyer et verifier l'invitation
21
Comment rejoindre le projet d'un autre developpeur ?
GitHubInvitationAccepter
Tu as recu une invitation ! Quelqu'un t'a invite a collaborer sur son repository. Cette fiche te guide etape par etape : depuis la reception de la notification jusqu'a la verification que tu as bien acces au projet.
21A
21B
21C
21D
Etape par etape
21A / 21D
Verifier la notification d'invitation
💡 A RETENIR
Les invitations arrivent dans tes notifications GitHub
→ Ouvrir l'invitation → Accepter
→ Verifier l'acces au repository
22
Comment gerer qui a acces a ton repository ?
GitHubAccesPermissionsPublic vs Prive
Maitriser les acces, c'est maitriser ton projet. Cette fiche t'explique comment comprendre qui a acces a ton repository, voir les collaborateurs, ajouter ou retirer une personne, et comprendre la difference entre un projet public et prive.
22A
22B
22C
22D
22E
Etape par etape
22A / 22E
Comprendre qui a acces au repository
💡 A RETENIR
Verifie regulierement qui a acces a tes projets
→ Tu peux ajouter ou retirer des collaborateurs a tout moment
→ Public = visible par tous ; Prive = uniquement les collaborateurs
23
Comment plusieurs developpeurs travaillent-ils sur le meme projet ?
CollaborationRolesgit pullgit push
Le vrai pouvoir de Git : le travail d'equipe. Cette fiche t'explique les roles dans un projet collaboratif (proprietaire vs collaborateur), comment chacun travaille sur son ordinateur, et comment synchroniser le travail de toute l'equipe avec git pull et git push.
23A
23B
23C
23D
23E
23F
Etape par etape
23A / 23F
Role du proprietaire du repository
💡 A RETENIR
Le proprietaire gere les acces et la configuration du repo
→ Chaque collaborateur travaille sur son ordinateur
→ git pull pour recuperer, git push pour envoyer
→ Synchronisez regulierement pour eviter les conflits
🎉 Tu maitrises la collaboration GitHub !
Continue avec la Partie 10 : les Pull Requests, les Issues, l'organisation du travail d'equipe et le Fork.
24
Comment proposer et fusionner des modifications sur GitHub ?
GitHubPull RequestMergeReview
La Pull Request est le coeur de la collaboration GitHub. Cette fiche en 13 etapes te guide tout au long du processus : creer une branche, l'envoyer sur GitHub, ouvrir une Pull Request, demander une review, la modifier, la fusionner puis supprimer la branche.
24A
24B
24C
24D
24E
24F
24G
24H
24I
24J
24K
24L
24M
Etape par etape
24A / 24M
Introduction aux Pull Requests
💡 A RETENIR
Creer une branche → coder → push → ouvrir une PR
→ Decrire clairement le but de la PR
→ Demander une review et repondre aux commentaires
→ Fusionner puis supprimer la branche
25
Comment signaler et suivre des problemes ou des idees ?
GitHubIssueBugFeature
Les Issues sont le systeme de suivi des taches d'un projet GitHub. Cette fiche en 9 etapes te montre comment comprendre une Issue, la creer, decrire un probleme clairement, ajouter des labels, commenter, fermer une Issue et la relier a une Pull Request.
25A
25B
25C
25D
25E
25F
25G
25H
25I
Etape par etape
25A / 25I
Comprendre une Issue
💡 A RETENIR
Une Issue = une tache, un bug ou une idee
→ Titre clair + description detaillee + labels
→ Assigner a une personne responsable
→ Commenter pour faire avancer la discussion
→ Fermer l'Issue une fois resolue
26
Comment structurer et suivre le travail collaboratif ?
GitHubProjectsLabelsAssignation
Organiser le travail, c'est s'assurer que tout le monde sait quoi faire. Cette fiche en 6 etapes t'explique comment voir les taches du projet, utiliser les labels, assigner une tache, suivre l'avancement, relier une Issue a une Pull Request et fermer automatiquement une Issue avec une PR.
26A
26B
26C
26D
26E
26F
Etape par etape
26A / 26F
Voir les taches du projet
💡 A RETENIR
GitHub Projects = tableau Kanban pour visualiser le travail
→ Les labels categorisent les Issues (bug, feature, etc.)
→ Assigner une tache a un responsable clair
→ "Closes #N" dans une PR ferme automatiquement l'Issue
27
Comment creer une copie independante d'un depot ?
GitHubForkContributionOpen Source
Fork = cloner le depot de quelqu'un d'autre dans ton propre compte GitHub. C'est la base de la contribution open-source : tu fork un projet, tu travailles sur ta copie, puis tu ouvres une Pull Request pour proposer tes modifications au projet d'origine.
Fiche Fork
27
Fork — Creer une copie independante d'un depot GitHub
💡 A RETENIR
Fork = copie independante d'un depot dans TON compte
→ Ideal pour contribuer a un projet open-source
→ Apres fork : clone, branche, code, push, PR
→ Le projet d'origine n'est jamais modifie directement