.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "eza" "1" "" "$version"
.SH "نام (NAME)"
eza \- جایگزینی مدرن برای ls
.SH "خلاصه دستور (SYNOPSIS)"
\f[CR]eza [options] [files...]\f[R]
.PP
ابزار \f[B]eza\f[R] یک جایگزین مدرن برای \f[CR]ls\f[R] است.
این ابزار به‌طور پیش‌فرض از رنگ‌ها برای نمایش اطلاعات استفاده می‌کند تا به شما در تشخیص و تمایز میان انواع مختلف فایل‌ها، مانند اینکه آیا مالک فایل هستید یا عضو گروه مالک آن می‌باشید، کمک کند.
.PP
همچنین دارای امکانات بیشتری است که در \f[CR]ls\f[R] اصلی وجود ندارد؛ از جمله مشاهده وضعیت Git برای یک دایرکتوری، یا پیمایش بازگشتی در دایرکتوری‌ها با نمای درختی.
.SH "مثال‌ها (EXAMPLES)"
.TP
\f[CR]eza\f[R]
محتویات دایرکتوری جاری را به صورت شبکه‌ای فهرست می‌کند.
.TP
\f[CR]eza \-\-oneline \-\-reverse \-\-sort=size\f[R]
فهرستی از فایل‌ها را نمایش می‌دهد که بزرگ‌ترین آن‌ها در بالا قرار دارد.
.TP
\f[CR]eza \-\-long \-\-header \-\-inode \-\-git\f[R]
جدولی از فایل‌ها را همراه با سربرگ نمایش می‌دهد که متاداده، inode و وضعیت Git هر فایل را نشان می‌دهد.
.TP
\f[CR]eza \-\-long \-\-tree \-\-level=3\f[R]
یک ساختار درختی از فایل‌ها را تا عمق ۳ سطح، همراه با متاداده‌های هر فایل نمایش می‌دهد.
.SH "گزینه‌های عمومی (META OPTIONS)"
.TP
\f[CR]\-\-help\f[R]
نمایش فهرست گزینه‌های خط فرمان.
.TP
\f[CR]\-v\f[R], \f[CR]\-\-version\f[R]
نمایش نسخه eza.
.SH "گزینه‌های نمایش (DISPLAY OPTIONS)"
.TP
\f[CR]\-1\f[R], \f[CR]\-\-oneline\f[R]
نمایش هر ورودی در یک خط جداگانه.
.TP
\f[CR]\-\-absolute=WHEN\f[R]
نمایش ورودی‌ها همراه با مسیر مطلق آن‌ها.
.PP
تنظیمات معتبر عبارت‌اند از `\f[CR]on\f[R]`، `\f[CR]follow\f[R]` و
`\f[CR]off\f[R]`.
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `\f[CR]on\f[R]` در نظر گرفته می‌شود.
.PP
`\f[CR]on\f[R]`: نمایش مسیرهای مطلق برای همه ورودی‌ها.
`\f[CR]follow\f[R]`: نمایش مسیرهای مطلق و بازگشایی پیوندهای نمادین به مقصدهایشان.
`\f[CR]off\f[R]`: نمایش مسیرهای نسبی (رفتار پیش‌فرض).
.TP
\f[CR]\-F\f[R], \f[CR]\-\-classify=WHEN\f[R]
نمایش نشانگر نوع فایل در کنار نام فایل‌ها.
.PP
تنظیمات معتبر عبارت‌اند از `\f[CR]always\f[R]`، `\f[CR]automatic\f[R]` (یا به
اختصار `\f[CR]auto\f[R]`) و `\f[CR]never\f[R]`.
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `\f[CR]automatic\f[R]` اعمال می‌شود.
.PP
مقدار \f[CR]automatic\f[R] یا \f[CR]auto\f[R] تنها زمانی نشانگرهای نوع فایل را
نمایش می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد.
اگر \f[CR]eza\f[R] در یک \f[CR]tty\f[R] اجرا شود، یا خروجی \f[CR]eza\f[R] به
یک فایل هدایت شده یا به برنامه دیگری پایپ شود، از نشانگرهای نوع فایل استفاده نخواهد شد.
تنظیم این گزینه روی `\f[CR]always\f[R]` باعث می‌شود \f[CR]eza\f[R] همیشه
نشانگرهای نوع فایل را نمایش دهد، در حالی که `\f[CR]never\f[R]` استفاده از آن‌ها
را غیرفعال می‌کند.
.TP
\f[CR]\-G\f[R], \f[CR]\-\-grid\f[R]
نمایش ورودی‌ها به صورت شبکه‌ای (پیش‌فرض).
.TP
\f[CR]\-l\f[R], \f[CR]\-\-long\f[R]
نمایش متاداده‌های توسعه‌یافته فایل به صورت یک جدول.
.TP
\f[CR]\-R\f[R], \f[CR]\-\-recurse\f[R]
پیمایش بازگشتی در دایرکتوری‌ها.
.TP
\f[CR]\-T\f[R], \f[CR]\-\-tree\f[R]
پیمایش بازگشتی در دایرکتوری‌ها به صورت ساختار درختی.
.TP
\f[CR]\-\-code[=MODE]\f[R]
چاپ خلاصه‌ای از تعداد خطوط کد بر حسب زبان به‌جای فهرست کردن فایل‌ها، هم‌راستا با ابزارهایی مانند \f[CR]tokei\f[R] و \f[CR]cloc\f[R].
مسیرهای مشخص‌شده (یا دایرکتوری جاری) به‌طور بازگشتی پیمایش می‌شوند و در صورت وجود، فایل \f[CR].gitignore\f[R] مخزن git رعایت می‌گردد؛ هر زبان شناخته‌شده همراه با تعداد فایل‌ها، خطوط، کد، توضیحات و خطوط خالی، به همراه یک نوار که سهم آن از کد را به تصویر می‌کشد گزارش می‌شود.
حالت‌های معتبر عبارت‌اند از `\f[CR]lines\f[R]`، `\f[CR]percent\f[R]` و
`\f[CR]both\f[R]` (پیش‌فرض).
.TP
\f[CR]\-\-follow\-symlinks\f[R]
پیمایش به درون پیوندهای نمادینی که به دایرکتوری‌ها اشاره دارند.
.TP
\f[CR]\-X\f[R], \f[CR]\-\-dereference\f[R]
دنبال کردن و بازگشایی پیوندهای نمادین هنگام نمایش اطلاعات.
.TP
\f[CR]\-x\f[R], \f[CR]\-\-across\f[R]
مرتب‌سازی شبکه به‌صورت افقی (سطری)، به‌جای عمودی (ستونی).
.TP
\f[CR]\-\-color=WHEN\f[R], \f[CR]\-\-colour=WHEN\f[R]
تعیین زمان استفاده از رنگ‌های ترمینال (با استفاده از کدهای گریز ANSI برای رنگ‌آمیزی خروجی).
.PP
تنظیمات معتبر عبارت‌اند از `\f[CR]always\f[R]`، `\f[CR]automatic\f[R]` (یا به
اختصار `\f[CR]auto\f[R]`) و `\f[CR]never\f[R]`.
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `\f[CR]automatic\f[R]` اعمال می‌شود.
.PP
رفتار پیش‌فرض (`\f[CR]automatic\f[R]` یا `\f[CR]auto\f[R]`) خروجی را تنها زمانی
رنگ‌آمیزی می‌کند که خروجی استاندارد به یک ترمینال واقعی متصل باشد.
اگر خروجی \f[CR]eza\f[R] به یک فایل هدایت شود یا به برنامه دیگری پایپ گردد،
از رنگ‌های ترمینال استفاده نخواهد شد.
تنظیم این گزینه روی `\f[CR]always\f[R]` موجب می‌شود \f[CR]eza\f[R] همیشه خروجی
را با رنگ‌های ترمینال تولید کند، در حالی که `\f[CR]never\f[R]` استفاده از رنگ‌های ترمینال را غیرفعال می‌سازد.
.PP
تنظیم دستی این گزینه، متغیر محیطی \f[CR]NO_COLOR\f[R] را نادیده می‌گیرد.
.TP
\f[CR]\-\-color\-scale\f[R], \f[CR]\-\-colour\-scale\f[R]
برجسته‌سازی سطوح مختلفِ \f[CR]field\f[R] به‌صورت متمایز.
از فهرستی جداشده با کاما (,) شامل all، age و size استفاده کنید.
.TP
\f[CR]\-\-color\-scale\-mode=MODE\f[R], \f[CR]\-\-colour\-scale\-mode=MODE\f[R]
استفاده از رنگ‌های گرادیان یا ثابت در \f[CR]\-\-color\-scale\f[R].
.PP
گزینه‌های معتبر عبارت‌اند از \f[CR]fixed\f[R] یا \f[CR]gradient\f[R].
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض \f[CR]gradient\f[R] انتخاب می‌شود.
.TP
\f[CR]\-\-icons=WHEN\f[R]
نمایش آیکون‌ها در کنار نام فایل‌ها.
.PP
تنظیمات معتبر عبارت‌اند از `\f[CR]always\f[R]`، `\f[CR]automatic\f[R]`
(به اختصار `\f[CR]auto\f[R]`) و `\f[CR]never\f[R]`.
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `\f[CR]automatic\f[R]` در نظر گرفته می‌شود.
.PP
مقدار \f[CR]automatic\f[R] یا \f[CR]auto\f[R] آیکون‌ها را تنها زمانی نمایش
می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد.
اگر \f[CR]eza\f[R] در یک \f[CR]tty\f[R] اجرا شود، یا خروجی \f[CR]eza\f[R] به
یک فایل هدایت شده یا به برنامه دیگری پایپ شود، از آیکون‌ها استفاده نخواهد شد.
تنظیم این گزینه به `\f[CR]always\f[R]` باعث می‌شود \f[CR]eza\f[R] همواره
آیکون‌ها را نمایش دهد، در حالی که `\f[CR]never\f[R]` استفاده از آیکون‌ها را
غیرفعال می‌نماید.
.TP
\f[CR]\-\-no\-quotes\f[R]
قرار ندادن نام‌های فایلی که دارای فاصله هستند در داخل نقل‌قول.
.TP
\f[CR]\-\-short\-nix\f[R]
کوتاه‌سازی هش‌های Nix store در نام‌ها و مسیرهای فایل.
بخشی از یک مسیر که با یک هش Nix store آغاز می‌شود \[em] دقیقاً ۳۲ نویسه از الفبای base32 در Nix که به دنبال آن یک خط‌تیره می‌آید، مانند
\f[CR]vlkia5wk0svsikwv50554mh06iayg2m2\-source.drv\f[R] \[em] به‌گونه‌ای نمایش
داده می‌شود که هش به ۸ نویسه اول و یک نشان سه‌نقطه خلاصه شده و با رنگ کم‌رنگ رسم می‌گردد تا نام اصلی فایل برجسته شود:
\f[CR]vlkia5wk\&...\-source.drv\f[R].
این ویژگی بر نام‌های فهرست‌شده، مقصدهای پیوندهای نمادین و مسیرهای مطلق اعمال می‌گردد.
.TP
\f[CR]\-\-hyperlink=WHEN\f[R]
نمایش ورودی‌ها به صورت ابرپیوند (hyperlink).
.PP
تنظیمات معتبر عبارت‌اند از `\f[CR]always\f[R]`، `\f[CR]automatic\f[R]`
(به اختصار `\f[CR]auto\f[R]`) و `\f[CR]never\f[R]`.
در صورت استفاده بدون مقدار، به‌طور پیش‌فرض `\f[CR]automatic\f[R]` اعمال می‌شود.
.PP
حالت \f[CR]automatic\f[R] یا \f[CR]auto\f[R] تنها زمانی ابرپیوندها را نمایش
می‌دهد که خروجی استاندارد به یک ترمینال واقعی متصل باشد.
اگر \f[CR]eza\f[R] در یک \f[CR]tty\f[R] اجرا شود، یا خروجی \f[CR]eza\f[R] به
یک فایل هدایت شده یا به برنامه دیگری پایپ گردد، از ابرپیوندها استفاده نخواهد شد.
تنظیم این گزینه روی `\f[CR]always\f[R]` باعث می‌شود \f[CR]eza\f[R] همواره
ابرپیوندها را نمایش دهد، در حالی که `\f[CR]never\f[R]` استفاده از آن‌ها را غیرفعال می‌کند.
.TP
\f[CR]\-w\f[R], \f[CR]\-\-width=COLS\f[R]
تنظیم عرض صفحه نمایش بر اساس تعداد ستون‌ها..SH "گزینه‌های فیلتر و مرتب‌سازی (FILTERING AND SORTING OPTIONS)"
.TP
\f[CR]\-a\f[R], \f[CR]\-\-all\f[R]
نمایش فایل‌های پنهان و «نقطه‌دار» (dot files).
از این گزینه دوبار استفاده کنید تا دایرکتوری‌های `\f[CR].\f[R]' و `\f[CR]..\f[R]'
نیز نمایش داده شوند.
.TP
\f[CR]\-A\f[R], \f[CR]\-\-almost\-all\f[R]
معادل \-\-all؛ برای سازگاری با
\f[CR]ls \-A\f[R] گنجانده شده است.
.TP
\f[CR]\-d\f[R], \f[CR]\-\-treat\-dirs\-as\-files\f[R]
این پرچم که از \f[CR]ls\f[R] به ارث رسیده است، نحوهٔ رفتار \f[CR]eza\f[R]
با آرگومان‌های دایرکتوری را تغییر می‌دهد.
به جای ورود بازگشتی به دایرکتوری‌ها و فهرست کردن محتوای آن‌ها (رفتار
پیش‌فرض)، با دایرکتوری‌ها مانند فایل‌های معمولی رفتار کرده و اطلاعات
مربوط به خود مدخل دایرکتوری را فهرست می‌کند.
این قابلیت زمانی مفید است که می‌خواهید فراداده‌های مربوط به خود دایرکتوری
(مانند مجوزها، اندازه، زمان ویرایش) را به جای محتوای آن مشاهده کنید.
برای صرفاً فهرست کردن دایرکتوری‌ها و نه فایل‌ها، استفاده از گزینهٔ
\f[CR]\-\-only\-dirs\f[R] (\f[CR]\-D\f[R]) را به عنوان جایگزین در نظر بگیرید.
.TP
\f[CR]\-L\f[R], \f[CR]\-\-level=DEPTH\f[R]
محدود کردن عمق بازگشت (تکرار بازگشتی).
.TP
\f[CR]\-r\f[R], \f[CR]\-\-reverse\f[R]
معکوس کردن ترتیب مرتب‌سازی.
.TP
\f[CR]\-s\f[R], \f[CR]\-\-sort=SORT_FIELD\f[R]
فیلدی که مرتب‌سازی بر اساس آن انجام می‌شود.
.PP
فیلدهای معتبر مرتب‌سازی عبارتند از `\f[CR]name\f[R]'، `\f[CR]Name\f[R]'،
`\f[CR]extension\f[R]'، `\f[CR]Extension\f[R]'، `\f[CR]size\f[R]'،
`\f[CR]modified\f[R]'، `\f[CR]changed\f[R]'، `\f[CR]accessed\f[R]'،
`\f[CR]created\f[R]'، `\f[CR]inode\f[R]'، `\f[CR]type\f[R]' و
`\f[CR]none\f[R]'.
.PP
فیلد مرتب‌سازی \f[CR]modified\f[R] دارای نام‌های مستعار `\f[CR]date\f[R]'،
`\f[CR]time\f[R]' و `\f[CR]newest\f[R]' است و ترتیب معکوس آن دارای
نام‌های مستعار `\f[CR]age\f[R]' و `\f[CR]oldest\f[R]' می‌باشد.
.PP
فیلدهای مرتب‌سازی که با یک حرف بزرگ آغاز می‌شوند، حروف بزرگ را قبل از
حروف کوچک مرتب می‌کنند: ابتدا `A'، سپس `B'، سپس `a' و سپس `b'.
فیلدهایی که با حروف کوچک شروع می‌شوند، آن‌ها را ترکیب می‌کنند: ابتدا `A'، سپس
`a'، سپس `B' و سپس `b'.
.TP
\f[CR]\-I\f[R], \f[CR]\-\-ignore\-glob=GLOBS\f[R]
الگوهای تطابق (glob) جداشده با خط عمودی (pipe)، برای نادیده گرفتن فایل‌ها.
.TP
\f[CR]\-\-git\-ignore\f[R] [اگر eza با پشتیبانی از git ساخته شده باشد]
عدم فهرست کردن فایل‌هایی که توسط Git نادیده گرفته شده‌اند (ignore شده‌اند).
.TP
\f[CR]\-\-group\-directories\-first\f[R]
فهرست کردن دایرکتوری‌ها پیش از سایر فایل‌ها.
.TP
\f[CR]\-\-group\-directories\-last\f[R]
فهرست کردن دایرکتوری‌ها پس از سایر فایل‌ها.
.TP
\f[CR]\-D\f[R], \f[CR]\-\-only\-dirs\f[R]
فقط دایرکتوری‌ها فهرست شوند، نه فایل‌ها.
.TP
\f[CR]\-f\f[R], \f[CR]\-\-only\-files\f[R]
فقط فایل‌ها فهرست شوند، نه دایرکتوری‌ها.
.TP
\f[CR]\-\-show\-symlinks\f[R]
نمایش صریح پیوندهای نمادین (هنگام استفاده همراه با
\f[CR]\-\-only\-files\f[R] | \f[CR]\-\-only\-dirs\f[R])
.TP
\f[CR]\-\-no\-symlinks\f[R]
عدم نمایش پیوندهای نمادین.
.SH "گزینه‌های نمای تفصیلی (LONG VIEW OPTIONS)"
این گزینه‌ها هنگام اجرا با \f[CR]\-\-long\f[R]
(\f[CR]\-l\f[R]) در دسترس هستند:
.TP
\f[CR]\-b\f[R], \f[CR]\-\-binary\f[R]
فهرست کردن اندازهٔ فایل‌ها با پیشوندهای دودویی (باینری).
.TP
\f[CR]\-B\f[R], \f[CR]\-\-bytes\f[R]
فهرست کردن اندازهٔ فایل‌ها بر حسب بایت، بدون هیچ پیشوندی.
.TP
\f[CR]\-\-changed\f[R]
استفاده از فیلد برچسب زمانی تغییر وضعیت (changed).
.TP
\f[CR]\-g\f[R], \f[CR]\-\-group\f[R]
فهرست کردن گروه هر فایل.
.TP
\f[CR]\-\-smart\-group\f[R]
تنها در صورتی گروه را نمایش بده که نامی متفاوت از مالک داشته باشد.
.TP
\f[CR]\-h\f[R], \f[CR]\-\-header\f[R]
افزودن یک سطر سربرگ به هر ستون.
.TP
\f[CR]\-H\f[R], \f[CR]\-\-links\f[R]
فهرست کردن تعداد پیوندهای سخت (hard links) هر فایل.
.TP
\f[CR]\-i\f[R], \f[CR]\-\-inode\f[R]
فهرست کردن شمارهٔ inode هر فایل.
.TP
\f[CR]\-\-loc[=MODE]\f[R]
افزودن یک ستون زبان و یک ستون تعداد خطوط کد به نمای تفصیلی.
تنها فایل‌های معمولی به یک زبان برنامه‌نویسی شناخته‌شده شمرده می‌شوند؛
شمارش نسبت به کامنت‌ها آگاه است، بنابراین ستون کد خطوط توضیحات و
خالی را در نظر نمی‌گیرد.
حالت‌های معتبر عبارتند از `\f[CR]lines\f[R]' (تعداد خطوط کد)،
`\f[CR]percent\f[R]' (سهم هر فایل از کد در کل ساختار درختی)، و `\f[CR]both\f[R]' (پیش‌فرض).
در حالت‌های \f[CR]percent\f[R] و \f[CR]both\f[R]، مخرج کسر مجموع کل کدهای موجود
در سراسر درخت پیمایش‌شده، یا در صورت وجود مخزن git، کل مخزن است.
.TP
\f[CR]\-m\f[R], \f[CR]\-\-modified\f[R]
استفاده از فیلد برچسب زمانی ویرایش محتوا (modified).
.TP
\f[CR]\-M\f[R], \f[CR]\-\-mounts\f[R]
نمایش جزئیات نقطهٔ اتصال (mount) (فقط در لینوکس و مک).
.TP
\f[CR]\-n\f[R], \f[CR]\-\-numeric\f[R]
فهرست کردن شناسه‌های کاربری و گروه به صورت عددی.
.TP
\f[CR]\-O\f[R], \f[CR]\-\-flags\f[R]
فهرست کردن پرچم‌های فایل در سیستم‌های Mac و BSD و مشخصه‌های فایل در
سیستم‌های Windows.
به طور پیش‌فرض، مشخصه‌های ویندوز به صورت کامل نمایش داده می‌شوند.
برای نمایش مشخصه‌ها به صورت تک‌نویسه‌ای، متغیر محیطی
\f[CR]EZA_WINDOWS_ATTRIBUTES=short\f[R] را تنظیم کنید.
در سیستم‌های BSD، برای مشاهدهٔ فهرستی از پرچم‌های فایل و معانی آن‌ها،
chflags(1) را ببینید.
.TP
\f[CR]\-S\f[R], \f[CR]\-\-blocksize\f[R]
فهرست کردن اندازهٔ بلوک‌های تخصیص‌یافته به هر فایل در فایل‌سیستم.
.TP
\f[CR]\-t\f[R], \f[CR]\-\-time=WORD\f[R]
تعیین اینکه کدام فیلد برچسب زمانی فهرست شود.
فیلدهای زمانی معتبر عبارتند از `\f[CR]modified\f[R]'، `\f[CR]changed\f[R]'،
`\f[CR]accessed\f[R]' و `\f[CR]created\f[R]'.
.TP
\f[CR]\-\-time\-style=STYLE\f[R]
نحوهٔ قالب‌بندی برچسب‌های زمانی.
شیوه‌های معتبر برچسب زمانی عبارتند از `\f[CR]default\f[R]'، `\f[CR]iso\f[R]'،
`\f[CR]long\-iso\f[R]'، `\f[CR]full\-iso\f[R]'، `\f[CR]relative\f[R]'،
یا یک سبک سفارشی `\f[CR]+<FORMAT>\f[R]' (به عنوان مثال،
`\f[CR]+%Y\-%m\-%d %H:%M\f[R]' => `\f[CR]2023\-09\-30 13:00\f[R]').
.PP
\f[CR]<FORMAT>\f[R] باید یک رشتهٔ قالب‌بندی chrono باشد.
برای جزئیات درباره نحو نگارش ساختار chrono، لطفاً بخوانید:
https://docs.rs/chrono/latest/chrono/format/strftime/index.html .
.PP
به عنوان روش دیگر، \f[CR]<FORMAT>\f[R] می‌تواند یک رشتهٔ دوخطی باشد؛ خط نخست
برای فایل‌های غیرجدید و خط دوم برای فایل‌های اخیر استفاده خواهد شد.
به عنوان مثال، اگر \f[CR]<FORMAT>\f[R] برابر با
\[lq]\f[CR]%Y\-%m\-%d %H<newline>\-\-%m\-%d %H:%M\f[R]\[rq] باشد، فایل‌های غیرجدید
=> \[lq]\f[CR]2022\-12\-30 13\f[R]\[rq]، و فایل‌های اخیر =>
\[lq]\f[CR]\-\-09\-30 13:34\f[R]\[rq].
.TP
\f[CR]\-\-total\-size\f[R]
نمایش اندازهٔ بازگشتی دایرکتوری (فقط در یونیکس).
.TP
\f[CR]\-u\f[R], \f[CR]\-\-accessed\f[R]
استفاده از فیلد برچسب زمانی آخرین دسترسی (accessed).
.TP
\f[CR]\-U\f[R], \f[CR]\-\-created\f[R]
استفاده از فیلد برچسب زمانی ایجاد (created).
.TP
\f[CR]\-\-no\-permissions\f[R]
حذف فیلد مجوزها از خروجی.
.TP
\f[CR]\-o\f[R], \f[CR]\-\-octal\-permissions\f[R]
فهرست کردن مجوزهای هر فایل در قالب هشت‌هشتی (octal).
.TP
\f[CR]\-\-no\-filesize\f[R]
حذف فیلد اندازهٔ فایل از خروجی.
.TP
\f[CR]\-\-no\-user\f[R]
حذف فیلد کاربر از خروجی.
.TP
\f[CR]\-\-no\-time\f[R]
حذف فیلد زمان از خروجی.
.TP
\f[CR]\-\-stdin\f[R]
زمانی که می‌خواهید دایرکتوری‌ها را به eza هدایت (pipe) کرده یا از ورودی استاندارد (stdin) بخوانید.
هر مورد را در یک خط جدا کنید یا نویسهٔ جداساز سفارشی را در متغیر محیطی
\f[CR]EZA_STDIN_SEPARATOR\f[R] تعریف نمایید.
.TP
\f[CR]\-\[at]\f[R], \f[CR]\-\-extended\f[R]
فهرست کردن ویژگی‌های گسترش‌یافته (extended attributes) و اندازه‌های هر فایل.
.TP
\f[CR]\-Z\f[R], \f[CR]\-\-context\f[R]
فهرست کردن زمینهٔ امنیتی (security context) هر فایل.
.TP
\f[CR]\-\-git\f[R] [اگر eza با پشتیبانی از git ساخته شده باشد]
فهرست کردن وضعیت Git هر فایل، در صورتی که ردیابی شده باشد.
این گزینه یک ستون دو نویسه‌ای اضافه می‌کند که به ترتیب وضعیت‌های
آماده‌سازی‌شده (staged) و آماده‌سازی‌نشده (unstaged) را نشان می‌دهد.
نویسهٔ وضعیت می‌تواند شامل موارد زیر باشد: `\f[CR]\-\f[R]' برای تغییرنیافته،
`\f[CR]M\f[R]' برای فایل تغییریافته، `\f[CR]N\f[R]' برای فایل جدید،
`\f[CR]D\f[R]' برای حذف‌شده، `\f[CR]R\f[R]' برای تغییرنام‌یافته، `\f[CR]T\f[R]'
برای تغییر نوع، `\f[CR]I\f[R]' برای نادیده‌گرفته‌شده، و `\f[CR]U\f[R]' برای
دارای تداخل (conflicted).
دایرکتوری‌ها وضعیتی متناسب با محتوای خود نشان خواهند داد؛ به همین دلیل است که
«حذف‌شده» برای دایرکتوری نیز ممکن است، و اگر دایرکتوری حاوی فایلی با وضعیتی
خاص باشد، با همان وضعیت نمایش داده خواهد شد..TP
\f[CR]\-\-git\-repos\f[R] [اگر eza با پشتیبانی از git ساخته شده باشد]
وضعیت Git هر پوشه را، در صورت ردگیری شدن، فهرست می‌کند.
نمادهای نمایش‌داده‌شده عبارتند از: \f[CR]|\f[R]= بدون تغییر (clean)، \f[CR]+\f[R]= تغییریافته (dirty) و
\f[CR]\[ti]\f[R]= برای ناشناخته (unknown).
.TP
\f[CR]\-\-git\-repos\-no\-status\f[R] [اگر eza با پشتیبانی از git ساخته شده باشد]
مخزن Git بودن پوشه را فهرست می‌کند، اما وضعیت آن را نشان نمی‌دهد.
تمامی پوشه‌های مخزن Git به‌صورت نماد \f[CR]\-\f[R] (همراه با تم) و
بدون مشخص شدن وضعیت نمایش داده خواهند شد.
.TP
\f[CR]\-\-no\-git\f[R]
وضعیت Git را نمایش نمی‌دهد (همواره بر \f[CR]\-\-git\f[R]،
\f[CR]\-\-git\-repos\f[R] و \f[CR]\-\-git\-repos\-no\-status\f[R] تقدم دارد و آن‌ها را لغو می‌کند).
.SH "محیط (ENVIRONMENT)"
اگر متغیر محیطی با پیشوند \f[CR]EZA_\f[R] مقداردهی نشده باشد، برای
حفظ سازگاری با نسخه‌های پیشین، به‌طور پیش‌فرض از متغیر همتای آن که با
\f[CR]EXA_\f[R] شروع می‌شود استفاده خواهد شد.
.PP
دستور eza به متغیرهای محیطی زیر پاسخ می‌دهد:
.SS \f[CR]COLUMNS\f[R]
عرض ترمینال را برحسب تعداد نویسه‌ها بازنویسی می‌کند، هرچند گزینهٔ
\f[CR]\-w\f[R] اولویت بالاتری دارد.
.PP
برای نمونه، دستور `\f[CR]COLUMNS=80 eza\f[R]' یک نمای شبکه‌ای (grid) را
با حداکثر عرض ۸۰ نویسه نمایش می‌دهد.
.PP
این متغیر زمانی که خروجی eza سطرشکنی (wrap) نمی‌شود، مانند زمان استفاده
از نمای \f[CR]\-\-long\f[R]، هیچ تأثیری نخواهد داشت.
.SS \f[CR]EZA_STRICT\f[R]
«حالت سخت‌گیرانه» (\f[I]strict mode\f[R]) را فعال می‌کند که باعث می‌شود
در صورت ناسازگاری دو گزینهٔ خط فرمان با یکدیگر، eza با خطا متوقف شود.
.PP
به‌طور معمول، گزینه‌ها در خط فرمان می‌توانند از راست به چپ جایگزین
گزینه‌های قبلی شوند، به‌طوری که امکان ساخت نام‌های مستعار (alias) برای eza
وجود دارد: تعریف یک نام مستعار مانند `\f[CR]eza=eza \-\-sort=ext\f[R]' و
سپس اجرای `\f[CR]eza \-\-sort=size\f[R]' با آن نام مستعار، در عمل دستور
`\f[CR]eza \-\-sort=ext \-\-sort=size\f[R]' را اجرا خواهد کرد، و
مرتب‌سازی تعیین‌شده توسط کاربر جایگزین مرتب‌سازی مشخص‌شده در نام مستعار می‌شود.
.PP
در حالت سخت‌گیرانه، این دو گزینه با یکدیگر همکاری نکرده و eza با
خطا متوقف خواهد شد.
.PP
این گزینه برای استفاده در اسکریپت‌های خودکار و شرایط دیگری در نظر گرفته
شده است که می‌خواهید از وارد کردن دستور درست اطمینان قطعی داشته باشید.
.SS \f[CR]EZA_GRID_ROWS\f[R]
نمای جزئیات شبکه‌ای (`\f[CR]eza \-\-grid \-\-long\f[R]') را محدود می‌کند،
به‌گونه‌ای که تنها در صورتی فعال شود که دست‌کم تعداد سطرهای مشخص‌شده از
خروجی تولید گردد.
.PP
در نمایشگرهای عریض، این امکان وجود دارد که شبکه بسیار پهن و پراکنده به
نظر برسد و تنها در یک یا دو سطر بدون تراز بودن ستون‌ها نمایش یابد.
با مشخص کردن حداقل تعداد سطرها، می‌توانید کاری کنید که این نما تنها زمانی
به کار رود که ارزش استفاده را داشته باشد.
.SS \f[CR]EZA_ICON_SPACING\f[R]
تعداد فاصله‌هایی (spaces) را تعیین می‌کند که باید بین یک آیکون (گزینهٔ
`\f[CR]\-\-icons\f[R]' را ببینید) و نام فایل آن چاپ شود.
.PP
شبیه‌سازهای ترمینال مختلف آیکون‌ها را متفاوت نمایش می‌دهند، چرا که آن‌ها معمولاً
بیش از یک نویسه از عرض صفحه را اشغال می‌کنند؛ بنابراین هیچ تعداد فاصلهٔ
\[lq]استانداردی\[rq] وجود ندارد که eza بتواند برای تفکیک آیکون از متن از آن استفاده کند.
یک فاصله ممکن است آیکون را بیش از حد به متن نزدیک کند و دو فاصله ممکن است
آن را بیش از حد دور سازد.
بنابراین انتخاب و تنظیم این مورد بسته به شبیه‌ساز ترمینال، به عهدهٔ خود کاربر
گذاشته شده است.
.SS \f[CR]NO_COLOR\f[R]
رنگ‌ها را در خروجی غیرفعال می‌کند (صرف‌نظر از مقداری که دارد).
می‌توان با گزینهٔ \f[CR]\-\-color\f[R] آن را لغو و بازنویسی کرد.
.PP
برای جزئیات بیشتر به \f[CR]https://no\-color.org\f[R] مراجعه کنید.
.SS \f[CR]LS_COLORS\f[R], \f[CR]EZA_COLORS\f[R]
طرح رنگی مورد استفاده برای برجسته‌سازی فایل‌ها بر اساس نام و نوع آن‌ها،
و همچنین برجسته‌سازی فراداده‌ها و بخش‌هایی از رابط کاربری را تعیین می‌کند.
.PP
برای دریافت اطلاعات بیشتر دربارهٔ ساختار این متغیرهای محیطی، به صفحهٔ
راهنمای eza_colors.5.md مراجعه کنید.
.SS \f[CR]EZA_OVERRIDE_GIT\f[R]
هرگونه آرگومان \f[CR]\-\-git\f[R] یا \f[CR]\-\-git\-repos\f[R] را لغو و بازنویسی می‌کند.
.SS \f[CR]EZA_MIN_LUMINANCE\f[R]
حداقل روشنایی (luminance) را برای زمان فعال بودن مقیاس رنگ (color\-scale) تعیین می‌کند.
مقدار آن می‌تواند عددی بین \-100 تا 100 باشد.
.SS \f[CR]EZA_ICONS_AUTO\f[R]
در صورت تنظیم، رفتاری معادل با استفاده از \f[CR]\-\-icons\f[R] یا
\f[CR]\-\-icons=auto\f[R] را به‌طور خودکار اعمال می‌کند.
زمانی کاربرد دارد که بخواهید آیکون‌ها همواره فعال باشند.
.PP
هرگونه استفادهٔ صریح از پرچم \f[CR]\-\-icons=WHEN\f[R] این رفتار را لغو خواهد کرد.
.SS \f[CR]EZA_STDIN_SEPARATOR\f[R]
جداکننده‌ای را که هنگام هدایت (pipe) نام فایل‌ها از ورودی استاندارد (stdin)
استفاده می‌شود مشخص می‌کند.
پیش‌فرض آن نویسهٔ خط جدید (newline) است.
.SS \f[CR]EZA_CONFIG_DIR\f[R]
پوشه‌ای را تعیین می‌کند که eza در آن به‌دنبال فایل‌های پیکربندی و
تم‌های خود می‌گردد.
در صورتی که \f[CR]XDG_CONFIG_HOME\f[R] مقداردهی نشده باشد، مقدار پیش‌فرض
آن \f[CR]$XDG_CONFIG_HOME/eza\f[R] یا \f[CR]$HOME/.config/eza\f[R] خواهد بود.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
اگر همه‌چیز بدون خطا و به‌درستی انجام شود.
.TP
1
اگر در حین عملیات یک خطای ورودی/خروجی (I/O) رخ دهد.
.TP
3
اگر مشکلی در آرگومان‌های خط فرمان وجود داشته باشد.
.TP
13
اگر دسترسی لازم برای دسترسی به یک مسیر مجاز نباشد (Permission denied).
.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 از آن منشعب (fork) شده است..SH "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
\f[B]eza_colors\f[R](5)
.IP \[bu] 2
\f[B]eza_colors\-explanation\f[R](5)