Annexe GAppendix G
Bijlage G
· Git

Git & GitHub

Objectif de ce chapitreWhat you’ll learn
Wat je leert
  • Le strict minimum pour suivre le coursThe bare minimum to follow the course
    Het strikte minimum om de cursus te volgen
  • Créer un compte GitHubCreate a GitHub account
    Een GitHub-account aanmaken
  • Installer et configurer Git, générer une clé SSHInstall and configure Git, generate an SSH key
    Git installeren en configureren, een SSH-sleutel aanmaken
  • Les commandes du quotidien, puis toutes les autresEveryday commands first, then all the others
    Eerst de dagelijkse commando's, daarna alle andere
  • Un exemple de fichier .gitignore commenté en bas de pageAn annotated .gitignore example at the bottom of the page
    Een becommentarieerd .gitignore-voorbeeld onderaan de pagina
⏱ ~12 min
Git
→ Logiciel de gestion de versions décentralisé :A decentralized version control system:
Een gedecentraliseerd versiebeheersysteem:

Il conserve l'historique des modifications de tous tes fichiers, en particulier textuels.it keeps the history of changes to all your files, text files in particular.
het bewaart de geschiedenis van alle wijzigingen aan je bestanden, vooral tekstbestanden.
→ Libre et gratuit, créé en 2005 par Linus Torvalds, l'auteur du noyau Linux.Free and open source, created in 2005 by Linus Torvalds, the author of the Linux kernel.
Vrij en gratis, in 2005 gemaakt door Linus Torvalds, de auteur van de Linux-kernel.
→ Il permet aussi de travailler à plusieurs grâce à un système de branches.It also lets several people work together thanks to branches.
Het maakt ook samenwerken mogelijk dankzij branches.
GitHub
→ Service en ligne qui héberge une copie de ton dépôt local.An online service that hosts a copy of your local repository.
Een onlinedienst die een kopie van je lokale repository host.
→ C'est le plus grand réseau mondial de collaboration pour les programmeursIt is the world's largest collaboration network for programmers
Het is het grootste samenwerkingsnetwerk ter wereld voor programmeurs

→ Et les projets open source.and open source projects.
en open source-projecten.

L'Open Source désigne un modèle de développement où le code source d'un logiciel est publicOpen Source is a development model in which a program's source code is public
Open Source is een ontwikkelmodel waarbij de broncode van software openbaar en voor iedereen toegankelijk is.

Et accessible à tous où chacun peut le consulter, le modifier,And available to everyone. Anyone can read, modify, improve, and redistribute it
Iedereen kan ze bekijken, wijzigen,

L'améliorer et le redistribuer selon les règles fixées par sa licence.Under the rules set by its license.
Verbeteren en verspreiden volgens de regels van de licentie.

🎯 Le strict minimumThe bare minimum
Het strikte minimum

Git est déjà sur ton Mac : il est fourni avec Xcode.Git is already on your Mac: it ships with Xcode.
Git staat al op je Mac: het wordt meegeleverd met Xcode.

Pour cloner le dépôt du cours — sans compte, sans clé SSH :To clone the course repository — no account, no SSH key:
Om de cursusrepository te klonen — zonder account, zonder SSH-sleutel:

## 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 :To save your own project, four commands, always in this order:
Om je eigen project te bewaren: vier commando's, altijd in deze volgorde:

## 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.Pushing your work to GitHub is never mandatory.
Je werk naar GitHub pushen is nooit verplicht.

Connecté, colle l'URL de ton dépôt en bas d'un chapitre.Signed in, paste your repository URL at the bottom of a chapter.
Aangemeld? Plak de URL van je repository onderaan een hoofdstuk.

Marco compile ton projet, fait des captures et te corrige. Je valide ensuite.Marco compiles your project, takes screenshots, and corrects you. I validate it afterwards.
Marco compileert je project, maakt screenshots en verbetert je. Daarna valideer ik.

Tout le reste de la page sert à aller plus loin.The rest of the page is there to go further.
De rest van de pagina is er om verder te gaan.

Créer un compte GitHubCreating a GitHub Account
Een GitHub-account aanmaken

Ce n'est pas obligatoire, mais ça ne coûte rien. Rends-toi surIt isn't mandatory, but it costs nothing. Go to …
Het is niet verplicht, maar het kost niets. Ga naar …
github.com/signup :

1. IdentifiantsCredentials
Inloggegevens
→ Choisis un nom d'utilisateur public :Pick a public username:
Kies een openbare gebruikersnaam:

Il apparaîtra dans l'URL de tes projets (ex. github.com/tonUserGitHub).it will appear in your projects' URLs (e.g. github.com/yourGitHubUser).
die verschijnt in de URL van je projecten (bv. github.com/jouwGitHubUser).

Ajoute une adresse email valide et un mot de passe robuste.Add a valid email address and a strong password.
Voeg een geldig e-mailadres en een sterk wachtwoord toe.
2. VérificationVerification
Verificatie
→ GitHub t'envoie un code par email pour confirmer l'adresse.GitHub emails you a code to confirm the address.
GitHub stuurt je een code per e-mail om het adres te bevestigen.

Le plan gratuit suffit largement pour tout ce cours.The free plan is more than enough for this whole course.
Het gratis abonnement volstaat ruimschoots voor deze hele cursus.
3. Double authentificationTwo-factor authentication
Tweestapsverificatie
→ Une fois connecté, active la 2FA dans Settings → Password and authentication.Once signed in, enable 2FA in Settings → Password and authentication.
Zodra je bent aangemeld, activeer je 2FA in 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.Strongly recommended: it protects your code (and your SSH keys) if your password ever leaks.
Sterk aangeraden: het beschermt je code (en je SSH-sleutels) als je wachtwoord ooit uitlekt.

Installer une version récente de GitInstalling a Recent Version of Git
Een recente versie van Git installeren

macOS

Le Git fourni par Xcode suffit pour le cours.The Git that ships with Xcode is enough for the course.
De Git van Xcode volstaat voor de cursus.
Homebrew installe une version plus récente :Homebrew installs a more recent version:
Homebrew installeert een recentere versie:

## 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
Homebrew / brew

Tu en auras besoin pour assimp et une tonne d'outils de développeur :You will need it for assimp and a ton of developer tools:
Je hebt het nodig voor assimp en een hoop ontwikkeltools:

hexedit, libpng, imagemagick, pgvector, stripe, ffmpeg-full, …

## Shell — update:15/10/26 — pour les nerds · for the nerds · voor de nerds
man sudo

Configurer GitConfiguring Git
Git configureren

Une seule fois par machine :Once per machine:
Eén keer per 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 GitHubYour Work Is Precious: Generate an SSH Key for GitHub
Je werk is kostbaar: maak een SSH-sleutel aan voor GitHub

Indispensable pour pousser vers GitHub sans retaper d'identifiants.Required to push to GitHub without retyping credentials.
Nodig om naar GitHub te pushen zonder telkens je gegevens in te tikken.
Inutile pour simplement cloner le cours.Not needed just to clone the course.
Niet nodig om de cursus gewoon te klonen.

## 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
Terminal : sortie de ssh-keygen -t ed25519.

Rends-toi ensuite dans GitHub → Settings → SSH and GPG keys → New SSH key,Then go to GitHub → Settings → SSH and GPG keys → New SSH key,
Ga daarna naar 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.paste the content, give it a title (your machine's name, for example), and confirm.
plak de inhoud, geef ze een titel (bijvoorbeeld de naam van je machine) en bevestig.

Ne partage jamais ~/.ssh/id_ed25519 (sans .pub) : c'est ta clé privée.Never share ~/.ssh/id_ed25519 (without .pub): it is your private key.
Deel nooit ~/.ssh/id_ed25519 (zonder .pub): dat is je privésleutel.

## 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 configurationCheck Your Setup
Controleer je configuratie

Le meilleur test, c'est de cloner un vrai dépôt en SSH.The best test is to clone a real repository over SSH.
De beste test is een echte repository via SSH klonen.

Clone celui du cours pour confirmer que Git, ta clé SSH et GitHub sont bien reliés :Clone the course's to confirm that Git, your SSH key, and GitHub are properly connected:
Kloon die van de cursus om te bevestigen dat Git, je SSH-sleutel en GitHub goed verbonden zijn:

## 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 :If the clone finishes without Permission denied (publickey), your setup is fine:
Als het klonen eindigt zonder Permission denied (publickey), is je configuratie in orde:

Tu es prêt pour la suite du cours.you are ready for the rest of the course.
je bent klaar voor de rest van de cursus.

Les commandes du quotidienEveryday Commands
Dagelijkse commando's

Git versionne, GitHub héberge :Git versions, GitHub hosts:
Git beheert de versies, GitHub host ze:

Toutes ces commandes travaillent en local, sauf clone, pull et push qui parlent à GitHub.all these commands work locally, except clone, pull, and push, which talk to GitHub.
al deze commando's werken lokaal, behalve clone, pull en push, die met GitHub praten.

## 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 soloCommands Less Used When Working Solo
Commando's die je solo minder gebruikt

## 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 localFirst Push of a Locally Created Repository
Eerste push van een lokaal aangemaakte repository

Crée d'abord un dépôt vide sur GitHub (New repository), puis :First create an empty repository on GitHub (New repository), then:
Maak eerst een lege repository aan op GitHub (New repository), daarna:

## 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.Flags, prefixed with dashes, are options.
Flags, voorafgegaan door streepjes, zijn opties.
Les fichiers cachés se distinguent par le point qui débute leur nom.Hidden files are recognizable by the dot that starts their name.
Verborgen bestanden herken je aan de punt waarmee hun naam begint.

Exemple de fichier caché .gitignoreAn Example .gitignore Hidden File
Voorbeeld van een verborgen .gitignore-bestand

## .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 :A # only starts a comment at the beginning of a line:
Een # begint alleen een commentaar aan het begin van een regel:
*.png # images serait lu comme un motif et n'ignorerait rien.*.png # images would be read as a pattern and ignore nothing.
*.png # afbeeldingen wordt als patroon gelezen en negeert niets.