Git et GitHub sont installés et configurés. Il est temps de créer le projet que vous allez suivre jusqu'à la fin de ce parcours : un tout petit site vitrine, nommé mon-premier-site. Il ne contiendra que trois fichiers pour commencer. C'est amplement suffisant pour apprendre Git correctement, et ça évite de vous perdre dans un projet trop compliqué.

Créer le dossier et ses trois fichiers

Choisissez un emplacement sur votre ordinateur où vous avez le droit d'écrire, par exemple votre dossier Documents. Créez-y un nouveau dossier nommé mon-premier-site, avec votre explorateur de fichiers habituel ou depuis le terminal. À l'intérieur, créez trois fichiers texte : index.html, style.css et README.md.

Ouvrez index.html dans un éditeur de texte et collez ce contenu minimal :

Laissez style.css presque vide pour l'instant, avec juste un commentaire :

Et donnez à README.md un contenu très court, qui décrit le projet :

Ce dossier existe maintenant sur votre disque, mais Git n'en sait encore rien. Rien ne le distingue, pour l'instant, d'un dossier contenant des photos de vacances : c'est un dossier ordinaire, sans aucun lien avec Git.

Transformer le dossier en dépôt avec git init

Ouvrez un terminal directement dans ce dossier. Sous Windows, vous pouvez faire un clic droit dans le dossier ouvert dans l'explorateur puis choisir « Ouvrir dans le Terminal », ou naviguer manuellement avec cd. Une fois dans le bon dossier, vérifiez où vous êtes avant d'aller plus loin.

Cette commande crée un dossier caché nommé .git à la racine de votre projet. C'est là que Git va stocker tout ce dont il a besoin : l'historique, les branches, la configuration locale. Vous n'avez jamais besoin d'ouvrir ce dossier ni de modifier son contenu à la main. Ne le supprimez pas non plus : le supprimer effacerait tout l'historique Git du projet, sans toucher à vos fichiers actuels.

Un point important : lancez git init une seule fois, à la racine du projet. N'en relancez pas un dans chaque sous-dossier : un seul dépôt Git suffit pour suivre l'ensemble de mon-premier-site, quels que soient les sous-dossiers que vous ajouterez plus tard.

Votre premier git status

Une fois le dépôt initialisé, demandez à Git ce qu'il observe dans ce dossier.

Ce résultat va être décortiqué en détail dans le prochain guide. Pour l'instant, repérez simplement trois informations : la ligne « On branch main » indique le nom de la branche active, « No commits yet » confirme qu'aucun historique n'existe encore, et la section « Untracked files » liste vos trois fichiers, que Git a bien repérés mais ne suit pas encore.

Et si votre terminal affiche « master » au lieu de « main » ?

Les versions récentes de Git nomment la première branche « main » par défaut. Certaines installations plus anciennes utilisent encore « master ». Les deux noms désignent exactement le même rôle : la branche principale de votre projet. Tout ce parcours utilisera « main », mais si votre terminal affiche « master », vous pouvez continuer à suivre les mêmes commandes sans problème.

Comment vérifier que tout est en ordre

Trois vérifications suffisent avant de continuer. D'abord, la commande git status doit répondre sans erreur du type « not a git repository », ce qui confirmerait que vous êtes bien dans un dossier initialisé. Ensuite, un dossier .git doit exister à la racine de mon-premier-site ; il est caché par défaut, donc activez l'affichage des fichiers cachés dans votre explorateur si vous voulez le voir. Enfin, vos trois fichiers doivent apparaître dans la section « Untracked files » : s'il en manque un, vérifiez qu'il a bien été enregistré et qu'il se trouve dans le bon dossier.

Erreur fréquente

Si git status répond « fatal: not a git repository (or any of the parent directories): .git », c'est que vous avez tapé la commande depuis un autre dossier que celui où vous avez lancé git init. Vérifiez votre position avec cd (sans argument, sous macOS et Linux) ou en regardant le chemin affiché par votre invite PowerShell, puis déplacez-vous dans mon-premier-site.

Chapitre terminé