'\" t
.\"     Title: terminal-colors.d
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: File formats
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "TERMINAL\-COLORS.D" "5" "2026-09-02" "util\-linux 2.42.3" "File formats"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
terminal-colors.d \- دایرکتوری پیکربندی رنگ‌آمیزی خروجی ابزارهای خط فرمان
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fB/etc/terminal\-colors.d/\fP[\fIname\fP\fB.\fP|[\fIname\fP]\fB@\fP\fIterm\fP\fB.\fP]\fItype\fP
.SH "توضیحات (DESCRIPTION)"
.sp
فایل‌های این دایرکتوری رفتار پیش‌فرض ابزارها را هنگام رنگ‌آمیزی خروجی تعیین می‌کنند.
.sp
مقدار \fIname\fP نام ابزار است. این نام اختیاری است و چنانچه مشخص نشود، فایل برای تمام ابزارهای نامشخص استفاده می‌شود.
.sp
مقدار \fIterm\fP شناسه پایانه است (متغیر محیطی \fBTERM\fP). شناسه پایانه اختیاری است و چنانچه مشخص نشود، فایل برای تمام پایانه‌های نامشخص استفاده می‌شود.
.sp
مقدار \fItype\fP نوع فایل است. انواع فایل‌های پشتیبانی‌شده عبارتند از:
.RS 3
.ll -.6i
.sp
\fBdisable\fP
.RS 4
رنگ‌آمیزی خروجی را برای تمام ابزارهای سازگار غیرفعال می‌کند. همچنین متغیر محیطی \fBNO_COLOR\fP را در زیر ببینید.
.RE
.sp
\fBenable\fP
.RS 4
رنگ‌آمیزی خروجی را فعال می‌کند؛ هرگونه فایل منطبق \fBdisable\fP نادیده گرفته می‌شود.
.RE
.sp
\fBscheme\fP
.RS 4
رنگ‌های مورد استفاده برای خروجی را مشخص می‌کند. قالب فایل ممکن است مختص ابزار باشد، قالب پیش‌فرض در زیر شرح داده شده است.
.RE
.br
.RE
.ll
.sp
اگر چندین فایل برای یک ابزار مطابقت داشته باشند، فایلی که نام فایل مشخص‌تری دارد برتری دارد. برای نمونه، نام فایل \fI@xterm.scheme\fP اولویت کمتری نسبت به \fIdmesg@xterm.scheme\fP دارد. کمترین اولویت متعلق به فایل‌هایی است که فاقد نام ابزار و شناسه پایانه هستند (مثلاً "disable").
.sp
تنظیمات مختص کاربر در \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP یا \fI$HOME/.config/terminal\-colors.d\fP بر تنظیمات سراسری اولویت دارند.
.SH "قالب پیش‌فرض فایل‌های طرح رنگ (DEFAULT SCHEME FILES FORMAT)"
.sp
عبارت زیر شناخته می‌شود:
.RS 3
.ll -.6i
.sp
\fIname color\-sequence\fP
.br
.RE
.ll
.sp
مقدار \fIname\fP یک نام منطقی برای توالی رنگ است (برای نمونه: \fBerror\fP). نام‌ها مختص ابزارها هستند. برای جزئیات بیشتر همیشه بخش \fBCOLORS\fP را در صفحه راهنمای ابزار ببینید.
.sp
مقدار \fIcolor\-sequence\fP می‌تواند نام رنگ، یک توالی رنگ ANSI یا یک دنباله گریز باشد.
.SS "نام‌های رنگ (Color names)"
.sp
نام‌های معتبر رنگ عبارتند از: black، blink، blue، bold، brown، cyan، darkgray، gray، green، halfbright، lightblue، lightcyan، lightgray، lightgreen، lightmagenta، lightred، magenta، red، reset، reverse و yellow.
.SS "توالی‌های رنگی ANSI (ANSI color sequences)"
.sp
یک توالی رنگ ANSI از دنباله‌ای از اعداد تشکیل شده است که با نقطه ویرگول از هم جدا شده‌اند. رایج‌ترین کدها عبارتند از:
.TS
allbox tab(:);
lt lt.
T{
.sp
0
T}:T{
.sp
برای بازگردانی رنگ پیش‌فرض
T}
T{
.sp
1
T}:T{
.sp
برای رنگ‌های روشن‌تر
T}
T{
.sp
4
T}:T{
.sp
برای متن زیرخط‌دار
T}
T{
.sp
5
T}:T{
.sp
برای متن چشمک‌زن
T}
T{
.sp
30
T}:T{
.sp
برای پیش‌زمینه مشکی
T}
T{
.sp
31
T}:T{
.sp
برای پیش‌زمینه قرمز
T}
T{
.sp
32
T}:T{
.sp
برای پیش‌زمینه سبز
T}
T{
.sp
33
T}:T{
.sp
برای پیش‌زمینه زرد (یا قهوه‌ای)
T}
T{
.sp
34
T}:T{
.sp
برای پیش‌زمینه آبی
T}
T{
.sp
35
T}:T{
.sp
برای پیش‌زمینه ارغوانی (بنفش)
T}
T{
.sp
36
T}:T{
.sp
برای پیش‌زمینه فیروزه‌ای
T}
T{
.sp
37
T}:T{
.sp
برای پیش‌زمینه سفید (یا خاکستری)
T}
T{
.sp
40
T}:T{
.sp
برای پس‌زمینه مشکی
T}
T{
.sp
41
T}:T{
.sp
برای پس‌زمینه قرمز
T}
T{
.sp
42
T}:T{
.sp
برای پس‌زمینه سبز
T}
T{
.sp
43
T}:T{
.sp
برای پس‌زمینه زرد (یا قهوه‌ای)
T}
T{
.sp
44
T}:T{
.sp
برای پس‌زمینه آبی
T}
T{
.sp
45
T}:T{
.sp
برای پس‌زمینه ارغوانی (بنفش)
T}
T{
.sp
46
T}:T{
.sp
برای پس‌زمینه فیروزه‌ای
T}
T{
.sp
47
T}:T{
.sp
برای پس‌زمینه سفید (یا خاکستری)
T}
.TE
.sp
.sp
برای نمونه، جهت استفاده از پس‌زمینه قرمز برای پیام‌های هشدار در خروجی \fBdmesg\fP(1)، از دستور زیر استفاده کنید:
.sp
\f(CR  \fBecho \*(Aqalert 37;41\*(Aq >> /etc/terminal\-colors.d/dmesg.scheme\fP\fP
.SS "دنباله‌های گریز (Escape sequences)"
.sp
برای وارد کردن فاصله، بک‌اسلش، علامت هشتک (caret) یا هر نویسه کنترلی در هر جای رشته، و همچنین علامت هش به عنوان اولین نویسه، به یک دنباله گریز نیاز است. این دنباله‌های گریز با بک‌اسلش به سبک C قابل استفاده هستند:
.TS
allbox tab(:);
lt lt.
T{
.sp
\fB\(rsa\fP
T}:T{
.sp
زنگ (ASCII 7)
T}
T{
.sp
\fB\(rsb\fP
T}:T{
.sp
پس‌بر (ASCII 8)
T}
T{
.sp
\fB\(rse\fP
T}:T{
.sp
گریز (ASCII 27)
T}
T{
.sp
\fB\(rsf\fP
T}:T{
.sp
برگه‌بر (ASCII 12)
T}
T{
.sp
\fB\(rsn\fP
T}:T{
.sp
خط جدید (ASCII 10)
T}
T{
.sp
\fB\(rsr\fP
T}:T{
.sp
بازگشت به سر خط (ASCII 13)
T}
T{
.sp
\fB\(rst\fP
T}:T{
.sp
تب (ASCII 9)
T}
T{
.sp
\fB\(rsv\fP
T}:T{
.sp
تب عمودی (ASCII 11)
T}
T{
.sp
\fB\(rs?\fP
T}:T{
.sp
حذف (ASCII 127)
T}
T{
.sp
\fB\(rs_\fP
T}:T{
.sp
فاصله
T}
T{
.sp
\fB\(rs\(rs\fP
T}:T{
.sp
بک‌اسلش (\(rs)
T}
T{
.sp
\fB\(rs^\fP
T}:T{
.sp
هشتک (^)
T}
T{
.sp
\fB\(rs\(rs#\fP
T}:T{
.sp
علامت هش (#)
T}
.TE
.sp
.SS "توضیحات (Comments)"
.sp
خطوطی که اولین نویسه غیرخالی آن‌ها \fB#\fP (هش) است نادیده گرفته می‌شوند. هرگونه استفاده دیگری از نویسه هش به عنوان شروع توضیح تفسیر نمی‌شود.
.SH "محیط (ENVIRONMENT)"
.sp
\fBTERMINAL_COLORS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی را فعال می‌کند.
.RE
.sp
\fBNO_COLOR\fP
.RS 4
در صورت تعریف، رنگ‌آمیزی خروجی را غیرفعال می‌کند مگر آن‌که صراحتاً توسط گزینه‌ای در خط فرمان فعال شده باشد. برای جزئیات بیشتر \c
.URL "https://no\-color.org" "" ""
را ببینید. از نسخه 2.41 بسته util\-linux پشتیبانی می‌شود.
.RE
.SH "فایل‌ها (FILES)"
.sp
\fI$XDG_CONFIG_HOME/terminal\-colors.d\fP
.sp
\fI$HOME/.config/terminal\-colors.d\fP
.sp
\fI/etc/terminal\-colors.d\fP
.SH "مثال‌ها (EXAMPLES)"
.sp
غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار:
.RS 3
.ll -.6i
.sp
\fBtouch /etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار در یک پایانه vt100:
.RS 3
.ll -.6i
.sp
\fBtouch /etc/terminal\-colors.d/@vt100.disable\fP
.br
.RE
.ll
.sp
غیرفعال کردن رنگ‌ها برای تمام ابزارهای سازگار به جز \fBdmesg\fP(1):
.RS 3
.ll -.6i
.sp
\fBtouch /etc/terminal\-colors.d/disable\fP
.br
\fBtouch /etc/terminal\-colors.d/dmesg.enable\fP
.br
.RE
.ll
.SH "سازگاری (COMPATIBILITY)"
.sp
قابلیت \fBterminal\-colors.d\fP در حال حاضر توسط تمام ابزارهای util\-linux که خروجی رنگی تولید می‌کنند پشتیبانی می‌شود. برای جزئیات بیشتر همیشه بخش \fBCOLORS\fP را در صفحه راهنمای ابزار ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBdmesg\fP(1)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
\fBterminal\-colors.d\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.