.TH "eza_colors" "5" "" "$version"
.SH "نام (NAME)"
eza_colors \- شخصی‌سازی رنگ‌های فایل و رابط کاربری در eza
.SH "خلاصه دستور (SYNOPSIS)"
از متغیر محیطی \f[CR]EZA_COLORS\f[R] می‌توان برای شخصی‌سازی رنگ‌هایی که \f[CR]eza\f[R] برای برجسته‌سازی نام فایل‌ها، فراداده‌های فایل و بخش‌هایی از رابط کاربری استفاده می‌کند، بهره برد.
.PP
می‌توانید از برنامه \f[CR]dircolors\f[R] برای تولید اسکریپتی استفاده کنید که این متغیر را از روی یک فایل ورودی مقداردهی می‌کند، یا اگر با ویرایش رشته‌های متنی طولانی مشکلی ندارید، می‌توانید آن را مستقیماً بنویسید.
این متغیرها ساختار زیر را دارند:
.IP \[bu] 2
فهرستی از جفت‌های کلید\-مقدار که با `\f[CR]=\f[R]' جدا شده‌اند، مانند `\f[CR]*.txt=32\f[R]'.
.IP \[bu] 2
کدهای قالب‌بندی چندگانه ANSI که با `\f[CR];\f[R]' جدا شده‌اند، مانند `\f[CR]*.txt=32;1;4\f[R]'.
.IP \[bu] 2
در نهایت، جفت‌های چندگانه که با `\f[CR]:\f[R]' جدا شده‌اند، مانند `\f[CR]*.txt=32:*.mp3=1;35\f[R]'.
.PP
بخش کلید هر جفت می‌تواند یک کد دو حرفی یا یک الگوی نام فایل (glob) باشد، و هر مقداری که یک کد معتبر نباشد به عنوان glob در نظر گرفته می‌شود، از جمله کلیدهایی که تصادفاً دو حرف طول دارند.
.PP
جهت سازگاری با گذشته، در صورتی که \f[CR]EZA_COLORS\f[R] تنظیم نشده باشد، متغیر محیطی \f[CR]EXA_COLORS\f[R] بررسی می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.TP
\f[CR]EZA_COLORS=\[dq]uu=0:gu=0\[dq]\f[R]
غیرفعال‌سازی برجسته‌سازی \[lq]کاربر فعلی\[rq]
.TP
\f[CR]EZA_COLORS=\[dq]da=32\[dq]\f[R]
سبز کردن ستون تاریخ
.TP
\f[CR]EZA_COLORS=\[dq]Vagrantfile=1;4;33\[dq]\f[R]
برجسته‌سازی Vagrantfileها
.TP
\f[CR]EZA_COLORS=\[dq]*.zip=38;5;125\[dq]\f[R]
بازنویسی رنگ پیش‌فرض برای فایل‌های zip
.TP
\f[CR]EZA_COLORS=\[dq]*.md=38;5;121:*.log=38;5;248\[dq]\f[R]
فایل‌های Markdown با طیفی از رنگ سبز، و فایل‌های log با طیفی از رنگ خاکستری
.SH "فهرست کدها (LIST OF CODES)"
متغیر \f[CR]LS_COLORS\f[R] می‌تواند از این ده کد استفاده کند:
.TP
\f[CR]di\f[R]
دایرکتوری‌ها
.TP
\f[CR]ex\f[R]
فایل‌های اجرایی
.TP
\f[CR]fi\f[R]
فایل‌های عادی
.TP
\f[CR]pi\f[R]
پایپ‌های نام‌گذاری‌شده (named pipes)
.TP
\f[CR]so\f[R]
سوکت‌ها
.TP
\f[CR]bd\f[R]
دستگاه‌های بلوکی (block devices)
.TP
\f[CR]cd\f[R]
دستگاه‌های نویسه‌ای (character devices)
.TP
\f[CR]ln\f[R]
پیوندهای نمادین (symlinks)
.TP
\f[CR]or\f[R]
پیوندهای نمادین بدون مقصد (شکسته)
.PP
متغیر \f[CR]EZA_COLORS\f[R] می‌تواند از کدهای بسیار بیشتری استفاده کند:
.TP
\f[CR]oc\f[R]
مجوزهای نمایش‌داده‌شده به صورت هشت‌هشتی (octal)
.TP
\f[CR]ur\f[R]
بیت مجوز خواندن کاربر
.TP
\f[CR]uw\f[R]
بیت مجوز نوشتن کاربر
.TP
\f[CR]ux\f[R]
بیت مجوز اجرای کاربر برای فایل‌های عادی
.TP
\f[CR]ue\f[R]
مجوز اجرای کاربر برای سایر انواع فایل
.TP
\f[CR]gr\f[R]
بیت مجوز خواندن گروه
.TP
\f[CR]gw\f[R]
بیت مجوز نوشتن گروه
.TP
\f[CR]gx\f[R]
بیت مجوز اجرای گروه
.TP
\f[CR]tr\f[R]
بیت مجوز خواندن دیگران
.TP
\f[CR]tw\f[R]
بیت مجوز نوشتن دیگران
.TP
\f[CR]tx\f[R]
بیت مجوز اجرای دیگران
.TP
\f[CR]su\f[R]
بیت‌های مجوز setuid، setgid و sticky برای فایل‌ها
.TP
\f[CR]sf\f[R]
بیت‌های setuid، setgid و sticky برای سایر انواع فایل
.TP
\f[CR]xa\f[R]
نشانگر مشخصه‌های توسعه‌یافته (extended attribute)
.TP
\f[CR]sn\f[R]
اعداد مربوط به اندازه فایل (کدهای \f[CR]nb\f[R]، \f[CR]nk\f[R]، \f[CR]nm\f[R]، \f[CR]ng\f[R] و \f[CR]nt\f[R] را تنظیم می‌کند)
.TP
\f[CR]nb\f[R]
اعداد اندازه فایل اگر کمتر از 1 KB/KiB باشد
.TP
\f[CR]nk\f[R]
اعداد اندازه فایل اگر بین 1 KB/KiB و 1 MB/MiB باشد
.TP
\f[CR]nm\f[R]
اعداد اندازه فایل اگر بین 1 MB/MiB و 1 GB/GiB باشد
.TP
\f[CR]ng\f[R]
اعداد اندازه فایل اگر بین 1 GB/GiB و 1 TB/TiB باشد
.TP
\f[CR]nt\f[R]
اعداد اندازه فایل اگر 1 TB/TiB یا بیشتر باشد
.TP
\f[CR]sb\f[R]
واحدهای اندازه فایل (کدهای \f[CR]ub\f[R]، \f[CR]uk\f[R]، \f[CR]um\f[R]، \f[CR]ug\f[R] و \f[CR]ut\f[R] را تنظیم می‌کند)
.TP
\f[CR]ub\f[R]
واحدهای اندازه فایل اگر کمتر از 1 KB/KiB باشد
.TP
\f[CR]uk\f[R]
واحدهای اندازه فایل اگر بین 1 KB/KiB و 1 MB/MiB باشد
.TP
\f[CR]um\f[R]
واحدهای اندازه فایل اگر بین 1 MB/MiB و 1 GB/GiB باشد
.TP
\f[CR]ug\f[R]
واحدهای اندازه فایل اگر بین 1 GB/GiB و 1 TB/TiB باشد
.TP
\f[CR]ut\f[R]
واحدهای اندازه فایل اگر 1 TB/TiB یا بیشتر باشد
.TP
\f[CR]df\f[R]
شناسه اصلی دستگاه (device major ID)
.TP
\f[CR]ds\f[R]
شناسه فرعی دستگاه (device minor ID)
.TP
\f[CR]uu\f[R]
کاربری که خود شما هستید
.TP
\f[CR]uR\f[R]
کاربری که root است
.TP
\f[CR]un\f[R]
کاربری که شخص دیگری است
.TP
\f[CR]gu\f[R]
گروهی که به آن تعلق دارید
.TP
\f[CR]gR\f[R]
گروه مرتبط با root
.TP
\f[CR]gn\f[R]
گروهی که عضو آن نیستید
.TP
\f[CR]lc\f[R]
تعداد پیوندهای سخت (hard links)
.TP
\f[CR]lm\f[R]
تعداد پیوندهای سخت برای یک فایل عادی با حداقل دو پیوند
.TP
\f[CR]ga\f[R]
پرچم جدید (new) در Git
.TP
\f[CR]gm\f[R]
پرچم تغییریافته (modified) در Git
.TP
\f[CR]gd\f[R]
پرچم حذف‌شده (deleted) در Git
.TP
\f[CR]gv\f[R]
پرچم تغییر نام‌یافته (renamed) در Git
.TP
\f[CR]gt\f[R]
پرچم فراداده تغییریافته در Git
.TP
\f[CR]gi\f[R]
پرچم نادیده‌گرفته‌شده (ignored) در Git
.TP
\f[CR]gc\f[R]
پرچم دارای تداخل (conflicted) در Git
.TP
\f[CR]Gm\f[R]
شاخه اصلی مخزن Git
.TP
\f[CR]Go\f[R]
سایر شاخه‌های مخزن Git
.TP
\f[CR]Gc\f[R]
شاخه تمیز (بدون تغییرات تاییدنشده) مخزن Git
.TP
\f[CR]Gd\f[R]
شاخه تغییریافته (دارای تغییرات تاییدنشده) مخزن Git
.TP
\f[CR]xx\f[R]
\[lq]نشانه‌گذاری‌ها\[rq]، شامل بسیاری از عناصر پس‌زمینه رابط کاربری
.TP
\f[CR]da\f[R]
تاریخ فایل
.TP
\f[CR]in\f[R]
شماره inode فایل
.TP
\f[CR]bl\f[R]
تعداد بلوک‌های فایل
.TP
\f[CR]hd\f[R]
سطر سربرگ جدول
.TP
\f[CR]lp\f[R]
مسیر یک پیوند نمادین
.TP
\f[CR]cc\f[R]
نویسه فرار (escaped) در نام فایل
.TP
\f[CR]bO\f[R]
سبک هم‌پوشانی (overlay) برای مسیرهای پیوند نمادین شکسته
.TP
\f[CR]sp\f[R]
موارد خاص (مواردی که فایل، دایرکتوری، نقطه اتصال، فایل اجرایی، پایپ، سوکت، دستگاه بلوکی، دستگاه نویسه‌ای یا پیوند نباشند)
.TP
\f[CR]mp\f[R]
یک نقطه اتصال (mount point)
.TP
\f[CR]im\f[R]
یک فایل عادی از نوع تصویر
.TP
\f[CR]vi\f[R]
یک فایل عادی از نوع ویدیو
.TP
\f[CR]mu\f[R]
یک فایل عادی از نوع فایل صوتی با اتلاف (lossy)
.TP
\f[CR]lo\f[R]
یک فایل عادی از نوع فایل صوتی بدون اتلاف (lossless)
.TP
\f[CR]cr\f[R]
یک فایل عادی مربوط به رمزنگاری (مانند کلید یا گواهی)
.TP
\f[CR]do\f[R]
یک فایل عادی از نوع سند (مانند اسناد اداری یا PDF)
.TP
\f[CR]co\f[R]
یک فایل عادی فشرده‌شده
.TP
\f[CR]tm\f[R]
یک فایل عادی موقت (مانند فایل پشتیبان ویرایشگر متن)
.TP
\f[CR]cm\f[R]
یک فایل عادی مربوط به کامپایل (مانند فایل کامپایل‌شده جاوا با پسوند class)
.TP
\f[CR]bu\f[R]
یک فایل عادی که برای ساخت پروژه استفاده می‌شود (مانند Makefile)
.TP
\f[CR]sc\f[R]
یک فایل عادی از نوع کد منبع
.TP
\f[CR]ic\f[R]
آیکون (اختیاری است؛ در صورت عدم تنظیم، رنگ آیکون با رنگ نام فایل مطابقت خواهد داشت)
.TP
\f[CR]Sn\f[R]
نبود زمینه امنیتی (security context) روی فایل
.TP
\f[CR]Su\f[R]
کاربر SELinux
.TP
\f[CR]Sr\f[R]
نقش SELinux
.TP
\f[CR]St\f[R]
نوع SELinux
.TP
\f[CR]Sl\f[R]
سطح SELinux
.TP
\f[CR]ff\f[R]
پرچم‌های فایل در BSD
.PP
مقادیر موجود در \f[CR]EXA_COLORS\f[R] مقادیر داده‌شده در \f[CR]LS_COLORS\f[R] را بازنویسی می‌کنند، بنابراین نیازی به بازنویسی متغیر موجود \f[CR]LS_COLORS\f[R] با پسوندهای اختصاصی ندارید.
.SH "فهرست سبک‌ها (LIST OF STYLES)"
برخلاف برخی از نسخه‌های \f[CR]ls\f[R]، مقادیر وارد شده ANSI باید کدهای رنگی معتبر باشند: eza صرفاً هر نویسه‌ای را که داده شده باشد چاپ نمی‌کند.
.PP
کدهای پذیرفته‌شده توسط eza عبارتند از:
.TP
\f[CR]1\f[R]
برای متن پررنگ (bold)
.TP
\f[CR]2\f[R]
برای متن کم‌رنگ (dimmed)
.TP
\f[CR]3\f[R]
برای متن کج (italic)
.TP
\f[CR]4\f[R]
برای متن زیرخط‌دار (underline)
.TP
\f[CR]31\f[R]
برای متن قرمز
.TP
\f[CR]32\f[R]
برای متن سبز
.TP
\f[CR]33\f[R]
برای متن زرد
.TP
\f[CR]34\f[R]
برای متن آبی
.TP
\f[CR]35\f[R]
برای متن بنفش
.TP
\f[CR]36\f[R]
برای متن فیروزه‌ای (cyan)
.TP
\f[CR]37\f[R]
برای متن سفید
.TP
\f[CR]90\f[R]
برای متن خاکستری تیره
.TP
\f[CR]91\f[R]
برای متن قرمز روشن
.TP
\f[CR]92\f[R]
برای متن سبز روشن
.TP
\f[CR]93\f[R]
برای متن زرد روشن
.TP
\f[CR]94\f[R]
برای متن آبی روشن
.TP
\f[CR]95\f[R]
برای متن بنفش روشن
.TP
\f[CR]96\f[R]
برای متن فیروزه‌ای روشن
.TP
\f[CR]97\f[R]
برای متن روشن
.TP
\f[CR]38;5;nnn\f[R]
برای رنگی از 0 تا 255 (بخش \f[CR]nnn\f[R] را جایگزین کنید)
.PP
بسیاری از پایانه‌ها با متن پررنگ (bold) به عنوان یک رنگ متمایز رفتار می‌کنند، یا حداقل گزینه‌ای برای این کار ارائه می‌دهند.
.PP
برنامه eza مجموعه‌ای داخلی از نگاشت پسوندهای فایل را ارائه می‌دهد که طیف گسترده‌ای از پسوندهای رایج فایل از جمله اسناد، بایگانی‌ها، چندرسانه‌ای و فایل‌های موقت را پوشش می‌دهد.
هرگونه نگاشت در متغیرهای محیطی این مجموعه پیش‌فرض را بازنویسی خواهد کرد: اجرای eza با \f[CR]LS_COLORS=\[dq]*.zip=32\[dq]\f[R] فایل‌های zip را سبز می‌کند اما رنگ سایر فایل‌های فشرده را دست‌نخورده باقی می‌گذارد.
.PP
شما همچنین می‌توانید این مجموعه داخلی را با قرار دادن یک مدخل \f[CR]reset\f[R] در ابتدای \f[CR]EZA_COLORS\f[R] به طور کامل غیرفعال کنید.
بنابراین تنظیم \f[CR]EZA_COLORS=\[dq]reset:*.txt=31\[dq]\f[R] فقط فایل‌های متنی را برجسته می‌کند؛ و تنظیم \f[CR]EZA_COLORS=\[dq]reset\[dq]\f[R] هیچ موردی را برجسته نمی‌کند.
.SH "نویسندگان (AUTHORS)"
برنامه eza توسط Christina Sørensen و بسیاری از مشارکت‌کنندگان دیگر نگهداری می‌شود.
.PP
\f[B]کد منبع:\f[R] \f[CR]https://github.com/eza\-community/eza\f[R]
.PD 0
.P
.PD
\f[B]مشارکت‌کنندگان:\f[R]
\f[CR]https://github.com/eza\-community/eza/graphs/contributors\f[R]
.PP
با سپاس بی‌پایان از Benjamin `ogham' Sago و تمامی مشارکت‌کنندگان دیگر exa که eza از آن منشعب شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
\f[B]eza\f[R](1)
.IP \[bu] 2
\f[B]eza_colors\-explanation\f[R](5)