dir_colors(5) File Formats Manual dir_colors(5)

ИМЯ

dir_colors - файл настроек для утилиты dircolors(1)

ОПИСАНИЕ

Программа ls(1) использует переменную окружения LS_COLORS для определения цветов, которыми должны отображаться имена файлов. Эта переменная окружения обычно устанавливается командой типа:

eval `dircolors некий_путь/dir_colors`

Эта команда обычно находится в стандартном файле начальных настроек оболочки командной строки, например в /etc/profile или /etc/csh.cshrc. (Смотрите также dircolors(1).) Обычно здесь используется файл /etc/DIR_COLORS, и его настройки могут быть изменены файлом .dir_colors из каталога пользователя.

Данный файл настройки состоит из нескольких операторов, по одному в строке. Всё, что находится после символа решётки (#), считается комментарием (если этот символ находится в начале строки или перед ним находится как минимум один пробел). Пустые строки игнорируются.

Все операторы, появившиеся до первого оператора TERM, составляют глобальный раздел. Они действуют для всех типов терминалов. После глобального раздела находится один или более разделов, описывающих определённые терминалы. Он начинается с одного или более операторов TERM, который задаёт тип терминала (то же имя, что указывается в переменной окружения TERM). Для любого терминала глобальные настройки всегда можно перекрыть терминал-специфичными.

Распознаются следующие операторы (регистр букв неважен):

Начинает раздел, специфичный для терминала, и указывает, к какому типу терминала он применим. Можно указывать несколько операторов TERM, чтобы создать раздел, применимый к нескольким типам терминалов.
(Только для Slackware; игнорируется GNU dircolors(1).) Указывает, что расцветка должна быть всегда разрешена (yes или all), никогда не разрешена (no или none), или разрешена, только если вывод происходит на терминальное устройство (tty). По умолчанию no.
(Slackware only; ignored by GNU dircolors(1).) Specifies that eight-bit ISO/IEC 8859 characters should be enabled by default. For compatibility reasons, this can also be specified as 1 for yes or 0 for no. The default is no.
(Только для Slackware; игнорируется GNU dircolors(1).) Добавляет параметры по умолчанию к командной строке ls. Здесь можно указать любой разрешённый параметр команды ls, причем нужно указывать начальный знак минус. Заметьте, что dircolors не проверяет, допустимы ли эти параметры.
Задаёт цвет, используемый для нормального (не имя файла) текста.
Синоним NORM.
Задаёт цвет, используемый для обычных файлов.
Задаёт цвет, используемый для каталогов.
Задаёт цвет, используемый для символьных ссылок.
Синонимы: LNK, SYMLINK.
Задаёт цвет, используемый для нерабочих символьных ссылок (указывающих на несуществующие файлы). Если этот цвет не задан, то ls будет использовать вместо него цвет LINK.
Задаёт цвет, используемый для отсутствующих файлов (несуществующих файлов, на которые указывают символьные ссылки). Если этот цвет не задан, то ls будет использовать вместо него цвет FILE.
Задаёт цвет, используемый для FIFO (именованных каналов).
Синоним PIPE.
Задаёт цвет, используемый для сокетов.
(Поддерживается, начиная с fileutils 4.1) Задаёт цвет, используемый для файлов типа door (Solaris 2.5 и выше).
Задаёт цвет, используемый для специальных файлов блочных устройств.
Синоним BLOCK.
Задаёт цвет, используемый для специальных файлов символьных устройств.
Синоним CHAR.
Задаёт цвет, используемый для файлов с установленным атрибутом выполнения.
Задаёт цвет, используемый для файлов с установленным битом set-user-ID.
Синоним SETUID.
Задаёт цвет, используемый для файлов с установленным битом set-group-ID.
Синоним SETGID.
Задаёт цвет, используемый для файлов с установленным закрепляющим (sticky) битом.
Задаёт цвет, используемый для каталогов с установленным атрибутом выполнения и доступный на запись другим.
Синоним OWT.
Задаёт цвет, используемый для каталогов без установленного атрибута выполнения и доступный на запись другим.
Синоним OWR.
Specifies the left code for non-ISO/IEC 6429 terminals (see below).
Синоним LEFT.
Specifies the right code for non-ISO/IEC 6429 terminals (see below).
Синоним RIGHT.
Specifies the end code for non-ISO/IEC 6429 terminals (see below).
Синоним END.
*расширение цвет
Задаёт цвет, используемый для файлов, чьи имена заканчиваются на заданное расширение.

.расширение цвет
Same as *.extension. Specifies the color used for any file that ends in .extension. Note that the period is included in the extension, which makes it impossible to specify an extension not starting with a period, such as ~ for emacs backup files. This form should be considered obsolete.

Most color-capable ASCII terminals today use ISO/IEC 6429 (ANSI) color sequences, and many common terminals without color capability, including xterm and the widely used and cloned DEC VT100, will recognize ISO/IEC 6429 color codes and harmlessly eliminate them from the output or emulate them. ls uses ISO/IEC 6429 codes by default, assuming colorization is enabled.

ISO/IEC 6429 color sequences are composed of sequences of numbers separated by semicolons. The most common codes are:

0 восстановить цвет по умолчанию
1 яркие цвета
4 подчёркнутый текст
5 мигающий текст
30 чёрные символы
31 красные символы
32 зелёные символы
33 жёлтые (или коричневые) символы
34 синие символы
35 пурпурные символы
36 бирюзовые символы
37 белые (или серые) символы
40 чёрный фон
41 красный фон
42 зелёный фон
43 жёлтый (или коричневый) фон
44 синий фон
45 пурпурный фон
46 бирюзовый фон
47 белый (или серый) фон

Не все команды будут работать на любой системе или устройстве отображения.

ls использует следующие значения по умолчанию:

NORMAL 0 обычный (не имя файла) текст
FILE 0 обычный файл
DIR 32 каталог
LINK 36 символьная ссылка
ORPHAN не определено сломанная символьная ссылка
MISSING не определено отсутствующий файл
FIFO 31 именованный канал (FIFO)
SOCK 33 сокет
BLK 44;37 блочное устройство
CHR 44;37 символьное устройство
EXEC 35 исполняемый файл

Некоторые терминальные программы неправильно распознают настройки цвета по умолчанию. Если весь текст становится расцвеченным после того, как вы просматриваете листинг каталога, измените коды NORMAL и FILE на цифровые коды для нормального цвета текста и фона.

Другие типы терминалов (расширенная настройка)

Если у вас есть терминал (или принтер!) с поддержкой цвета (или другими возможностями выделения), который использует другой набор кодов, вы всё равно сможете создать подходящие настройки. Для этого нужно использовать операторы LEFTCODE, RIGHTCODE и ENDCODE.

При выводе имени файла ls генерирует такую последовательность: LEFTCODE кода_типа RIGHTCODE имя_файла ENDCODE, где код_типа — цветовая последовательность, зависящая от типа или имени файла. Если ENDCODE не определён, то вместо него будет использоваться последовательность LEFTCODE NORMAL RIGHTCODE. Предназначением левого (LEFTCODE) и правого (RIGHTCODE) кодов является сокращение количества информации, которую нужно набирать (а также спрятать уродливые escape-последовательности от пользователя). Если они не подходят для вашего терминала, их можно выключить, поместив соответствующее ключевое слово на отдельной строке.

ЗАМЕЧАНИЕ: Если ENDCODE определён в глобальном разделе файла настроек, то его нельзя переопределить в разделе определённого терминала. Это означает, что все определения NORMAL не приведут ни к какому результату. Однако, можно использовать различные ENDCODE, что и приведёт к нужному результату.

Экранированные последовательности

To specify control- or blank characters in the color sequences or filename extensions, either C-style \-escaped notation or stty-style ^-notation can be used. The C-style notation includes the following characters:

\a Звуковой сигнал (ASCII 7)
\b Забой (ASCII 8)
\e Экранирующий символ (ASCII 27)
\f Прогон страницы (ASCII 12)
\n Перевод строки (ASCII 10)
\r Возврат каретки (ASCII 13)
\t Табуляция (ASCII 9)
\v Вертикальная табуляция (ASCII 11)
\? Удаление (ASCII 127)
\nnn Любой символ (восьмеричная запись)
\xnnn Любой символ (шестнадцатеричная запись)
\_ Пробел
\\ Обратная косая черта (\)
\^ Caret (^)
\# Знак решетки (#)

Заметьте, что экранирование необходимо, чтобы использовать пробел, обратную косую черту, крышку или управляющие символы в любом месте строки, а также символ решётки в качестве первого символа в строке.

ФАЙЛЫ

/etc/DIR_COLORS
Общесистемный файл настройки
~/.dir_colors
Пользовательский файл настройки

Эта страница описывает формат файла dir_colors, который можно найти в пакете fileutils-4.1; другие версии могут немного отличаться.

ПРИМЕЧАНИЯ

The default LEFTCODE and RIGHTCODE definitions, which are used by ISO/IEC 6429 terminals are:

LEFTCODE \e[
RIGHTCODE м

По умолчанию значение ENDCODE не определено.

СМОТРИТЕ ТАКЖЕ

dircolors(1), ls(1), stty(1), xterm(1)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.

2 мая 2024 г. Linux man-pages 6.8