Git & GitHub
Une petite page si tu n'as pas encore Git, notamment pour sauvegarder chaque version de tes fichiers.
Certains projets t'invitent aussi à participer via GitHub pour faire relire et corriger ton code.
Sur LearnMSL.dev, ton parcours s'affiche en cliquant sur ton pseudo en haut à droite !
- Le strict minimum pour suivre le cours
- Créer un compte GitHub
- Installer et configurer Git, générer une clé SSH
- Les commandes du quotidien, puis toutes les autres
- Un exemple de fichier .gitignore commenté en bas de page
- Git
- → Logiciel de gestion de versions décentralisé :
Il conserve l'historique des modifications de tous tes fichiers, en particulier textuels. - → Libre et gratuit, créé en 2005 par Linus Torvalds, l'auteur du noyau Linux.
- → Il permet aussi de travailler à plusieurs grâce à un système de branches.
- GitHub
- → Service en ligne qui héberge une copie de ton dépôt local.
- → C'est le plus grand réseau mondial de collaboration pour les programmeurs
→ Et les projets open source.
L'Open Source désigne un modèle de développement où le code source d'un logiciel est public
Et accessible à tous où chacun peut le consulter, le modifier,
L'améliorer et le redistribuer selon les règles fixées par sa licence.
Git est déjà sur ton Mac : il est fourni avec Xcode.
Pour cloner le dépôt du cours — sans compte, sans clé SSH :
## Shell — update:15/10/26
git --version
git clone https://github.com/remdal/Metal-x-C---LearnMSL.dev.git learnmsl.dev-repository
Pour sauvegarder ton propre projet, quatre commandes, toujours dans cet ordre :
## Shell — update:15/10/26
# Qu'est-ce qui a changé ? · What changed? · Wat is er veranderd?
git status
# Tout préparer · Stage everything · Alles klaarzetten
git add .
# Enregistrer une version · Save a version · Een versie opslaan
git commit -m "Ajout caméra"
# Envoyer sur GitHub · Send to GitHub · Naar GitHub sturen
git push
Envoyer ton travail sur GitHub n'est jamais obligatoire.
Connecté, colle l'URL de ton dépôt en bas d'un chapitre.
Marco compile ton projet, fait des captures et te corrige. Je valide ensuite.
Tout le reste de la page sert à aller plus loin.
Créer un compte GitHub
Ce n'est pas obligatoire, mais ça ne coûte rien. Rends-toi sur github.com/signup :
- 1. Identifiants
- → Choisis un nom d'utilisateur public :
Il apparaîtra dans l'URL de tes projets (ex.github.com/tonUserGitHub).
Ajoute une adresse email valide et un mot de passe robuste. - 2. Vérification
- → GitHub t'envoie un code par email pour confirmer l'adresse.
Le plan gratuit suffit largement pour tout ce cours. - 3. Double authentification
- → Une fois connecté, active la 2FA dans Settings → Password and authentication.
Recommandé : c'est ce qui protège ton code (et tes clés SSH) si ton mot de passe fuite un jour.
Installer une version récente de Git
macOS
Le Git fourni par Xcode suffit pour le cours. Homebrew installe une version plus récente :
## Shell — update:15/10/26
# Installer Homebrew (commande officielle, voir brew.sh)
# Install Homebrew (official command, see brew.sh)
# Homebrew installeren (officieel commando, zie brew.sh)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
man brew
# Installe ou met à jour · Installs or updates · Installeert of werkt bij
brew install git
git --version
Le moyen le plus simple et le plus flexible d'installer les outils UNIX qu'Apple n'inclut pas dans macOS.
Il fonctionne aussi sous Linux, sans sudo.
Tu en auras besoin pour assimp et une tonne d'outils de développeur :
hexedit, libpng, imagemagick, pgvector, stripe, ffmpeg-full, …
## Shell — update:15/10/26 — pour les nerds · for the nerds · voor de nerds
man sudo
Configurer Git
Une seule fois par machine :
## Shell — update:15/10/26
git config --global user.name "Ton Nom"
git config --global user.email "ton_email@example.com"
# Le même email que ton compte GitHub
# The same email as your GitHub account
# Hetzelfde e-mailadres als je GitHub-account
git config --global init.defaultBranch main
# Évite les avertissements « master » / « main »
# Avoids the “master” / “main” warnings
# Vermijdt de waarschuwingen “master” / “main”
git config --list
# Vérifie que tout est pris en compte
# Checks that everything is set
# Controleert of alles is ingesteld
Ton travail est précieux : génère une clé SSH pour GitHub
Indispensable pour pousser vers GitHub sans retaper d'identifiants. Inutile pour simplement cloner le cours.
## Shell — update:15/10/26
ssh-keygen -t ed25519 -C "ton_email@example.com"
# Entrée pour l'emplacement par défaut, puis une phrase de passe (facultative)
# Enter for the default location, then a passphrase (optional)
# Enter voor de standaardlocatie, daarna een wachtwoordzin (optioneel)
pbcopy < ~/.ssh/id_ed25519.pub
# Copie la clé publique
# Copies the public key
# Kopieert de publieke sleutel
Rends-toi ensuite dans GitHub → Settings → SSH and GPG keys → New SSH key,
colle le contenu, donne-lui un titre (le nom de ta machine par exemple) et valide.
Ne partage jamais ~/.ssh/id_ed25519 (sans .pub) : c'est ta clé privée.
## Shell — update:15/10/26
ssh -T git@github.com
# Doit répondre : · Should reply: · Moet antwoorden:
# "Hi tonUserGitHub! You've successfully authenticated…"
Vérifie ta configuration
Le meilleur test, c'est de cloner un vrai dépôt en SSH.
Clone celui du cours pour confirmer que Git, ta clé SSH et GitHub sont bien reliés :
## Shell — update:15/10/26
git clone git@github.com:remdal/Metal-x-C---LearnMSL.dev.git learnmsl.dev-repository
Si le clone se termine sans Permission denied (publickey), ta configuration est bonne :
Tu es prêt pour la suite du cours.
Les commandes du quotidien
Git versionne, GitHub héberge :
Toutes ces commandes travaillent en local, sauf clone, pull et push qui parlent à GitHub.
## Shell — update:15/10/26
# Copie un dépôt GitHub sur ton disque
# Copies a GitHub repository to your disk
# Kopieert een GitHub-repository naar je schijf
git clone lien_HTTPS_ou_SSH nom_du_dossier
# Transforme le dossier courant en dépôt Git (crée le dossier caché .git/)
# Turns the current folder into a Git repository (creates the hidden .git/ folder)
# Maakt van de huidige map een Git-repository (maakt de verborgen map .git/ aan)
git init
# Branche actuelle + Changes to be committed, Changes not staged for commit, Untracked files
# Current branch + Changes to be committed, Changes not staged for commit, Untracked files
# Huidige branch + Changes to be committed, Changes not staged for commit, Untracked files
# --ignored ajoute les fichiers ignorés
# --ignored adds the ignored files
# --ignored voegt de genegeerde bestanden toe
git status --ignored
# Prépare tout pour le prochain commit, fichiers cachés compris, sauf le contenu du .gitignore
# Stages everything for the next commit, hidden files included, except what .gitignore lists
# Zet alles klaar voor de volgende commit, verborgen bestanden inbegrepen, behalve wat in .gitignore staat
git add .
# Enregistre une version ; guillemets obligatoires si le message contient un espace
# Saves a version; quotes required if the message contains a space
# Slaat een versie op; aanhalingstekens verplicht als het bericht een spatie bevat
git commit -m "message"
# Envoie tes commits sur le dépôt distant
# Sends your commits to the remote repository
# Stuurt je commits naar de remote repository
git push
# Delta compression using up to 10 threads ← Git compresse sur tous les threads de ton processeur
# Git compresses on every thread of your processor
# Git comprimeert op alle threads van je processor
# Récupère et fusionne les derniers commits du dépôt distant
# Fetches and merges the latest remote commits
# Haalt de laatste remote commits op en voegt ze samen
git pull
# Historique, une ligne par commit
# History, one line per commit
# Geschiedenis, één regel per commit
git log --oneline
# Ce qui a changé et n'est pas encore préparé avec git add
# What changed and isn't staged with git add yet
# Wat er veranderd is en nog niet met git add is klaargezet
git diff
Commandes moins utilisées en solo
## Shell — update:15/10/26
# Liste les branches locales (généralement main) ; -a ajoute les distantes (origin/main)
# Lists local branches (usually main); -a adds remote ones (origin/main)
# Toont de lokale branches (meestal main); -a voegt de remote toe (origin/main)
git branch -a
# Change de branche ; -c la crée d'abord (ancienne syntaxe : git checkout)
# Switches branch; -c creates it first (older syntax: git checkout)
# Wisselt van branch; -c maakt ze eerst aan (oudere syntaxis: git checkout)
git switch nom_de_branche
git switch -c nom_de_branche
# Fusionne cette branche dans la branche actuelle
# Merges that branch into the current one
# Voegt die branch samen met de huidige
git merge nom_de_branche
# Annule les modifications non commitées d'un fichier — irréversible !
# Discards a file's uncommitted changes — irreversible!
# Maakt de niet-gecommitte wijzigingen ongedaan — onomkeerbaar!
git restore fichier
# Arrête de suivre .env sans le supprimer de ton disque
# Stops tracking .env without deleting it from your disk
# Stopt met het volgen van .env zonder het van je schijf te verwijderen
# Les anciens commits le contiennent toujours : s'il a été poussé, change tes secrets
# Older commits still contain it: if it was pushed, change your secrets
# Oudere commits bevatten het nog: als het gepusht is, verander je geheimen
git rm --cached .env
# Force l'ajout malgré le .gitignore
# Forces the add despite .gitignore
# Forceert het toevoegen ondanks .gitignore
git add -f toUpload.png
# Ajoute la ligne .env à la fin du fichier et le crée s'il n'existe pas (man echo)
# Appends the line .env to the file, creating it if needed (man echo)
# Voegt de regel .env toe en maakt het bestand aan indien nodig (man echo)
echo ".env" >> .gitignore
# Ouvre un éditeur de texte (voir setup)
# Opens a text editor (see setup)
# Opent een teksteditor (zie setup)
vim .gitignore
# Liste aussi les fichiers cachés (leur nom commence par un point)
# Also lists hidden files (their name starts with a dot)
# Toont ook verborgen bestanden (hun naam begint met een punt)
ls -a
Premier push d'un dépôt créé en local
Crée d'abord un dépôt vide sur GitHub (New repository), puis :
## Shell — update:15/10/26
git remote add origin git@github.com:tonUserGitHub/tonDepot.git
git branch -M main
git push -u origin main
# -u relie main à origin/main : ensuite, « git push » suffit
# -u links main to origin/main: after that, “git push” is enough
# -u koppelt main aan origin/main: daarna volstaat “git push”
# Corrige aussi :
# Also fixes:
# Lost ook op:
# fatal: The current branch main has no upstream branch.
# Changer l'adresse du dépôt distant (ex. passer de HTTPS à SSH)
# Change the remote's address (e.g. HTTPS to SSH)
# Het adres van de remote wijzigen (bv. van HTTPS naar SSH)
git remote set-url origin git@github.com:tonUserGitHub/tonDepot.git
Les flags, précédés de tirets, sont des options. Les fichiers cachés se distinguent par le point qui débute leur nom.
Exemple de fichier caché .gitignore
## .gitignore — update:15/10/26 — Exemple (dépend du langage)
## .gitignore — update:15/10/26 — Example (language-dependent)
## .gitignore — update:15/10/26 — Voorbeeld (taalafhankelijk)
# Secrets : clés API, mots de passe — à ne jamais pousser
# Secrets: API keys, passwords — never push them
# Geheimen: API-sleutels, wachtwoorden — nooit pushen
.env
# Sessions Flask enregistrées sur le disque
# Flask sessions stored on disk
# Flask-sessies op schijf
flask_session/
# Créé par le Finder de macOS dans chaque dossier ouvert
# Created by the macOS Finder in every folder it opens
# Aangemaakt door de macOS-Finder in elke geopende map
.DS_Store
# Dépendances re-téléchargeables (headers metal-cpp, …)
# Re-downloadable dependencies (metal-cpp headers, …)
# Opnieuw downloadbare afhankelijkheden (metal-cpp-headers, …)
Frameworks/
# Médias lourds : images, modèles 3D, audio
# Heavy media: images, 3D models, audio
# Zware media: afbeeldingen, 3D-modellen, audio
*.m4a
*.mp3
# Tous les fichiers .png
# Every .png file
# Alle .png-bestanden
*.png
# Modèle 3D glTF binaire
# Binary glTF 3D model
# Binair glTF-3D-model
*.glb
# Ancien format 3D Wavefront
# Legacy Wavefront 3D format
# Oud Wavefront-3D-formaat
*.obj
# Texture compressée Khronos
# Khronos compressed texture
# Gecomprimeerde Khronos-textuur
*.ktx
# Tes productions musicales signées
# Your signed music productions
# Je gesigneerde muziekproducties
*.m4a
# Une police d'écriture
# A font
# Een lettertype
font.ttf
# Fichiers générés par la compilation
# Build outputs
# Compilatie-uitvoer
# Fichier objet
# Object file
# Objectbestand
*.o
# En-têtes précompilés (Clang / GCC)
# Precompiled headers (Clang / GCC)
# Voorgecompileerde headers (Clang / GCC)
*.pch
*.gch
# Bibliothèque dynamique macOS
# macOS dynamic library
# Dynamische macOS-bibliotheek
*.dylib
# Bibliothèque statique Windows
# Windows static library
# Statische Windows-bibliotheek
*.lib
# Exécutables
# Executables
# Uitvoerbare bestanden
*.exe
*.out
# Bundle d'application macOS
# macOS application bundle
# macOS-applicatiebundel
*.app
# Shaders compilés : .metal → .air → .metallib
# Compiled shaders
# Gecompileerde shaders
*.air
*.metallib
# Dossiers de build Xcode et réglages personnels
# Xcode build folders and per-user settings
# Xcode-buildmappen en persoonlijke instellingen
build/
DerivedData/
xcuserdata/
# Cache Python
# Python cache
# Python-cache
__pycache__/
# Fichiers propres à ton projet
# Project-specific files
# Projectspecifieke bestanden
# Définitions de templates C++ : à n'ignorer que si elles sont générées
# C++ template definitions: ignore only if generated
# C++-templatedefinities: alleen negeren als ze gegenereerd zijn
*.tpp
# Un script Shell personnel
# A personal Shell script
# Een persoonlijk Shell-script
create_icns.sh
# Données exportées (Excel, Numbers, …)
# Exported data (Excel, Numbers, …)
# Geëxporteerde gegevens (Excel, Numbers, …)
output_metrics.csv
Un # ne commente qu'en début de ligne : *.png # images serait lu comme un motif et n'ignorerait rien.