.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH dir_colors 5 "17 maja 2025 r." "Linux man\-pages 6.15" .SH NAZWA dir_colors \- plik konfiguracyjny dircolors(1) .SH OPIS Program \fBls\fP(1) korzysta ze zmiennej środowiskowej \fBLS_COLORS\fP do określenia kolorów używanych do wyświetlania nazw plików. Zmienna środowiskowa jest zwykle ustawiana przez polecenie takie jak .P .RS eval \`dircolors jakas_sciezka/dir_colors\` .RE .P w pliki inicjującym domyślną powłokę systemową, jak \fI/etc/profile\fP lub \fI/etc/csh.cshrc\fP (zob. też \fBdircolors\fP(1)). Używanym tu plikiem jest zwykle \fI/etc/DIR_COLORS\fP, który można przesłonić plikiem \fI.dir_colors\fP w katalogu domowym danego użytkownika. .P Plik konfiguracyjny składa się z wielu wyrażeń, po jednym na wiersz. Wszystko co znajduje się na prawo od znaku kratki (#) jest traktowane jako komentarz, jeśli znak ten znajduje się na początku wiersza i następuje za nim co najmniej jedna spacja. Puste wiersze są ignorowane. .P Sekcja \fIglobal\fP pliki składa się ze wyrażeń, które znajdują się przed pierwszym wyrażeniem \fBTERM\fP. Wszelkie wyrażenia w sekcji global pliki są uważane jako prawidłowe dla wszystkich typów terminali. Po sekcji global występuje jedna lub więcej sekcji \fIwłaściwych dla konkretnego terminala\fP, poprzedzonych przez jedno lub więcej wyrażeń \fBTERM\fP określających typy terminali (jak podawanych przez zmienną środowiskową \fBTERM\fP), po których następują właściwe im deklaracje. Deklarację globalną zawsze da się przesłonić przez kolejną deklarację właściwą dla konkretnego terminala. .P Rozpoznawane są następujące wyrażenia; wielkość znaków nie ma znaczenia: .TP \fBTERM\ \fP\fItyp\-terminala\fP Zaczyna sekcję właściwą dla konkretnego terminala i określa, do którego terminala się ona odnosi. Można podać wiele wyrażeń \fBTERM\fP, aby utworzyć sekcję stosującą się do wielu typów terminali. .TP \fBCOLOR yes|all|no|none|tty\fP (tylko Slackware; ignorowane przez GNU \fBdircolors\fP(1)) Określa, że kolorowanie powinno być zawsze włączone (\fIyes\fP lub \fIall\fP), nigdy nie włączone (\fIno\fP lub \fInone\fP) lub włączone tylko, gdy wyjściem jest terminal (\fItty\fP). Wartość domyślna to \fIno\fP. .TP \fBEIGHTBIT yes|no\fP (tylko Slackware; ignorowane przez GNU \fBdircolors\fP(1)) Określa, że ośmiobitowe znaki ISO/IEC\ 8859 powinny być domyślnie włączone. Ze względu na kompatybilność, można podać również 1 jako \fIyes\fP lub 0 jako \fIno\fP. Wartość domyślna to \fIno\fP (wyłączone). .TP \fBOPTIONS\ \fP\fIopcje\fP (tylko Slackware; ignorowane przez GNU \fBdircolors\fP(1)) Dodaje opcje wiersza poleceń do domyślnego wiersza polecenia \fBls\fP. Opcjami mogą być dowolne prawidłowe opcje wiersza poleceń \fBls\fP i powinno się je podać wraz z rozpoczynającym znakiem minus. Proszę zauważyć, że \fBdircolors\fP nie weryfikuje prawidłowości tych opcji. .TP \fBNORMAL\ \fP\fIsekwencja\-koloru\fP Określa kolor używany przez zwykły (niebędący nazwą pliku) tekst. .IP Synonim: \fBNORM\fP. .TP \fBFILE\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do zwykłego pliku. .TP \fBDIR\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do katalogów. .TP \fBLINK\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do dowiązania symbolicznego. .IP Synonimy: \fBLNK\fP, \fBSYMLINK\fP. .TP \fBORPHAN\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do zerwanego dowiązania symbolicznego (wskazującego na nieistniejący plik). Jeśli wartość ta nie będzie określona, \fBls\fP w takim przypadku użyje koloru \fBLINK\fP. .TP \fBMISSING\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do brakującego pliku (nieistniejącego pliku, na który jednak wskazuje dowiązanie symboliczne). Jeśli wartość ta nie będzie określona, \fBls\fP w takim przypadku użyje koloru \fBFILE\fP. .TP \fBFIFO\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do FIFO (nazwanego potoku). .IP Synonim: \fBPIPE\fP. .TP \fBSOCK\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do gniazda. .TP \fBDOOR\ \fP\fIsekwencja\-koloru\fP (Obsługiwane od fileutils 4.1) Określa kolor używany do pliku door (Solaris 2.5 i późniejsze). .TP \fBBLK\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do pliku specjalnego urządzenia blokowego. .IP Synonim: \fBBLOCK\fP. .TP \fBCHR\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do pliku specjalnego urządzenia znakowego. .IP Synonim: \fBCHAR\fP. .TP \fBEXEC\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do pliku z ustawionym atrybutem wykonania. .TP \fBSUID\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do pliku z ustawionym atrybutem ustawienia identyfikatora użytkownika podczas wykonania (SUID). .IP Synonim: \fBSETUID\fP. .TP \fBSGID\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do pliku z ustawionym atrybutem ustawienia identyfikatora grupy podczas wykonania (SGID). .IP Synonim: \fBSETGID\fP. .TP \fBSTICKY\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do katalogu z ustawionym atrybutem bitu lepkości. .TP \fBSTICKY_OTHER_WRITABLE\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do katalogu zapisywalnego dla innych, z ustawionym atrybutem wykonania. .IP Synonim: \fBOWT\fP. .TP \fBOTHER_WRITABLE\ \fP\fIsekwencja\-koloru\fP Określa kolor używany do katalogu zapisywalnego dla innych, bez ustawionego atrybutu wykonania. .IP Synonim: \fBOWR\fP. .TP \fBLEFTCODE\ \fP\fIsekwencja\-koloru\fP Określa \fIlewy kod\fP do terminali innych niż ISO/IEC\ 6429 (zob. niżej). .IP Synonim: \fBLEFT\fP. .TP \fBRIGHTCODE\ \fP\fIsekwencja\-koloru\fP Określa \fIprawy kod\fP do terminali innych niż ISO/IEC\ 6429 (zob. niżej). .IP Synonim: \fBRIGHT\fP. .TP \fBENDCODE\ \fP\fIsekwencja\-koloru\fP Określa \fIkod końcowy\fP do terminali innych niż ISO/IEC\ 6429 (zob. niżej). .IP Synonim: \fBEND\fP. .TP \fB*\fP\fIrozszerzenie\ sekwencja\-koloru\fP Określa kolor używany przez wszystkie pliki kończące się \fIrozszerzeniem\fP. .TP \&\fB.\fP\fIrozszerzenie\ sekwencja\-koloru\fP Jak \f[B]*\fR.\fIrozszerzenie\fP. Określa kolor używany przez wszystkie pliki kończące się \fIrozszerzeniem\fP. Proszę zauważyć, że kropka jest częścią rozszerzenia, zatem nie da się podać rozszerzenia niezaczynającego się kropką, takiego jak pliki kopii zapasowej \fB\[ti]\fP programu \fBemacs\fP. Tę postać należy uważać za przestarzałą. .SS "Sekwencje kolorów ISO/IEC\ 6429 (ANSI)" Większość dzisiejszych terminali ASCII z możliwością wyświetlania kolorów używa sekwencji kolorów ISO/IEC\ 6429 (ANSI), a wiele popularnych terminali niekolorowych, w tym \fBxterm\fP i często spotykany i klonowany DEC VT100, rozpoznaje kody kolorów ISO/IEC\ 6429 i bezboleśnie eliminuje je z wyjścia lub emuluje je. \fBls\fP używa domyślnie kodów ISO/IEC\ 6429 o ile kolorowanie jest włączone. .P Kody kolorów ISO/IEC\ 6429 składają się z sekwencji liczb rozdzielonych dwukropkiem. Najpopularniejsze kody to: .RS .TS l l. 0 przywraca kolor domyślny 1 rozjaśnia kolory 4 podkreśla tekst 5 tworzy tekst migający 30 czarny tekst (pierwszy plan) 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 żół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 .TE .RE .P Nie wszystkie polecenia zadziałają na wszystkich systemach lub urządzeniach. .P \fBls\fP używa następujących wartości domyślnych: .TS lb l l. NORMAL 0 Zwykły tekst (niebędący nazwą pliku) FILE 0 Zwykły plik DIR 32 Katalog LINK 36 Dowiązanie symboliczne ORPHAN niezdefiniowane Zerwane dowiązanie symboliczne MISSING niezdefiniowane Brakujący plik FIFO 31 Potok nazwany (FIFO) SOCK 33 Gniazdo BLK 44;37 Urządzenie blokowe CHR 44;37 Urządzenie znakowe EXEC 35 Plik wykonywalny .TE .P Kilka programów nie rozpoznaje poprawnie wartości domyślnych. Jeśli po wypisaniu zawartości katalogu cały tekst pozostaje kolorowany, należy zmienić kody \fBNORMAL\fP i \fBFILE\fP na numeryczne kody stosowanych zwykłych kolorów tekstu i tła. .SS "Inne typy terminali (konfiguracja zaawansowana)" Jeśli posiada się terminal (albo drukarkę!) kolorowy (lub stosujący podświetlenie), który korzysta z innego zestawu kodów, wciąż można utworzyć odpowiednie ustawienia. W tym celu trzeba będzie użyć definicji \fBLEFTCODE\fP, \fBRIGHTCODE\fP i \fBENDCODE\fP. .P Przy wypisywaniu nazwy pliku, \fBls\fP tworzy następujące sekwencje wyjściowe: \fBLEFTCODE\fP \fIkod\-od\-typu\fP \fBRIGHTCODE\fP \fInazwa\-pliku\fP \fBENDCODE\fP, gdzie \fIkod\-od\-typu\fP jest sekwencją koloru zależną od typu lub nazwy pliku. Jeśli \fBENDCODE\fP jest niezdefiniowany, w zamian będzie używana sekwencja \fBLEFTCODE NORMAL RIGHTCODE\fP. Przeznaczeniem lewego i prawego kodu jest tylko ograniczenie wielkości wpisywanego tekstu (i ukrycie nieestetycznych sekwencji specjalnych przed użytkownikiem). Jeśli nie są one wymagane przez używany terminal, można je wyeliminować, wpisując samodzielnie dane słowo kluczowe w wierszu. .P \fBUWAGA:\fP Jeśli w globalnej sekcji pliku konfiguracyjnego zdefiniowano \fBENDCODE\fP, \fInie da się\fP usunąć tej definicji w sekcji właściwej dla danego terminala. Oznacza to, że definicje \fBNORMAL\fP wówczas nie zadziałają. Można jednak podać różne \fBENDCODE\fP, co da ten sam efekt. .SS "Sekwencje specjalne" Aby w sekwencjach kolorów lub rozszerzeń nazw plików podać znaki sterujące lub odstępy, można zastosować notację specjalną języka C stosującą \[rs] lub notację specjalną \fBstty\fP stosującą \[ha]\-. Notacja języka C obejmuje poniższe znaki: .RS .TS lb l. \[rs]a Dzwonek (ASCII 7) \[rs]b Backspace (ASCII 8) \[rs]e Escape (ASCII 27) \[rs]f Wysuw strony (ASCII 12) \[rs]n Nowy wiersz (ASCII 10) \[rs]r Powrót karetki (ASCII 13) \[rs]t Tabulator (ASCII 9) \[rs]v Tabulator pionowy (ASCII 11) \[rs]? Delete (ASCII 127) \[rs]\f[I]nnn\fR Dowolny znak (notacja ósemkowa) \[rs]x\f[I]nnn\fR Dowolny znak (notacja szesnastkowa) \[rs]_ Spacja \[rs]\[rs] Odwrotny ukośnik (\[rs]) \[rs]\[ha] Kareta (\[ha]) \[rs]a Znak kratki (#) .TE .RE .P Proszę zauważyć, że sekwencje specjalne są konieczne do podania spacji, odwrotnego ukośnika, karety lub dowolnych znaków sterujących w łańcuchu, jak również znaku kratki jako pierwszego znaku. .SH PLIKI .TP \fI/etc/DIR_COLORS\fP Ogólnosystemowy plik konfiguracyjny. .TP \fI\[ti]/.dir_colors\fP Plik konfiguracyjny użytkownika. .P Niniejsza strona podręcznika systemowego opisuje format pliku \fBdir_colors\fP używany przez pakiet fileutils\-4.1; inne wersje mogą się nieco różnić. .SH UWAGI Domyślne definicje \fBLEFTCODE\fP i \fBRIGHTCODE\fP używane przez terminale ISO/IEC\ 6429 to: .RS .TS lb l. LEFTCODE \[rs]e[ RIGHTCODE m .TE .RE .P Domyślnie \fBENDCODE\fP jest niezdefiniowany. .SH "ZOBACZ TAKŻE" \fBdircolors\fP(1), \fBls\fP(1), \fBstty\fP(1), \fBxterm\fP(1) .PP .SH TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .