Scroll to navigation

TERMINAL-COLORS.D(5) Formaty plików TERMINAL-COLORS.D(5)

NAZWA

terminal-colors.d - konfiguruje kolorowanie wyjścia różnych narzędzi

SKŁADNIA

/etc/terminal-colors.d/[[nazwa][@terminal].][typ]

OPIS

Pliki w tym katalogu określają domyślne zachowanie narzędzie, przy kolorowaniu ich wyjścia.

Nazwa jest nazwą narzędzia. Nazwa jest opcjonalna, a gdy się jej nie poda, plik jest używany dla wszystkich nieokreślonych gdzie indziej narzędzi.

Termimal jest identyfikatorem terminala (zmienna środowiskowa TERM). Identyfikator terminala jest opcjonalny, a gdy się go nie poda, plik jest używany dla wszystkich nieokreślonych gdzie indziej terminali.

Typ jest typem pliku. Obsługiwane są następujące typy plików:

disable

Turns off output colorization for all compatible utilities. See also the NO_COLOR environment variable below.

enable

Włącza kolorowanie; wszelkie pasujące pliki disable są ignorowane.

scheme

Określa kolory używane do wyjścia. Format pliku może być charakterystyczny dla narzędzia, natomiast domyślny opisano poniżej.

Jeśli istnieje więcej plików pasujących do narzędzia, to wygrywa plik o najbardziej szczegółowej nazwie. Przykładowo plik "@xterm.scheme" ma niższy priorytet niż "dmesg@xterm.scheme". Najniższy priorytet mają pliki bez nazwy narzędzia i identyfikatora terminala (np. "disable").

Globalne ustawienie przesłonią $XDG_CONFIG_HOME/terminal-colors.d lub $HOME/.config/terminal-colors.d danego użytkownika.

DOMYŚLNY FORMAT PLIKÓW SCHEME

Rozpoznawane jest następujące wyrażenie:

nazwa sekwencja-koloru

Nazwa jest logiczną nazwą sekwencji koloru (np. "error"). Nazwy te są charakterystyczne dla narzędzi. Więcej szczegółów zawierają rozdziały KOLORY podręczników systemowych poszczególnych narzędzi.

Sekwencja-koloru jest nazwą koloru, sekwencjami kolorów ASCII albo sekwencjami specjalnymi.

Nazwy kolorów

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

Sekwencje kolorów ANSI

Sekwencje kolorów składająsię z sekwencji liczb rozdzielonych dwukropkami. Najpopularniejsze kody to:

0 przywraca kolor domyślny
1 jaśniejsze kolory
4 tekst podkreślony
5 tekst migający
30 czarny tekst
31 czerwony tekst
32 zielony tekst
33 żółty (lub brązowy) tekst
34 niebieski tekst
35 fioletowy tekst
36 błękitny tekst
37 biały (lub szary) tekst
40 czarne tło
41 czerwone tło
42 zielone tło
43 zółte (lub brązowe) tło
44 niebieskie tło
45 fioletowe tło
46 błękitne tło
47 białe (lub szare) tło

Sekwencje specjalne

Aby podać znak kontrolny lub znak odstępu w sekwencjach kolorów, można posłużyć się notacją specjalną w stylu C:

\a Dzwonek (ASCII 7)
\b Backspace (ASCII 8)
\e Escape (ASCII 27)
\f Wysunięcie strony (ASCII 12)
\n Nowy wiersz (ASCII 10)
\r Powrót karetki (ASCII 13)
\t Tabulator (ASCII 9)
\v Tabulator pionowy (ASCII 11)
\? Delete (ASCII 127)
\_ Spacja
\\ Odwrotny ukośnik (\)
\^ Daszek (^)
\# Kratka (#)

Sekwencje specjalne są konieczne, aby użyć: spacji, odwrotnego ukośnika, daszka i każdego znaku kontrolnego w dowolnym miejscu łańcucha, a także kratki jako pierwszego znaku.

Na przykład, aby użyć czerwonego tła dla komunikatów typu alert w programie dmesg(1), można wykonać:

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

Komentarze

Wiersze, w których pierwszym znakiem innym niż znak odstępu jest # (kratka), są ignorowane. Wszelkie innego typu zastosowania znaku kratki nie są interpretowane jako początek komentarza.

ŚRODOWISKO

TERMINAL_COLORS_DEBUG=all

włącza wyjście debugowania.

NO_COLOR

if defined, this disables output colorization unless explicitly enabled by a command-line option. See <https://no-color.org/> for more details. Supported since util-linux version 2.41.

PLIKI

$XDG_CONFIG_HOME/terminal-colors.d

$HOME/.config/terminal-colors.d

/etc/terminal-colors.d

PRZYKŁAD

Wyłącza kolory dla wszystkich kompatybilnych narzędzi:

touch /etc/terminal-colors.d/disable

Wyłącza kolory dla wszystkich kompatybilnych narzędzi na terminalu vt100:

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

Wyłącza kolory dla wszystkich kompatybilnych narzędzi poza dmesg(1):

touch /etc/terminal-colors.d/disable

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

ZGODNOŚĆ

Funkcje terminal-colors.d są obecnie obsługiwane przez wszystkie narzędzia util-linux zapewniające koloryzowanie wyniku. Więcej szczegółów zawiera zawsze rozdział KOLORY podręcznika systemowego danego narzędzia.

ZGŁASZANIE BŁĘDÓW

Problemy należy zgłaszać w systemie śledzenia błędów <https://github.com/util-linux/util-linux/issues>.

DOSTĘPNOŚĆ

Plik konfiguracyjny terminal-colors.d jest częścią pakietu util-linux, który można pobrać ze strony Archiwum jądra Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.

2025-04-02 util-linux 2.41