نام (NAME)

terminal-colors.d - دایرکتوری پیکربندی رنگ‌آمیزی خروجی ابزارهای خط فرمان

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

فایل‌های این دایرکتوری رفتار پیش‌فرض ابزارها را هنگام رنگ‌آمیزی خروجی تعیین می‌کنند.

مقدار name نام ابزار است. این نام اختیاری است و چنانچه مشخص نشود، فایل برای تمام ابزارهای نامشخص استفاده می‌شود.

مقدار term شناسه پایانه است (متغیر محیطی TERM). شناسه پایانه اختیاری است و چنانچه مشخص نشود، فایل برای تمام پایانه‌های نامشخص استفاده می‌شود.

مقدار type نوع فایل است. انواع فایل‌های پشتیبانی‌شده عبارتند از:

disable

رنگ‌آمیزی خروجی را برای تمام ابزارهای سازگار غیرفعال می‌کند. همچنین متغیر محیطی NO_COLOR را در زیر ببینید.

enable

رنگ‌آمیزی خروجی را فعال می‌کند؛ هرگونه فایل منطبق disable نادیده گرفته می‌شود.

scheme

رنگ‌های مورد استفاده برای خروجی را مشخص می‌کند. قالب فایل ممکن است مختص ابزار باشد، قالب پیش‌فرض در زیر شرح داده شده است.

اگر چندین فایل برای یک ابزار مطابقت داشته باشند، فایلی که نام فایل مشخص‌تری دارد برتری دارد. برای نمونه، نام فایل @xterm.scheme اولویت کمتری نسبت به dmesg@xterm.scheme دارد. کمترین اولویت متعلق به فایل‌هایی است که فاقد نام ابزار و شناسه پایانه هستند (مثلاً "disable").

تنظیمات مختص کاربر در $XDG_CONFIG_HOME/terminal-colors.d یا $HOME/.config/terminal-colors.d بر تنظیمات سراسری اولویت دارند.

قالب پیش‌فرض فایل‌های طرح رنگ (DEFAULT SCHEME FILES FORMAT)

عبارت زیر شناخته می‌شود:

name color-sequence

مقدار name یک نام منطقی برای توالی رنگ است (برای نمونه: error). نام‌ها مختص ابزارها هستند. برای جزئیات بیشتر همیشه بخش COLORS را در صفحه راهنمای ابزار ببینید.

مقدار color-sequence می‌تواند نام رنگ، یک توالی رنگ ANSI یا یک دنباله گریز باشد.

نام‌های رنگ (Color names)

نام‌های معتبر رنگ عبارتند از: black، blink، blue، bold، brown، cyan، darkgray، gray، green، halfbright، lightblue، lightcyan، lightgray، lightgreen، lightmagenta، lightred، magenta، red، reset، reverse و yellow.

توالی‌های رنگی ANSI (ANSI color sequences)

یک توالی رنگ ANSI از دنباله‌ای از اعداد تشکیل شده است که با نقطه ویرگول از هم جدا شده‌اند. رایج‌ترین کدها عبارتند از:

0	برای بازگردانی رنگ پیش‌فرض
1	برای رنگ‌های روشن‌تر
4	برای متن زیرخط‌دار
5	برای متن چشمک‌زن
30	برای پیش‌زمینه مشکی
31	برای پیش‌زمینه قرمز
32	برای پیش‌زمینه سبز
33	برای پیش‌زمینه زرد (یا قهوه‌ای)
34	برای پیش‌زمینه آبی
35	برای پیش‌زمینه ارغوانی (بنفش)
36	برای پیش‌زمینه فیروزه‌ای
37	برای پیش‌زمینه سفید (یا خاکستری)
40	برای پس‌زمینه مشکی
41	برای پس‌زمینه قرمز
42	برای پس‌زمینه سبز
43	برای پس‌زمینه زرد (یا قهوه‌ای)
44	برای پس‌زمینه آبی
45	برای پس‌زمینه ارغوانی (بنفش)
46	برای پس‌زمینه فیروزه‌ای
47	برای پس‌زمینه سفید (یا خاکستری)

برای نمونه، جهت استفاده از پس‌زمینه قرمز برای پیام‌های هشدار در خروجی dmesg(1)، از دستور زیر استفاده کنید:

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

دنباله‌های گریز (Escape sequences)

برای وارد کردن فاصله، بک‌اسلش، علامت هشتک (caret) یا هر نویسه کنترلی در هر جای رشته، و همچنین علامت هش به عنوان اولین نویسه، به یک دنباله گریز نیاز است. این دنباله‌های گریز با بک‌اسلش به سبک C قابل استفاده هستند:

\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)
\_	فاصله
\\	بک‌اسلش (\)
\^	هشتک (^)
\\#	علامت هش (#)

توضیحات (Comments)

خطوطی که اولین نویسه غیرخالی آن‌ها # (هش) است نادیده گرفته می‌شوند. هرگونه استفاده دیگری از نویسه هش به عنوان شروع توضیح تفسیر نمی‌شود.

محیط (ENVIRONMENT)

TERMINAL_COLORS_DEBUG=all

خروجی اشکال‌زدایی را فعال می‌کند.

NO_COLOR

در صورت تعریف، رنگ‌آمیزی خروجی را غیرفعال می‌کند مگر آن‌که صراحتاً توسط گزینه‌ای در خط فرمان فعال شده باشد. برای جزئیات بیشتر https://no-color.org را ببینید. از نسخه 2.41 بسته util-linux پشتیبانی می‌شود.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/terminal-colors.d

$HOME/.config/terminal-colors.d

/etc/terminal-colors.d

مثال‌ها (EXAMPLES)

غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار:

touch /etc/terminal-colors.d/disable

غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار در یک پایانه vt100:

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

غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار به جز dmesg(1):

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

سازگاری (COMPATIBILITY)

قابلیت terminal-colors.d در حال حاضر توسط تمام ابزارهای util-linux که خروجی رنگی تولید می‌کنند پشتیبانی می‌شود. برای جزئیات بیشتر همیشه بخش COLORS را در صفحه راهنمای ابزار ببینید.

همچنین ببینید (SEE ALSO)

dmesg(1)

گزارش باگ‌ها (REPORTING BUGS)

برای گزارش باگ‌ها، از سامانه پیگیری مشکلات https://github.com/util-linux/util-linux/issues.

در دسترس بودن (AVAILABILITY)

terminal-colors.d بخشی از بسته util-linux است که می‌تواند از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت شود.