نام (NAME)

eza_colors - شخصی‌سازی رنگ‌های فایل و رابط کاربری در eza

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

از متغیر محیطی EZA_COLORS می‌توان برای شخصی‌سازی رنگ‌هایی که eza برای برجسته‌سازی نام فایل‌ها، فراداده‌های فایل و بخش‌هایی از رابط کاربری استفاده می‌کند، بهره برد.

می‌توانید از برنامه dircolors برای تولید اسکریپتی استفاده کنید که این متغیر را از روی یک فایل ورودی مقداردهی می‌کند، یا اگر با ویرایش رشته‌های متنی طولانی مشکلی ندارید، می‌توانید آن را مستقیماً بنویسید. این متغیرها ساختار زیر را دارند:

•: فهرستی از جفت‌های کلید-مقدار که با `=' جدا شده‌اند، مانند `*.txt=32'.
•: کدهای قالب‌بندی چندگانه ANSI که با `;' جدا شده‌اند، مانند `*.txt=32;1;4'.
•: در نهایت، جفت‌های چندگانه که با `:' جدا شده‌اند، مانند `*.txt=32:*.mp3=1;35'.

بخش کلید هر جفت می‌تواند یک کد دو حرفی یا یک الگوی نام فایل (glob) باشد، و هر مقداری که یک کد معتبر نباشد به عنوان glob در نظر گرفته می‌شود، از جمله کلیدهایی که تصادفاً دو حرف طول دارند.

جهت سازگاری با گذشته، در صورتی که EZA_COLORS تنظیم نشده باشد، متغیر محیطی EXA_COLORS بررسی می‌شود.

مثال‌ها (EXAMPLES)

EZA_COLORS="uu=0:gu=0": غیرفعال‌سازی برجسته‌سازی “کاربر فعلی”
EZA_COLORS="da=32": سبز کردن ستون تاریخ
EZA_COLORS="Vagrantfile=1;4;33": برجسته‌سازی Vagrantfileها
EZA_COLORS="*.zip=38;5;125": بازنویسی رنگ پیش‌فرض برای فایل‌های zip
EZA_COLORS="*.md=38;5;121:*.log=38;5;248": فایل‌های Markdown با طیفی از رنگ سبز، و فایل‌های log با طیفی از رنگ خاکستری

فهرست کدها (LIST OF CODES)

متغیر LS_COLORS می‌تواند از این ده کد استفاده کند:

di: دایرکتوری‌ها
ex: فایل‌های اجرایی
fi: فایل‌های عادی
pi: پایپ‌های نام‌گذاری‌شده (named pipes)
so: سوکت‌ها
bd: دستگاه‌های بلوکی (block devices)
cd: دستگاه‌های نویسه‌ای (character devices)
ln: پیوندهای نمادین (symlinks)
or: پیوندهای نمادین بدون مقصد (شکسته)

متغیر EZA_COLORS می‌تواند از کدهای بسیار بیشتری استفاده کند:

oc: مجوزهای نمایش‌داده‌شده به صورت هشت‌هشتی (octal)
ur: بیت مجوز خواندن کاربر
uw: بیت مجوز نوشتن کاربر
ux: بیت مجوز اجرای کاربر برای فایل‌های عادی
ue: مجوز اجرای کاربر برای سایر انواع فایل
gr: بیت مجوز خواندن گروه
gw: بیت مجوز نوشتن گروه
gx: بیت مجوز اجرای گروه
tr: بیت مجوز خواندن دیگران
tw: بیت مجوز نوشتن دیگران
tx: بیت مجوز اجرای دیگران
su: بیت‌های مجوز setuid، setgid و sticky برای فایل‌ها
sf: بیت‌های setuid، setgid و sticky برای سایر انواع فایل
xa: نشانگر مشخصه‌های توسعه‌یافته (extended attribute)
sn: اعداد مربوط به اندازه فایل (کدهای nb، nk، nm، ng و nt را تنظیم می‌کند)
nb: اعداد اندازه فایل اگر کمتر از 1 KB/KiB باشد
nk: اعداد اندازه فایل اگر بین 1 KB/KiB و 1 MB/MiB باشد
nm: اعداد اندازه فایل اگر بین 1 MB/MiB و 1 GB/GiB باشد
ng: اعداد اندازه فایل اگر بین 1 GB/GiB و 1 TB/TiB باشد
nt: اعداد اندازه فایل اگر 1 TB/TiB یا بیشتر باشد
sb: واحدهای اندازه فایل (کدهای ub، uk، um، ug و ut را تنظیم می‌کند)
ub: واحدهای اندازه فایل اگر کمتر از 1 KB/KiB باشد
uk: واحدهای اندازه فایل اگر بین 1 KB/KiB و 1 MB/MiB باشد
um: واحدهای اندازه فایل اگر بین 1 MB/MiB و 1 GB/GiB باشد
ug: واحدهای اندازه فایل اگر بین 1 GB/GiB و 1 TB/TiB باشد
ut: واحدهای اندازه فایل اگر 1 TB/TiB یا بیشتر باشد
df: شناسه اصلی دستگاه (device major ID)
ds: شناسه فرعی دستگاه (device minor ID)
uu: کاربری که خود شما هستید
uR: کاربری که root است
un: کاربری که شخص دیگری است
gu: گروهی که به آن تعلق دارید
gR: گروه مرتبط با root
gn: گروهی که عضو آن نیستید
lc: تعداد پیوندهای سخت (hard links)
lm: تعداد پیوندهای سخت برای یک فایل عادی با حداقل دو پیوند
ga: پرچم جدید (new) در Git
gm: پرچم تغییریافته (modified) در Git
gd: پرچم حذف‌شده (deleted) در Git
gv: پرچم تغییر نام‌یافته (renamed) در Git
gt: پرچم فراداده تغییریافته در Git
gi: پرچم نادیده‌گرفته‌شده (ignored) در Git
gc: پرچم دارای تداخل (conflicted) در Git
Gm: شاخه اصلی مخزن Git
Go: سایر شاخه‌های مخزن Git
Gc: شاخه تمیز (بدون تغییرات تاییدنشده) مخزن Git
Gd: شاخه تغییریافته (دارای تغییرات تاییدنشده) مخزن Git
xx: “نشانه‌گذاری‌ها”، شامل بسیاری از عناصر پس‌زمینه رابط کاربری
da: تاریخ فایل
in: شماره inode فایل
bl: تعداد بلوک‌های فایل
hd: سطر سربرگ جدول
lp: مسیر یک پیوند نمادین
cc: نویسه فرار (escaped) در نام فایل
bO: سبک هم‌پوشانی (overlay) برای مسیرهای پیوند نمادین شکسته
sp: موارد خاص (مواردی که فایل، دایرکتوری، نقطه اتصال، فایل اجرایی، پایپ، سوکت، دستگاه بلوکی، دستگاه نویسه‌ای یا پیوند نباشند)
mp: یک نقطه اتصال (mount point)
im: یک فایل عادی از نوع تصویر
vi: یک فایل عادی از نوع ویدیو
mu: یک فایل عادی از نوع فایل صوتی با اتلاف (lossy)
lo: یک فایل عادی از نوع فایل صوتی بدون اتلاف (lossless)
cr: یک فایل عادی مربوط به رمزنگاری (مانند کلید یا گواهی)
do: یک فایل عادی از نوع سند (مانند اسناد اداری یا PDF)
co: یک فایل عادی فشرده‌شده
tm: یک فایل عادی موقت (مانند فایل پشتیبان ویرایشگر متن)
cm: یک فایل عادی مربوط به کامپایل (مانند فایل کامپایل‌شده جاوا با پسوند class)
bu: یک فایل عادی که برای ساخت پروژه استفاده می‌شود (مانند Makefile)
sc: یک فایل عادی از نوع کد منبع
ic: آیکون (اختیاری است؛ در صورت عدم تنظیم، رنگ آیکون با رنگ نام فایل مطابقت خواهد داشت)
Sn: نبود زمینه امنیتی (security context) روی فایل
Su: کاربر SELinux
Sr: نقش SELinux
St: نوع SELinux
Sl: سطح SELinux
ff: پرچم‌های فایل در BSD

مقادیر موجود در EXA_COLORS مقادیر داده‌شده در LS_COLORS را بازنویسی می‌کنند، بنابراین نیازی به بازنویسی متغیر موجود LS_COLORS با پسوندهای اختصاصی ندارید.

فهرست سبک‌ها (LIST OF STYLES)

برخلاف برخی از نسخه‌های ls، مقادیر وارد شده ANSI باید کدهای رنگی معتبر باشند: eza صرفاً هر نویسه‌ای را که داده شده باشد چاپ نمی‌کند.

کدهای پذیرفته‌شده توسط eza عبارتند از:

1: برای متن پررنگ (bold)
2: برای متن کم‌رنگ (dimmed)
3: برای متن کج (italic)
4: برای متن زیرخط‌دار (underline)
31: برای متن قرمز
32: برای متن سبز
33: برای متن زرد
34: برای متن آبی
35: برای متن بنفش
36: برای متن فیروزه‌ای (cyan)
37: برای متن سفید
90: برای متن خاکستری تیره
91: برای متن قرمز روشن
92: برای متن سبز روشن
93: برای متن زرد روشن
94: برای متن آبی روشن
95: برای متن بنفش روشن
96: برای متن فیروزه‌ای روشن
97: برای متن روشن
38;5;nnn: برای رنگی از 0 تا 255 (بخش nnn را جایگزین کنید)

بسیاری از پایانه‌ها با متن پررنگ (bold) به عنوان یک رنگ متمایز رفتار می‌کنند، یا حداقل گزینه‌ای برای این کار ارائه می‌دهند.

برنامه eza مجموعه‌ای داخلی از نگاشت پسوندهای فایل را ارائه می‌دهد که طیف گسترده‌ای از پسوندهای رایج فایل از جمله اسناد، بایگانی‌ها، چندرسانه‌ای و فایل‌های موقت را پوشش می‌دهد. هرگونه نگاشت در متغیرهای محیطی این مجموعه پیش‌فرض را بازنویسی خواهد کرد: اجرای eza با LS_COLORS="*.zip=32" فایل‌های zip را سبز می‌کند اما رنگ سایر فایل‌های فشرده را دست‌نخورده باقی می‌گذارد.

شما همچنین می‌توانید این مجموعه داخلی را با قرار دادن یک مدخل reset در ابتدای EZA_COLORS به طور کامل غیرفعال کنید. بنابراین تنظیم EZA_COLORS="reset:*.txt=31" فقط فایل‌های متنی را برجسته می‌کند؛ و تنظیم EZA_COLORS="reset" هیچ موردی را برجسته نمی‌کند.

نویسندگان (AUTHORS)

برنامه eza توسط Christina Sørensen و بسیاری از مشارکت‌کنندگان دیگر نگهداری می‌شود.

کد منبع: https://github.com/eza-community/eza

مشارکت‌کنندگان: https://github.com/eza-community/eza/graphs/contributors

با سپاس بی‌پایان از Benjamin `ogham' Sago و تمامی مشارکت‌کنندگان دیگر exa که eza از آن منشعب شده است.

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

•: eza(1)
•: eza_colors-explanation(5)