La commande git config permet de personnaliser/spécifier le comportement par défaut de git
Pour lister la configuration actuellement définie:
git config --list
Les déclarations des variables de configuration peuvent être faites à différents niveaux:
--system | Variables /etc/git/config |
---|---|
--global | Variables définies pour tous les projet de l'utilisateur ~/.gitconfig |
--local | Variables définies sur le projet courant .git/config |
Les variables user.* permettent de définir l'identité du développeur.
Sans argument de modification de la portée, c'est la valeur définie localement qui est affichée:
$ git config user.name Toto $ git config --global user.name Yoann BEZILLE
Dans l'exemple ci dessus, pour le dépot courant l'utilisateur déclaré est Toto, la valeur globale est définie à “Yoann BEZILLE”. Les commits pour ce dépôt seront marqués comme provenant de Toto. Pour d'autres dépôts sur la même machine, si la variable n'est pas définie localement c'est la portée globale qui sera visible, ils seront alors marqués comme émis de “Yoann BEZILLE”
git config --global user.name "Yoann BEZILLE" git config --global user.email contact@example.org
Pour signer le commit, il faut au préalable indiquer à Git quelle clé privée doit être utilisée pour la signature. Le détail d'application de la signature est abordée dans le wiki signer son travail dans Git.
Lister les clés privées enregistrées dans GPG, repérer l'identifiant de la clé à utiliser, c'est celle-ci qu'il faut renseigner pour la variable user.signingkey
gpg2 --list-secret-keys --keyid-format LONG
L'identifiant est une chaîne hexadécimale, on définit la valeur de la variable user.signingkey avec cette chaîne:
git config --global user.signingkey KEY_ID # Spécifier le programme à utiliser, peut éviter certaines erreurs git config --global gpg.program gpg2 # Pour signer systématiquement les commits git config --global commit.gpgsign true
Pour préciser à git que certains fichiers n'ont pas a être suivis on dispose de deux fichiers:
Git lit les variables d'environnement $VISUAL et EDITOR pour déterminer l'éditeur de l'utilisateur. On peut déclarer explicitement son éditeur via la commande suivante:
git config --global core.editor vim
Lors de la création du dépôt, le nom de la branche principale est master. Cette convention tend à disparaitre et on recommande en général la nommer 'main' ou 'trunk'.
Pour que la branche principale soit main lors de la création de tous vos dépôt :
git config --global init.defaultBranch main
Lorsqu'un dépôt vient d' être créer on peut aussi simplement renommer la branche principale via la commande
git branch -m trunk
Confère wiki syntaxe de définition d'alias Git .