Préférences

Cette page recense tous les réglages de la boîte de dialogue Préférences, onglet par onglet. Chaque ligne renvoie vers la page qui explique la fonctionnalité.

Ouvrir les préférences

• Le bouton en forme de roue dentée (Préférences) dans la barre de titre.
• ⌘, (Ctrl+, sous Windows et Linux), reconfigurable.
• Ouvrir les préférences dans la palette de commandes.
• Sous macOS, yaggui › Préférences….
• Modifier les raccourcis… dans la feuille des raccourcis clavier l’ouvre sur l’onglet Raccourcis.

Les changements s’appliquent immédiatement : il n’y a pas de bouton Enregistrer ni Annuler, seulement Fermer. Les champs de texte sont enregistrés quand vous appuyez sur Enter ou quand vous quittez le champ. Si yaggui refuse une valeur, le réglage reprend sa valeur précédente et un toast « Impossible d’enregistrer la préférence » en donne la raison. Esc ferme la boîte de dialogue, sauf pendant la saisie d’un raccourci, où cette touche annule seulement la saisie.

Apparence

Voir Apparence.

Libellé	Valeurs	Par défaut	Effet
Thème	Système, Clair, Sombre	Système	Clair correspond à Paper, sombre à Graphite. Système suit celui de l’OS en direct. Sans effet avec le style Terminal
Style	Graphite / Paper, Terminal	Graphite / Paper	Terminal est un style dense, en police à chasse fixe, toujours sombre
Contraste élevé	Activé, désactivé	Désactivé	Texte et bordures plus marqués, quel que soit le style
Avatars Gravatar	Activé, désactivé	Désactivé	Affiche les photos Gravatar des auteurs. Envoie à gravatar.com le hash SHA-256 de l’e-mail de chaque auteur. Désactivé : aucune requête
Vider le cache des avatars	Bouton		Supprime les photos téléchargées (« Cache des avatars vidé »)
Densité	Confortable, Compacte	Confortable	Hauteur de ligne de 28 px ou de 22 px
Langue	Système, English, Français	Système	Langue de l’interface, appliquée sans redémarrage. Système utilise la langue de l’OS si elle est prise en charge, sinon l’anglais
Police de l’interface	Nom d’une police installée	Vide (Inter)	Police de l’interface
Police du code	Nom d’une police installée	Vide (JetBrains Mono)	Police des diffs, du code, des SHA et du terminal
Taille du texte	11 à 18 px	13 px	Met à l’échelle tout le texte

Raccourcis

Voir Palette de commandes et raccourcis. Cet onglet modifie keybindings.json, pas la base de données des préférences.

Contrôle	Effet
Filtrer les commandes ou les raccourcis	Filtre par libellé, identifiant d’action ou raccourci
Tout remettre par défaut	Annule toutes les modifications
Modifier (par commande)	Capture un nouveau raccourci ; en cas de conflit, Réassigner ou Annuler
Retirer (par commande)	Laisse la commande sans raccourci
Défaut (par commande)	Rétablit le raccourci par défaut
Enregistré dans	Chemin de keybindings.json

Outils

Voir Outils externes. Chaque ligne, sauf Terminal, a un bouton Tester.

Libellé	Valeurs	Par défaut	Effet
Éditeur	Nom d’un programme ou d’une application, ou chemin	Vide (application par défaut du système)	Ouvre le dépôt ou un fichier
Terminal	Intégré, Externe	Intégré	Ce qu’ouvre le bouton Terminal de la barre d’outils : le panneau du terminal intégré ou le terminal externe
Terminal externe	Configurer… ouvre la boîte de dialogue Terminal	Terminal par défaut du système	Application ou programme utilisé pour les terminaux externes
Outil de diff	Un nom d’outil connu de Git	Vide (diff.tool, puis diff.guitool)	Outil lancé par git difftool
Outil de merge	Un nom d’outil connu de Git	Vide (merge.tool)	Outil lancé par git mergetool

Git

Voir Binaire Git et configuration.

Libellé	Valeurs	Par défaut	Effet
Binaire Git	Chemin d’un exécutable Git, enregistré avec Appliquer	Vide (« Détecté automatiquement » : git du PATH)	Le Git que yaggui exécute. Détection automatique le vide. Une version antérieure à 2.30 est acceptée avec un avertissement ; un chemin qui n’est pas un Git utilisable est refusé

Configuration

Ce ne sont pas des préférences de yaggui : cet onglet modifie les fichiers de configuration propres à Git avec git config. Voir Binaire Git et configuration.

Contrôle	Valeurs	Par défaut
Fichier de configuration	Global (~/.gitconfig), Ce dépôt (.git/config, uniquement depuis l’onglet d’un dépôt)	Global, à chaque ouverture de l’onglet
Réglages courants	Nom (user.name), E-mail (user.email), Stratégie de pull (pull.rebase), Fins de ligne (core.autocrlf), Branche par défaut (init.defaultBranch), Signer les commits (commit.gpgsign), Format de signature (gpg.format), Clé de signature (user.signingkey)	Ce que contient le fichier
Toutes les entrées	Toutes les clés du fichier : ajout, modification, suppression

Comportement

Libellé	Valeurs	Par défaut	Effet
Fetch automatique	Activé, désactivé	Activé	Fait un fetch de tous les remotes du dépôt de l’onglet visible, en arrière-plan ; les onglets en arrière-plan sont en pause. Ignoré pendant qu’une opération s’exécute, et silencieux : aucun toast. Voir Fetch, pull et push
Toutes les (minutes)	1 à 240	10	Intervalle du fetch automatique. Désactivé quand le fetch automatique est désactivé. Les valeurs hors limites sont ramenées dans la plage
Nettoyer au fetch	Activé, désactivé	Activé	Ajoute --prune à chaque fetch : les branches de suivi supprimées sur le remote sont supprimées
Stratégie de pull par défaut	Config Git, Fast-forward seul, Merge, Rebase	Config Git	Utilisée quand vous faites un pull sans choisir. Config Git suit branch.<name>.rebase, pull.rebase et pull.ff, et se rabat sur fast-forward seul
Branches protégées	Noms de branches ou motifs comme release/*	main, master, develop, release/*	Le force push vers ces branches est refusé, et le nettoyage des branches ne les propose jamais. Rétablir les valeurs par défaut restaure la liste par défaut. Une liste vide ne protège rien. Voir Branches
Confirmations	Un interrupteur par confirmation	Tous activés	Voir ci-dessous
Vérifier les mises à jour au démarrage	Activé, désactivé	Demandé au premier lancement	Consulte la dernière release sur github.com à chaque lancement. Désactivé : aucune requête. Voir Mises à jour
Vérifier maintenant	Bouton		Recherche immédiatement une mise à jour
Version	Bouton Nouveautés		Affiche la version en cours d’exécution et ouvre le journal des modifications

Seul un /* final est un joker : release/* correspond à release/1.0 et à release/a/b, mais pas à release lui-même. Toute autre entrée doit correspondre exactement au nom de la branche. Les entrées ne peuvent pas contenir d’espaces, et 100 au plus sont autorisées.

Confirmations que vous pouvez désactiver

Le groupe Confirmations de l’onglet Comportement (« Demander avant ces actions. Le dialogue montre toujours ce qui va se passer. ») comporte quatre interrupteurs :

Interrupteur	Confirmation qu’il commande	Peut être désactivée
Abandonner des modifications	« Annuler tous les changements non indexés ? », abandon de fichiers, de hunks ou de lignes sélectionnés	Oui
Supprimer un tag	« Supprimer le tag nom ? »	Oui
Supprimer un stash	« Supprimer ce stash ? »	Oui
Force push	« Écraser branche ? »	Non : « Toujours demandé : cela réécrit l’historique du serveur. »

Une confirmation désactivée exécute l’action immédiatement. Les autres confirmations sont toujours affichées et n’ont pas d’interrupteur, par exemple : le rebase (« Rebaser branche sur cible ? »), la réécriture de commits dans un rebase interactif, l’abandon d’une opération, la suppression d’une branche ou d’un tag distant, la suppression d’un remote, la publication d’une branche, la suppression d’un workspace, l’annulation quand des modifications locales gênent, la confiance accordée à un dossier (safe.directory) et la suppression d’un verrou d’index. Le reset et la suppression de branche ont leurs propres boîtes de dialogue.

Préférences hors de la boîte de dialogue

Réglage	Où le modifier	Par défaut
Diff côte à côte ou unifié	La barre d’outils de la vue diff, ou ⌘D (Ctrl+D) dans un diff	Côte à côte
Options du diff (retour à la ligne, ignorer les espaces, lignes de contexte, fichier entier, aperçu Markdown)	La barre d’outils de la vue diff	Désactivées, 3 lignes de contexte

Les commandes de palette Thème : suivre le système, Thème : clair et Thème : sombre modifient le même réglage Thème que la boîte de dialogue.

Où sont stockées les préférences

Les préférences ne sont pas dans un fichier settings.json. Elles sont stockées dans la base de données SQLite yaggui.db, dans la table preferences (une ligne par réglage, valeurs en JSON), dans le dossier de configuration de yaggui :

OS	Dossier de configuration
Linux	~/.config/dev.tropico.yaggui (ou $XDG_CONFIG_HOME/dev.tropico.yaggui)
macOS	~/Library/Application Support/dev.tropico.yaggui
Windows	%APPDATA%\dev.tropico.yaggui

La variable d’environnement YAGGUI_CONFIG_DIR remplace ce dossier.

• Les raccourcis sont stockés à part, dans keybindings.json, dans le même dossier ; vous pouvez le modifier à la main. Voir Modifier keybindings.json.
• Les avatars sont mis en cache dans le dossier de cache de l’OS, pas avec les préférences.
• Une valeur illisible ou hors limites reprend sa valeur par défaut. Si la base de données ne peut pas être ouverte, yaggui démarre avec les valeurs par défaut et ne conserve les changements qu’en mémoire : ils sont perdus quand vous quittez.
• Pour réinitialiser toutes les préférences, quittez yaggui et supprimez yaggui.db. Cela fait aussi oublier vos dépôts, vos onglets et vos workspaces. Voir Données et confidentialité.

Il n’existe pas encore d’import ni d’export des préférences.