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
    Turns off output colorization for all compatible utilities. See also the NO_COLOR environment variable below.

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 séquence-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.

NO_COLOR
    if defined, this disables output colorization unless explicitly enabled by a command-line option. See for more details. Supported since util-linux version 2.41.

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

DISPONIBILITÉ

terminal-colors.d fait partie du paquet util-linux qui est disponible sur