Avatars d’auteur

Une liste de commits est un mur de noms, et les noms se lisent lentement. Une image à côté de chacun transforme « qui a écrit ça » en une question à laquelle on répond d’un coup d’œil. Gitcito en met une sur chaque auteur qu’il affiche : dans la colonne auteur du graphe, dans les détails du commit à côté de l’auteur et de chaque co-auteur, dans le sélecteur de co-auteurs pendant la rédaction, dans le sélecteur de profils, et à côté de chaque profil dans les Réglages.

D’où vient l’image

Deux sources, essayées dans cet ordre :

L’avatar généré est une petite créature, pas un carré coloré : le même e-mail produit toujours la même forme et les mêmes couleurs, si bien qu’un auteur reste reconnaissable d’un dépôt à l’autre et d’un redémarrage à l’autre. Deux e-mails différents ne collisionnent pratiquement jamais. Il est dessiné par blobatar (MIT) et n’a besoin d’aucun réseau : un dépôt rempli d’auteurs sans Gravatar obtient quand même un jeu complet de visages distinguables, hors ligne, au premier rendu.

Comme la graine est l’e-mail du commit, un auteur qui commite sous deux adresses obtient deux avatars. C’est volontaire — c’est le même signal que donne la colonne auteur du graphe, et c’est généralement ainsi qu’on repère un compte machine ou un user.email mal configuré. Corrigez-le avec les attributs d’auteur si les deux adresses sont vraiment la même personne.

Le visage de la barre de titre

L’avatar à côté du nom de votre profil est le seul avatar de Gitcito qui représente vous, dans ce dépôt, maintenant — c’est donc le seul qui réagit à l’état du dépôt. Il fait une tête quand il se passe quelque chose, et reste neutre le reste du temps.

Ce à quoi il réagit, le pire d’abord : des fichiers restés en conflit ; une fusion, un rebasage, un cherry-pick ou un revert que git n’a jamais su comment terminer ; un HEAD détaché — alarmé s’il y a du travail non validé dessous, juste hésitant sinon ; des commits qui s’accumulent sans push, ou sans pull depuis le distant ; des modifications qui s’accumulent sans validation ; un tiroir de remisages que personne n’ouvre ; et un dépôt où rien n’est arrivé depuis un mois.

Le pire l’emporte : un dépôt avec des conflits et quarante commits non poussés porte les conflits. Survolez l’avatar et l’infobulle indique exactement ce qui a causé le visage — une image qui change sans raison énoncée est une énigme, pas un signal. C’est l’infobulle qu’on lit ; le visage ne fait que vous faire regarder.

Les seuils sont volontairement élevés. Un visage qui s’inquiète au premier commit non poussé est inquiet en permanence, et un signal permanent est un signal qu’on apprend à ne plus lire. Une branche sans upstream reste neutre plutôt que contente : « synchronisée » n’est pas une affirmation possible pour une branche que personne n’a poussée.

C’est de la décoration, pas de l’instrumentation. La barre d’état porte les vrais décomptes, et c’est elle qu’il faut croire. Le visage dit seulement il se passe quelque chose, d’un coup d’œil.

Mouvement

L’avatar de la barre de titre respire et clignote tout seul. Désactivez-le dans Réglages → Thèmes → Graphe → Animer l’avatar du profil — l’expression continue de suivre le dépôt, elle cesse simplement de bouger. Le mouvement est aussi ignoré automatiquement si votre système demande un mouvement réduit.

Seul cet avatar est animé. Un avatar animé doit être dessiné en SVG vivant plutôt qu’en image mise en cache, ce qui va pour un seul et devient du gâchis pour les plusieurs centaines qu’un graphe dessine au défilement.

Désactiver la recherche

Réglages → Thèmes → Graphe → Afficher les avatars.

Désactivé signifie :

• aucune requête vers gravatar.com, jamais — ni différée, ni mise en cache puis retentée ;
• les avatars apparaissent toujours, tous générés localement.

C’est donc un interrupteur de confidentialité, pas un « masquer les images ». Aucun réglage ne supprime complètement les avatars.

Les limites

• Une recherche Gravatar apprend à gravatar.com que cet e-mail a été consulté. Le hachage n’est pas un secret : quiconque a un e-mail candidat peut le hacher et comparer. Si la liste des auteurs d’un dépôt est quelque chose que vous préférez ne pas confier à un tiers, désactivez la recherche avant de l’ouvrir.
• Gravatar seulement. Les avatars que vous avez téléversés sur GitHub, GitLab ou Bitbucket ne sont pas lus — il faudrait un appel authentifié à l’API de l’hébergeur par auteur, beaucoup de réseau pour une décoration.
• Aucun remplacement. Vous ne pouvez pas épingler une image choisie à un auteur, ni changer le style généré. L’avatar est une fonction de l’e-mail et de rien d’autre.
• Une photo Gravatar n’a pas d’expression. Si l’e-mail de votre profil en a une, la barre de titre affiche la photo et aucun visage — une photographie ne peut pas vous faire la grimace. Désactivez la recherche si vous préférez le blob expressif.
• Le visage ne suit que le dépôt actif. Dans un onglet qui n’est pas un dépôt, il n’y a rien à quoi réagir : il reste neutre.
• Une lecture à la fois. Le visage montre la pire chose trouvée : un dépôt peut donc être en désordre de plusieurs façons et n’afficher qu’une expression. Ce n’est pas une liste d’état — c’est le travail de la barre d’état et de l’infobulle.
• Petit reste petit. Dans la colonne auteur du graphe, l’avatar fait 16px, ce qui porte la couleur et la silhouette mais pas le détail. Les détails du commit dessinent l’auteur à 38px, et c’est là qu’on voit vraiment le visage.

Voir aussi : Thèmes et apparence · Le graphe de commits · Attributs d’auteur · Profils