Parcourir l’historique du site

Quand vous revenez sur un projet après plusieurs modifications, le contenu actuel ne suffit pas toujours à expliquer comment il a évolué. Vous pouvez avoir besoin de retrouver quand les étapes Git ont été documentées, ou de distinguer le premier état du site d’une version plus récente. Git conserve les commits : vous allez apprendre à les parcourir et à reconnaître celui qui correspond au changement recherché.

Afficher l’historique

Placez-vous dans le dossier suivi-site, puis lancez git log. Cette commande affiche les commits du dépôt, du plus récent au plus ancien. Chaque entrée présente notamment un identifiant, l’auteur, la date et le message du commit. Vous avez déjà vu les messages du projet : ils suivent la convention retenue, à savoir une intention par commit et une formulation à l’impératif en français.

cd suivi-site
git log

commit 4c2a8f1... (identifiant illustratif)
Author: Votre Nom <[email protected]>
Date:   ...

    Documenter les étapes Git du projet

commit 9b71d03... (identifiant illustratif)
Author: Votre Nom <[email protected]>
Date:   ...

    Créer la page d’accueil

La sortie ci-dessus est un exemple de présentation, et les identifiants sont fictifs : vos valeurs dépendront de vos commits. Dans le dépôt du cours, le commit « Documenter les étapes Git du projet » est plus récent que « Créer la page d’accueil ». Cette lecture suffit déjà à retrouver l’ordre des versions et à associer un changement à son message.

Rendre la liste plus lisible

Pour examiner rapidement les commits, utilisez l’option --oneline. Elle condense chaque entrée sur une ligne, avec une forme courte de l’identifiant suivie du message. Vous pouvez aussi limiter le nombre d’entrées affichées avec -n, par exemple pour ne voir que les deux commits les plus récents.

git log --oneline
git log --oneline -n 2

4c2a8f1 Documenter les étapes Git du projet
9b71d03 Créer la page d’accueil

La seconde commande affiche uniquement les deux entrées les plus récentes.

Retrouver la version liée à une modification

Supposons que vous cherchiez la version où le projet a reçu une documentation de ses étapes Git. Dans la liste courte, le message « Documenter les étapes Git du projet » identifie directement le commit correspondant. L’identifiant placé à sa gauche permet de le désigner sans ambiguïté, même si plusieurs commits ont des messages proches.

Un historique utile repose sur des messages suffisamment précis. « Documenter les étapes Git du projet » indique mieux le but du commit qu’un message vague comme « Mise à jour ». Quand vous ne savez plus quel changement correspond à une entrée, relisez les messages et comparez-les aux intentions que vous avez enregistrées. Si le nom choisi n’est pas assez explicite, l’historique vous montre aussi pourquoi la convention de commit lisible est importante.

Vous pouvez vérifier que cette exploration n’a pas changé le dépôt en relançant git status, commande étudiée dans la leçon sur la lecture de l’état du dépôt. Si aucun autre travail n’est en attente, Git indique que le répertoire est propre : consulter l’historique ne crée pas de nouvelle version. Vous êtes ainsi prêt à retrouver un commit avant d’aborder les opérations de correction dans les prochaines leçons.

À retenir

• Utilisez git log pour parcourir les commits, du plus récent au plus ancien.
• Utilisez git log --oneline pour lire une liste condensée et git log --oneline -n 2 pour en limiter l’affichage aux deux dernières entrées.
• Associez le message d’un commit au changement recherché, puis relevez son identifiant propre à votre dépôt.
• La consultation de l’historique ne modifie pas le projet ; vérifiez son état avec git status si nécessaire.

Dans la leçon suivante, vous verrez comment écarter une modification locale non préparée lorsque vous avez confirmé qu’elle ne doit pas être conservée.