Démarrer un nouveau projet avec Git

Créer un dépôt
→
git clone
→
git add
→
git commit
→
git push
1

Créer un dépôt sur GitHub/GitLab

Cette étape n'est réalisée qu'une seule fois au début du projet.

À cette étape :

  • Vous vous connectez à votre compte GitHub ou GitLab
  • Vous créez un nouveau dépôt (repository) en ligne
  • Vous choisissez un nom pour le dépôt (ex: mon-site-web)
  • Le dépôt est vide, prêt à recevoir vos fichiers

Sur Gitlab :

  • Allez sur gitlab.com et connectez-vous
  • Cliquez sur le bouton "New project"
  • Sélectionnez "Create blank project"
  • Entrez le nom du projet (ex: mon-site-web)
  • Laissez les autres options par défaut (dépôt vide)
  • Cliquez sur "Create project"

Résultat :

  • Vous avez maintenant un dépôt distant vide prêt à recevoir vos fichiers.
  • Copiez l'URL du dépôt (HTTPS) pour l'utiliser lors du clone.
    • Une fois dans votre projet sur gitlab, le bouton CODE permet d'afficher cette URL
2

Cloner le dépôt distant (git clone)

Cette étape n'est réalisée qu'une seule fois au début du projet.

À cette étape :

  • Vous faites un clone du dépôt distant sur votre ordinateur
  • Cette action va créer un dossier local avec le même nom que le dépôt
  • À l'intérieur de ce dossier, un dossier caché .git (configuration Git) sera automatiquement
  • Votre dépôt local est maintenant automatiquement lié au dépôt distant

Commande à exécuter

  1. Sur votre ordinateur, allez dans le dossier où vous souhaitez créer votre projet
  2. Faites un clic droit dans ce dossier et sélectionnez "Ouvrir une fenêtre de commande ici" (ou "Open in Terminal" selon votre système)
  3. Copiez l'URL de votre dépôt distant (celle que vous avez obtenue à l'étape 1)
  4. Exécutez la commande suivante :
git clone https://gitlab.com/votre-nom/mon-site-web.git

Arborescence après le clone

mon-site-web/
.git/ (dossier caché)
(dossier caché)

État de Git

Dépôt local

Dépôt vide, aucun commit

Lié à origin (dépôt distant)

Dépôt distant (origin)

https://gitlab.com/votre-nom/mon-site-web.git

Vide, en attente de fichiers

Après avoir cloné le dossier sur votre ordinateur, vous pouvez maintenant le charger normalement dans Vs code

3

Ajouter les fichiers à la zone de transit (git add)

À cette étape :

  • Vous avez créé vos premiers fichiers dans le dossier du projet ou encore, vous avez copié/collé des fichiers existants
  • Ces fichiers sont "non suivis" (Untracked) par Git
  • Vous utilisez git add pour les ajouter à la zone de transit
  • Les fichiers passent de Untracked (U) à Added (A)

Exemple : création des fichiers du projet

Vous créez les fichiers de base de votre site web :

mon-site-web/
index.html (U)
css/
style.css (U)
img/
logo.png (U)

État de Git avant git add

Fichiers non suivis (Untracked)
index.html
css/style.css
img/logo.png
Zone de transit (Staging)

Vide

Commande à exécuter

git add .

État de Git après git add

mon-site-web/
index.html (A)
css/
style.css (A)
img/
logo.png (A)
Fichiers non suivis (Untracked)

Aucun

Zone de transit (Staging)
index.html
css/style.css
img/logo.png

Ces fichiers feront partie du premier commit.

La commande git add . ajoute tous les fichiers du dossier courant. Vous pouvez aussi utiliser git add nom-du-fichier pour un fichier spécifique.

4

Créer le premier commit

À cette étape :

  • Tous vos fichiers sont dans la zone de transit (Added)
  • Vous exécutez git commit pour créer votre premier commit
  • Le commit enregistre un instantané de tous les fichiers ajoutés
  • Le message décrit le contenu de ce premier commit
  • Vos fichiers sont maintenant sauvegardés localement

Commande à exécuter

git commit -m "Premier commit : structure initiale du site"

Arborescence du projet

mon-site-web/
index.html committed
css/
style.css committed
img/
logo.png committed

État de Git

Dépôt local

Premier commit créé

1 commit prêt à être envoyé vers le dépôt distant

Zone de transit (Staging)

Vide

Historique des commits

a1b2c3d Premier commit : structure initiale du site main

Conseil : Le message du premier commit doit être clair et descriptif. Il marque le point de départ de votre projet.

5

Envoyer les commits vers le dépôt distant (push)

À cette étape :

  • Votre premier commit est sauvegardé localement
  • Vous devez maintenant l'envoyer vers le dépôt distant (GitHub/GitLab)
  • C'est le premier push, vous devez donc configurer la branche principale
  • Une fois le push terminé, votre code est en ligne et sauvegardé

Commande à exécuter

git push -u origin main

L'option -u origin main configure la branche principale. Pour les prochains push, vous pourrez simplement utiliser git push.

État de Git

Avant le push

Dépôt local

1 commit prêt à être envoyé

Dépôt distant (GitLab/GitHub)

Vide, en attente de fichiers

Après le push : synchronisation complète

a1b2c3d Premier commit : structure initiale du site main ↔ origin/main

Félicitations ! Votre projet est maintenant initialisé et synchronisé avec le dépôt distant. Vous pouvez continuer à travailler en utilisant la boucle de travail standard : pull → modifier → add → commit → push.