Guide complet pour debutants
C'est quoi Git et GitHub ?
Git GitHub
Un outil installe sur ton PC qui surveille Un site web ([Link]) qui heberge ton code
l'historique de tes fichiers. C'est lui qui repond en ligne pour que tout le monde puisse le voir.
aux commandes dans le terminal. C'est le disque dur en ligne.
Git = l'outil sur ton PC. GitHub = le site qui heberge ton code. Les deux travaillent ensemble.
Etape 0 — Creer le repo sur GitHub EN PREMIER
Erreur classique : Si tu fais toutes les commandes Git sur ton PC sans avoir cree le repo sur GitHub
d'abord, tu obtiendras l'erreur : fatal: repository not found. Toujours creer le repo en ligne AVANT.
1. Aller sur [Link] et se connecter
2. Cliquer sur le "+" en haut a droite → "New repository"
3. Donner un nom exactement comme ton dossier (ex: site-de-reservation-hotelier)
4. Cocher Public
5. NE PAS cocher Initialize with README
6. Cliquer Create repository
Etape 1 — Naviguer vers ton projet dans le terminal
Ouvrir le terminal Windows : touche Windows + R → taper cmd → Entree. Ensuite naviguer vers ton
dossier :
cd Bureau\mon_site
Pourquoi ? Git travaille toujours dans le dossier ou tu te trouves dans le terminal. Si tu ne navigues pas
vers ton projet, les commandes ne fonctionneront pas.
Etape 2 — Creer le .gitignore AVANT tout
Le .gitignore dit a Git quels fichiers NE PAS envoyer sur GitHub. Toujours le faire avant git add .
echo venv/ > .gitignore Cree le fichier .gitignore. Le '>' cree le fichier et ecrit dedans.
Ajoute une ligne. Le '>>' ajoute sans effacer le contenu
echo __pycache__/ >> .gitignore
existant.
Ajoute .env (contient les mots de passe, ne jamais mettre en
echo .env >> .gitignore
ligne).
echo .idea/ >> .gitignore Ajoute le dossier de l'editeur de code (inutile en ligne).
echo db.sqlite3 >> .gitignore Ajoute la base de donnees locale.
Si tu as fait git add . avant le .gitignore : tape 'git rm -r --cached venv' pour retirer le venv de Git sans
le supprimer de ton PC. Puis refais git add . et git commit.
Etape 3 — Les 5 commandes principales
Initialise Git dans ton dossier
Cree un dossier cache .git qui va enregistrer tout l'historique de ton
git init projet. A faire UNE SEULE FOIS par projet. Sans cette commande,
aucune autre commande Git ne fonctionne.
Quand : Une fois par projet uniquement
Prepare les fichiers pour la sauvegarde
Le point '.' signifie 'tous les fichiers'. Cette commande dit a Git :
git add . prends tous mes fichiers et prepare-les pour la photo. Pense a avoir
cree le .gitignore avant.
Quand : Avant chaque commit
Prend une photo du projet
Sauvegarde l'etat actuel de tous tes fichiers avec un message
git commit -m descriptif. Le '-m' signifie 'message'. C'est comme une photo
"message"
etiquetee de ton projet a cet instant precis.
Quand : Apres chaque git add
Lie ton PC a GitHub
Enregistre l'adresse GitHub sous le surnom 'origin'. Tu fais le lien
git remote add origin entre ton dossier local et la boite GitHub en ligne. URL =
URL
[Link]
Quand : Une fois par projet
Envoie tout sur GitHub
'push' = pousser. Envoie tes fichiers sur GitHub. Le '-u' memorise
git push -u origin l'adresse pour la prochaine fois. Apres le premier push avec '-u', tu
main
peux juste taper 'git push'.
Quand : Pour publier en ligne
Etape 4 — Rendre le repo professionnel
Liste toutes les bibliotheques Python utilisees. Un
recruteur voit immediatement Django, scikit-learn,
[Link] pip freeze >
pandas etc. Un developpeur qui clone ton projet
t [Link]
tape 'pip install -r [Link]' et tout s'installe
automatiquement.
La page d'accueil de ton repo sur GitHub. C'est la
premiere chose qu'un recruteur lit. Il doit contenir :
[Link] notepad [Link]
description du projet, technologies utilisees,
fonctionnalites, comment lancer le projet, ton nom.
Liste les fichiers a ne jamais envoyer sur GitHub :
echo venv/ >
.gitignore venv/, __pycache__/, .env, .idea/, db.sqlite3.
.gitignore
Protege ton code et garde le repo propre et leger.
Consulter l'historique de tes commits
Affiche tout l'historique de tes commits avec dates, auteurs et
git log
messages.
git log --oneline Version courte : une ligne par commit. Plus lisible.
git status Montre les fichiers modifies non encore sauveg■■des.
git diff Montre exactement ce qui a change dans les fichiers.
Cloner un projet — c'est quoi et pourquoi ?
Cloner = telecharger une copie complete d'un repo GitHub sur ton PC, avec tout l'historique des
commits.
git clone [Link]
Situation Pourquoi cloner
Tu changes de PC Tu clones ton propre repo pour recuperer ton projet sur la nouvelle machine.
Tu travailles avec quelqu'un Tu clones son repo pour avoir sa version du projet sur ton PC.
Tu trouves un projet interessant Tu clones un repo public pour l'etudier ou l'utiliser.
Travailler a plusieurs sur GitHub
Recupere les derniers changements de ton collegue depuis GitHub vers ton
git pull
PC. A faire avant de commencer a travailler.
Envoie tes changements sur GitHub pour que ton collegue puisse les
git push
recuperer.
git clone URL Telecharge le projet une premiere fois sur ton PC.
Workflow en equipe : git pull → modifier le code → git add . → git commit -m → git push
Recap — Workflow complet du debut a la fin
# Commande Ce que ca fait Quand
0 Creer repo sur GitHub Creer la boite en ligne Tout d'abord
1 cd Bureau\mon_projet Naviguer vers le projet Au debut
2 echo venv/ > .gitignore Ignorer le venv Avant git add
3 git init Initialiser Git Une fois par projet
4 Creer la liste des libs
pip freeze > [Link] Avant git add
5 git add . Preparer les fichiers Avant chaque commit
6 git commit -m "message" Sauvegarder avec message Apres git add
7 git remote add origin URL Lier au repo GitHub Une fois par projet
8 git branch -M main Renommer la branche Si besoin
9 git push -u origin main Envoyer sur GitHub Premier envoi
10 git push Envoyer les updates Apres chaque commit
Erreurs classiques a eviter
Erreur : Ne pas creer le repo Consequence : Erreur : fatal: Solution : Toujours creer le repo
GitHub avant de pusher repository not found sur [Link] AVANT les
commandes.
Erreur : Inclure le venv dans le Consequence : Le repo Solution : Creer le .gitignore avec
commit devient enorme (500Mo+) avec 'venv/' avant le premier git add .
des milliers de fichiers inutiles
Erreur : Mettre des mots de Consequence : Tes donnees Solution : Mettre les mots de
passe dans le code sensibles visibles par tout le passe dans un fichier .env liste
monde dans .gitignore
Erreur : Oublier le -u au Consequence : Devoir retaper Solution : Toujours faire 'git push
premier push 'origin main' a chaque push -u origin main' la premiere fois.
Cours realise par Williams4749 (John William Eyoum Sosso) | Formation Data Science & IA — Localhost Academy |
[Link]/Williams4749