.\" Manpage for broot
.\" Some items starting with a # are replaced on build
.TH broot 1 "" "1.60.0" "broot manpage"
.SH "نام (NAME)"
broot \- ابزار نمایش درختی، مدیریت فایل و راهانداز منعطف
.SH "خلاصه دستور (SYNOPSIS)"
.B broot
[\fIفلگ‌ها\fR]
[\fIگزینه‌ها\fR]
[\fIمسیر\fR]
.br
.B br
[\fIفلگ‌ها\fR]
[\fIگزینه‌ها\fR]
[\fIمسیر\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbroot\fR
به شما امکان می‌دهد ساختار سلسله‌مراتبی فایل‌ها را در یک نمای درختی کاوش کنید، پرونده‌ها را مدیریت نمایید، دستورها و کنش‌ها را راه‌اندازی کنید و کلیدهای میانبر دلخواه خود را تعریف نمایید.
.PP
بهترین روش اجرای
\fBbroot\fR
استفاده از تابع پوستهٔ
\fBbr\fR
است: این تابع پوسته دسترسی به دستورهای بیشتری، به‌ویژه
\fIcd\fR
را فراهم می‌سازد. تابع پوستهٔ
\fBbr\fR
در اولین اجرای
\fBbroot\fR
به‌صورت تعاملی نصب می‌شود.
.PP
فلگ‌ها و گزینه‌ها را می‌توان طبق معمول در زمان راه‌اندازی ارسال کرد یا در فایل پیکربندی نوشت. هر فلگ دارای یک فلگ معکوس (ضدفلگ) است تا بتوانید در خط فرمان، فلگی را که در فایل پیکربندی تنظیم شده لغو کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-dates\fR
نمایش تاریخ آخرین ویرایش فایل‌ها و دایرکتوری‌ها
.TP
\fB\-D\fR, \fB\-\-no\-dates\fR
عدم نمایش تاریخ آخرین ویرایش
.TP
\fB\-f\fR, \fB\-\-only\-folders\fR
تنها نمایش پوشه‌ها
.TP
\fB\-F\fR, \fB\-\-no\-only\-folders\fR
نمایش همزمان پوشه‌ها و فایل‌ها
.TP
\fB\-\-show\-root\-fs\fR
نمایش اطلاعات سیستم‌فایل در بالای صفحه
.TP
\fB\-g\fR, \fB\-\-show\-git\-info\fR
نمایش وضعیت‌های گیت فایل‌ها و آمار مخزن
.TP
\fB\-G\fR, \fB\-\-no\-show\-git\-info\fR
عدم نمایش وضعیت‌های گیت فایل‌ها و آمار مخزن
.TP
\fB\-\-git\-status\fR
تنها نمایش فایل‌هایی که وضعیت گیت قابل توجهی دارند، شامل فایل‌های پنهان
.TP
\fB\-\-help\fR
چاپ اطلاعات راهنما
.TP
\fB\-h\fR, \fB\-\-hidden\fR
نمایش فایل‌های پنهان
.TP
\fB\-H\fR, \fB\-\-no\-hidden\fR
عدم نمایش فایل‌های پنهان
.TP
\fB\-i\fR, \fB\-\-git\-ignored\fR
نمایش فایل‌های نادیده‌گرفته‌شده توسط گیت
.TP
\fB\-I\fR, \fB\-\-no\-git\-ignored\fR
عدم نمایش فایل‌های نادیده‌گرفته‌شده توسط گیت
.TP
\fB\-p\fR, \fB\-\-permissions\fR
نمایش مجوزها و دسترسی‌ها
.TP
\fB\-P\fR, \fB\-\-no\-permissions\fR
عدم نمایش مجوزها
.TP
\fB\-s\fR, \fB\-\-sizes\fR
نمایش اندازه فایل‌ها و دایرکتوری‌ها
.TP
\fB\-S\fR, \fB\-\-no\-sizes\fR
عدم نمایش اندازه‌ها
.TP
\fB\-\-sort\-by\-count\fR
مرتب‌سازی بر اساس تعداد (تنها یک سطح از درخت نمایش داده می‌شود)
.TP
\fB\-\-sort\-by\-date\fR
مرتب‌سازی بر اساس تاریخ (تنها یک سطح از درخت نمایش داده می‌شود)
.TP
\fB\-\-sort\-by\-size\fR
مرتب‌سازی بر اساس اندازه (تنها یک سطح از درخت نمایش داده می‌شود)
.TP
\fB\-\-sort\-by\-type\fR
مشابه با sort\-by\-type\-dirs\-first
.TP
\fB\-\-sort\-by\-type\-dirs\-first\fR
مرتب‌سازی بر اساس نوع، اولویت با دایرکتوری‌ها (تنها یک سطح از درخت نمایش داده می‌شود)
.TP
\fB\-\-sort\-by\-type\-dirs\-last\fR
مرتب‌سازی بر اساس نوع، اولویت آخر با دایرکتوری‌ها (تنها یک سطح از درخت نمایش داده می‌شود)
.TP
\fB\-w\fR, \fB\-\-whale\-spotting\fR
مرتب‌سازی بر اساس اندازه، همراه با نمایش فایل‌های نادیده‌گرفته‌شده و پنهان
.TP
\fB\-\-no\-sort\fR
عدم مرتب‌سازی
.TP
\fB\-t\fR, \fB\-\-trim\-root\fR
برش دادن سطح ریشه و عدم نمایش نوار پیمایش (scroll bar)
.TP
\fB\-T\fR, \fB\-\-no\-trim\-root\fR
عدم برش سطح ریشه، نمایش نوار پیمایش
.TP
\fB\-\-outcmd\fR=\fIOUTCMD\fR
محل نوشتن دستور ایجادشده (در صورت وجود)
.TP
\fB\-c\fR, \fB\-\-cmd\fR=\fICMD\fR
دستورهای جداشده با نقطه ویرگول جهت اجرا
.TP
\fB\-\-color\fR=\fICOLOR\fR [پیش‌فرض: auto]
فعال‌سازی قالب‌بندی و رنگ‌ها (پیش‌فرض معمولاً مناسب است)
.br

.br
[\fIمقادیر ممکن: \fRauto, yes, no]
.TP
\fB\-\-conf\fR=\fICONF\fR
مسیرهای جداشده با نقطه ویرگول برای فایل‌های پیکربندی خاص
.TP
\fB\-\-height\fR=\fIHEIGHT\fR
ارتفاع (در صورتی که نمی‌خواهید تمام صفحه پر شود یا برای خروجی پرونده)
.TP
\fB\-\-install\fR
نصب یا نصب مجدد تابع پوستهٔ br
.TP
\fB\-\-set\-install\-state\fR=\fISET_INSTALL_STATE\fR
تعیین وضعیت نصب تابع پوسته (در صورت وجود)
.br

.br
[\fIمقادیر ممکن: \fRundefined, refused, installed]
.TP
\fB\-\-print\-shell\-function\fR=\fIPRINT_SHELL_FUNCTION\fR
چاپ تابع پوستهٔ br در خروجی استاندارد (stdout) برای یک پوسته مشخص
.TP
\fB\-\-listen\fR=\fILISTEN\fR
یک سوکت برای دریافت و گوش دادن به دستورها
.TP
\fB\-\-get\-root\fR
درخواست ریشهٔ فعلی از نمونهٔ broot راه دور
.TP
\fB\-\-write\-default\-conf\fR=\fIWRITE_DEFAULT_CONF\fR
نوشتن فایل‌های پیکربندی پیش‌فرض در پوشه داده‌شده
.TP
\fB\-\-send\fR=\fISEND\fR
یک سوکت که broot پیش از خروج، دستورها را به آن ارسال می‌کند
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه و نگارش برنامه
.SH "اشکالات (BUGS)"
.PP
.B broot
در اغلب نصب‌های سیستم‌عامل
\fIویندوز\fR
کند عمل می‌کند.
.PP
در پلتفرم‌های یونیکس و مک، بیشتر مشکلاتی که ممکن است با آن‌ها روبرو شوید مربوط به برخی پایانه‌ها یا مالتی‌پلکسرهای پایانه (Terminal Multiplexers) است که یا برخی دستورالعمل‌های استاندارد TTY را رهگیری می‌کنند یا بافرینگ و استعلام اندازه صفحه را مختل می‌سازند. از این رو، فهرست میانبرهایی که می‌توانید در فایل پیکربندی تعریف کنید وابسته به سیستم شما است.
.SH "نویسندگان (AUTHORS)"
.B broot
نرم‌افزاری آزاد و متن‌باز است که توسط
\fIdenys.seguret@gmail.com\fR
نوشته شده است. کد منبع و مستندات آن در نشانی زیر در دسترس است:
.br
https://dystroy.org/broot
.SH "همچنین ببینید (SEE ALSO)"
.BR ls (1),
.BR tree (1)