Lire l’état du dépôt et repérer les branches

Avant de modifier un site en équipe, vous devez savoir où vous vous trouvez dans le dépôt et si des changements locaux sont déjà présents. Une commande lancée sur la mauvaise branche, ou alors que des fichiers sont déjà modifiés, peut compliquer le travail qui suit.

Vous allez examiner l’état du dépôt Git du site Sentiers, puis repérer la branche courante et les autres branches disponibles. Cette vérification ne modifie aucun fichier et constitue un point de départ fiable avant d’ajouter la section « Nouveaux guides ».

1. Vérifier l’état du dépôt

Placez-vous dans le dossier du projet, celui qui contient index.html et style.css, puis demandez à Git de décrire l’état du dépôt. La commande git status indique notamment la branche courante et signale si des fichiers ont été modifiés, ajoutés ou supprimés depuis le dernier commit.

git status

On branch main
nothing to commit, working tree clean

Dans cet exemple, Git annonce que vous êtes sur main et qu’aucun changement local n’est en attente. Le terme arbre de travail désigne les fichiers du projet tels que vous les voyez dans votre dossier ; un arbre propre signifie qu’ils correspondent à l’état enregistré dans le dépôt. Si Git affiche des fichiers modifiés ou non suivis, prenez le temps de les identifier avant de poursuivre.

2. Repérer la branche courante

Une branche est un nom associé à une ligne de développement dans le dépôt. La branche courante est celle sur laquelle vos prochaines opérations de développement s’appliqueront ; dans la sortie précédente, c’est main. Le nom de la branche principale peut varier selon le dépôt : main est courant, mais vous pouvez rencontrer master ou un autre nom défini par l’équipe.

git branch --show-current

main

Cette commande affiche uniquement le nom de la branche courante. Elle est utile lorsque vous souhaitez une réponse rapide, par exemple avant une opération décrite dans une procédure d’équipe. Comparez son résultat à la branche principale indiquée dans votre projet : ne déduisez pas automatiquement son nom à partir d’un exemple de cours.

3. Lister les branches disponibles

La commande git branch liste les branches locales connues dans votre dépôt. Un astérisque placé devant un nom signale la branche courante ; les autres noms correspondent à des branches sur lesquelles le dépôt a déjà travaillé ou qu’il connaît localement.

git branch

* main
  correction-navigation
  essai-maquette

Ici, main est sélectionnée. Les noms correction-navigation et essai-maquette indiquent d’autres branches locales ; leur simple présence ne prouve pas qu’elles sont encore utiles ou à jour. Avant de commencer le travail sur les guides, retenez le nom de la branche principale et vérifiez que l’état affiché par git status est compris.

4. Appliquer la vérification au projet Sentiers

Pour le projet fil rouge, le dépôt contient uniquement index.html et style.css. Cette vérification porte sur les changements Git dans ce dépôt ; elle ne vous demande ni de modifier le HTML ni de créer un fichier supplémentaire. Si des fichiers apparaissent comme modifiés, examinez-les pour déterminer s’ils font partie du travail en cours avant de les inclure dans une nouvelle tâche.

Vous pouvez effectuer les contrôles dans cet ordre : git status pour lire l’état général, git branch --show-current pour confirmer la branche sélectionnée, puis git branch pour voir les branches locales. Si la branche courante n’est pas celle attendue ou si des changements vous sont inconnus, arrêtez-vous et clarifiez la situation avant de poursuivre.

À retenir

• Lancez git status avant de commencer pour repérer les changements locaux et vérifier l’état de l’arbre de travail.
• Repérez la branche courante avec git status ou git branch --show-current.
• Utilisez git branch pour lister les branches locales ; l’astérisque désigne la branche courante.
• Vérifiez le nom réel de la branche principale et clarifiez toute modification inattendue avant de poursuivre.

Dans la leçon suivante, vous créerez une branche dédiée au changement à réaliser sur le site Sentiers.