Scroll to navigation

TERMINAL-COLORS.D(5) Formats de fichier TERMINAL-COLORS.D(5)

NOM

terminal-colors.d - Configurer la coloration de sortie pour plusieurs utilitaires

SYNOPSIS

/etc/terminal-colors.d/[[nom][@term].][type]

DESCRIPTION

Les fichiers de ce répertoire déterminent le comportement par défaut pour les utilitaires lors de la coloration de la sortie.

Le nom est un nom d’utilitaire. Le nom est facultatif et si aucun n’est indiqué, alors le fichier est utilisé pour tous les utilitaires non indiqués.

Le term est un identifiant de terminal (la variable d’environnement TERM). L’identifiant de terminal est facultatif et si aucun n’est indiqué, alors le fichier est utilisé pour tous les terminaux non indiqués.

Le type est un type de fichier. Les types de fichier pris en charge sont les suivants.

disable

Désactiver la coloration de sortie pour tous les utilitaires compatibles.

enable

Activer la coloration de sortie ; tous les fichiers correspondants à disable sont ignorés.

scheme

Indiquer les couleurs utilisées pour la sortie. Le format de fichier peut être spécifique à l’utilitaire, le format par défaut est décrit ci-dessous.

Si plusieurs fichiers correspondent pour un utilitaire, alors le fichier avec le nom de fichier le plus spécifique est prioritaire. Par exemple, le nom de fichier « @xterm.scheme » est moins prioritaire que « dmesg@xterm.scheme ». La priorité la plus basse est pour les fichiers sans nom d’utilitaire ni identifiant de terminal (par exemple, « disable »).

$XDG_CONFIG_HOME/terminal-colors.d_ ou $HOME/.config/terminal-colors.d spécifiques à l’utilisateur remplacent les réglages globaux.

FORMAT DE FICHIERS SCHÉMA PAR DÉFAUT

Les déclarations suivantes sont reconnues.

nom couleur

Le nom est un nom logique de suite de couleur (par exemple, « error »). Les noms sont spécifiques aux utilitaires. Pour plus de précisions, consultez toujours la section COULEURS dans la page de manuel de l’utilitaire.

La couleur est un nom de couleur, suites de couleurs ANSI ou séquences d’échappement.

Noms de couleur

black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, magenta, red, reset, reverse et yellow.

suites de couleurs ANSI

Les suites de couleurs sont composées de suites de nombres séparés par des points-virgules. Les codes les plus habituels sont :

0 pour restaurer les couleurs par défaut
1 pour des couleurs plus brillantes
4 pour du texte souligné
5 pour du texte clignotant
30 pour un premier plan noir
31 pour un premier plan rouge
32 pour un premier plan vert
33 pour un premier plan jaune (ou brun)
34 pour un premier plan bleu
35 pour un premier plan pourpre
36 pour un premier plan cyan
37 pour un premier plan blanc (ou gris)
40 pour un fond noir
41 pour un fond rouge
42 pour un fond vert
43 pour un fond jaune (ou brun)
44 pour un fond bleu
45 pour un fond pourpre
46 pour un fond cyan
47 pour un fond blanc (ou gris)

Séquences d’échappement

Pour indiquer les caractères de contrôle ou blanc dans les suites de couleur, la notation d’échappement \ de type C peut être utilisée :

\a Sonnerie (ASCII 7)
\b Retour arrière (ASCII 8)
\e Échappement (ASCII 27)
\f Saut de page (ASCII 12)
\n Saut de ligne (ASCII 10)
\r Retour chariot (ASCII 13)
\t Tabulation (ASCII 9)
\v Tabulation Verticale (ASCII 11)
\? Suppression (ASCII 127)
\_ Espace
\\ Barre oblique inverse (\)
\^ Chapeau (^)
\# Dièse (#)

Remarquez que des protections sont nécessaires pour entrer une espace, une contre-oblique, un accent circonflexe ou n’importe quel caractère de contrôle n’importe où dans la chaîne, ainsi que pour un croisillon si c’est le premier caractère.

Par exemple, pour utiliser un arrière-plan rouge pour les messages d’alerte dans la sortie de dmesg(1), utilisez :

echo 'alert 37;41' >> /etc/terminal-colors.d/dmesg.scheme

Commentaires

Les lignes où le premier caractère non blanc est un # (croisillon) sont ignorées. Toutes les autres utilisations du caractère croisillon ne sont pas interprétées comme introduisant un commentaire.

ENVIRONNEMENT

TERMINAL_COLORS_DEBUG=all

Activer la sortie de débogage.

FICHIERS

$XDG_CONFIG_HOME/terminal-colors.d

$HOME/.config/terminal-colors.d

/etc/terminal-colors.d

EXEMPLE

Désactiver la couleur pour tous les utilitaires compatibles :

touch /etc/terminal-colors.d/disable

Désactiver la couleur pour tous les utilitaires compatibles sur un terminal vt100 :

touch /etc/terminal-colors.d/@vt100.disable

Désactiver la couleur pour tous les utilitaires compatibles sauf dmesg(1) :

touch /etc/terminal-colors.d/disable

touch /etc/terminal-colors.d/dmesg.enable

COMPATIBILITÉ

La fonctionnalité terminal-colors.d est actuellement prise en charge par tous les utilitaires d’util-linux qui fournissent une sortie en couleur. Pour plus de précisions, consultez toujours la section COULEURS dans la page de manuel de l’utilitaire.

SIGNALER DES BOGUES

Pour signaler un bogue, utilisez le gestionnaire de bogues sur <https://github.com/util-linux/util-linux/issues>.

DISPONIBILITÉ

terminal-colors.d fait partie du paquet util-linux qui est disponible sur l’archive du noyau Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.

2023-07-24 util-linux 2.39.1