.TH MOOR 1 2026-06-02
.SH "نام (NAME)"
moor \- صفحه‌بندی‌کننده متنی خوش‌دست و کارآمد
.SH "خلاصه دستور (SYNOPSIS)"
.B moor
[گزینه‌ها]
.IR file \&.\|.\|.
.br
.B "moor \-\-help"
.br
.B "moor \-\-version"
.SH "توضیحات (DESCRIPTION)"
دستور
.B moor
یک صفحه‌بندی‌کننده متنی (pager) بسیار شبیه به
.I less
(1) است، اما به‌طور کلی با رفتار پیش‌فرض بهتر، روان‌تر و کاربرپسندتر ارائه شده است.
.PP
اطلاعات بیشتر و نماگرفت‌ها: https://github.com/walles/moor#readme
.PP
درون \fBmoor\fR، برای دسترسی به راهنمای توکار کلید
.B h
را فشار دهید.
.PP
انتظار می‌رود ورودی متنی با کدگذاری UTF-8 (و در صورت تمایل فشرده‌شده) باشد.
نویسه‌های نامعتبر یا غیرقابل‌چاپ به‌طور پیش‌فرض به شکل «?» نمایش داده می‌شوند.
.PP
اگر چندین فایل را باز کرده‌اید، برای جابه‌جایی میان آن‌ها کلید
.B :
را فشار دهید.
.SH "گزینه‌ها (OPTIONS)"
در گزینه‌های چندگزینه‌ای، همواره مقدار پیش‌فرض در ابتدا ذکر شده است.
.PP
تمام این گزینه‌ها را می‌توان برای ماندگاری پیکربندی به متغیر محیطی
.B MOOR
اضافه کرد.
.PP
اجرای دستور
.B moor --help
نیز این گزینه‌ها را فهرست می‌کند.
.TP
\fB\-\-colors\fR={\fBauto\fR | \fB8\fR | \fB16\fR | \fB256\fR | \fB16M\fR}
اندازه پالت رنگی خروجی به ترمینال.
.TP
\fB\-\-debug\fR
چاپ گزارش‌های اشکال‌زدایی پس از خروج؛ با جزئیات کمتر نسبت به
.BR \-\-trace .
.TP
\fB\-\-follow\fR
پیمایش خودکار به منظور دنبال کردن ورودی لوله‌کشی‌شده (piped)، دقیقاً مانند
.BR "tail \-f" .
.TP
\fB\-\-lang\fR=string
برای برجسته‌سازی نحوی (syntax highlighting) به کار می‌رود.
بدون این پرچم، برجسته‌سازی بر اساس نام فایل ورودی تعیین می‌شود.
مقادیر معتبر شامل انواع MIME مانند \fBtext/x-markdown\fP، پسوندهای فایل مانند \fBmd\fP یا نام زبان‌ها مانند \fBmarkdown\fP هستند.
برای مشاهده مرجع دقیق آنچه پشتیبانی می‌شود، به نشانی https://github.com/alecthomas/chroma/tree/master/lexers/embedded یا پوشه والد آن مراجعه کنید.
.TP
\fB\-\-mousemode\fR={\fBauto\fR | \fBselect\fR | \fBscroll\fR}
تضمین عملکرد انتخاب متن با ماوس (اما احتمالاً بدون پشتیبانی از پیمایش با ماوس)،
یا تضمین عملکرد پیمایش با ماوس (اما نیازمند تلاش مضاعف برای انتخاب متن).
جزئیات در اینجا: https://github.com/walles/moor/blob/master/MOUSE.md
.TP
\fB\-\-no\-clear\-on\-exit\fR
حفظ محتویات صفحه هنگام خروج از moor.
تحت تأثیر گزینه \fB--no-clear-on-exit-margin\fP قرار می‌گیرد.
.TP
\fB\-\-no\-clear\-on\-exit\-margin\fR=int
تعداد خطوط خالی پس از خروج برای اعلان شل (shell prompt). مقدار پیش‌فرض ۱ است. بر گزینه‌های \fB--no-clear-on-exit\fP و \fB--quit-if-one-screen\fP اثر می‌گذارد.
.TP
\fB\-\-no\-linenumbers\fR
پنهان کردن شماره خطوط در ابتدای اجرا؛ برای نمایش آن کلید جهت‌نمای چپ را فشار دهید.
.TP
\fB\-\-no\-reformat\fR
هیچ اثری ندارد و صرفاً برای سازگاری با نسخه‌های پیشین وجود دارد. به گزینه --reformat مراجعه کنید.
.TP
\fB\-\-no\-search\-line\-highlight\fR
عدم برجسته‌سازی پس‌زمینه خطوط دارای نتایج جستجو. با این حال، خود موارد منطبق بر جستجو حتی با این گزینه نیز برجسته نمایش داده می‌شوند.
.TP
\fB\-\-no\-statusbar\fR
پنهان کردن نوار وضعیت؛ تغییر وضعیت با کلید
.B =
.TP
\fB\-\-quit\-if\-one\-screen\fR
اگر محتوای ورودی در یک صفحه بگنجد، بدون صفحه‌بندی آن را چاپ می‌کند.
تحت تأثیر گزینه \fB--no-clear-on-exit-margin\fP قرار دارد.
.TP
\fB\-\-reformat\fR
قالب‌بندی مجدد فایل‌های ورودی پشتیبانی‌شده (مانند JSON) پیش از نمایش آن‌ها.
.TP
\fB\-\-render\-unprintable\fR={\fBhighlight\fR | \fBwhitespace\fR}
نحوه رندر و نمایش نویسه‌های غیرقابل‌چاپ.
.TP
\fB\-\-scroll\-left\-hint\fR=string
نویسه UTF-8 برای نشان دادن امکان پیمایش نما به چپ؛ مقدار پیش‌فرض نویسه معکوس \fB<\fR است.
این مقدار می‌تواند رشته‌ای حاوی قالب‌بندی ANSI باشد.
کلمه
.B ESC
با حروف بزرگ به عنوان یک نویسه گریز (Escape) تفسیر می‌شود.
مقدار نمونه برای نویسه تیلد کم‌رنگ (با استفاده از کد ANSI SGR 2):
.B ESC[2m~
.TP
\fB\-\-scroll\-right\-hint\fR=string
نویسه UTF-8 برای نشان دادن امکان پیمایش نما به راست؛ مقدار پیش‌فرض نویسه معکوس \fB>\fR است.
این مقدار می‌تواند رشته‌ای حاوی قالب‌بندی ANSI باشد.
کلمه
.B ESC
با حروف بزرگ به عنوان یک نویسه گریز (Escape) تفسیر می‌شود.
مقدار نمونه برای نویسه تیلد کم‌رنگ (با استفاده از کد ANSI SGR 2):
.B ESC[2m~
.TP
\fB\-\-shift\fR=int
میزان پیمایش افقی با کلیدهای جهت‌نما. همچنین می‌توانید برای پیمایش ستون به ستون از ALT+جهت‌نما استفاده کنید.
.TP
\fB\-\-statusbar\fR={\fBinverse\fR | \fBplain\fR | \fBbold\fR}
سبک و شیوه نمایش نوار وضعیت.
.TP
\fB\-\-style\fR={\fBnative\fR | \fIstyle\fR}
سبک برجسته‌سازی نحوی برگرفته از https://xyproto.github.io/splash/docs/longer/all.html
.TP
\fB\-\-tab\-size\fR=int
تعداد فاصله‌ها به ازای هر تب (tab stop)، پیش‌فرض ۸ است. همچنین می‌توانید هنگام اجرای
.B moor
از
.B CTRL-t
برای تغییر وضعیت استفاده کنید.
.TP
\fB\-\-terminal\-fg\fR
استفاده از رنگ پیش‌زمینه ترمینال به جای رنگ پیش‌زمینه سبک برای متن‌های بدون قالب.
اگر پنجره ترمینال شما به جای یک رنگ یکدست دارای تصویر پس‌زمینه است، این گزینه را امتحان کنید.
.TP
\fB\-\-trace\fR
چاپ گزارش‌های ردگیری (trace) پس از خروج؛ با جزئیات بیشتر نسبت به
.BR \-\-debug .
.TP
\fB\-\-wrap\fR
شکستن خطوط طولانی؛ تغییر وضعیت با کلید
.B w
.TP
\fB+1234\fR
پیمایش فوری به خط
.B 1234
.TP
\fB+/pattern\fR
پیمایش فوری به خط منطبق بر
.B pattern
.SH "فایل‌ها (FILES)"
.TP
.B $XDG_DATA_HOME/moor/search_history
دستور moor تاریخچه جستجوی شما را در این فایل ذخیره می‌کند. اگر متغیر $XDG_DATA_HOME تنظیم نشده باشد، این فایل در مسیر پیش‌فرض XDG که معمولاً \fB~/.local/share/moor/search_history\fR است ذخیره می‌شود.
.SH "محیط (ENVIRONMENT)"
.TP
.B LESS_TERMCAP_*
برای سازگاری عقروعلی با less، دستور moor تمام مقادیر
\fBLESS_TERMCAP_*\fR
را می‌خواند. در این مقادیر، هم نویسه‌های گریز واقعی و هم کلمه
.B ESC
با حروف بزرگ به عنوان نویسه گریز تفسیر می‌شوند.
در moor، سبک‌بندی باید به‌جای این متغیرهای محیطی با استفاده از گزینه \fB\-\-style\fR انجام پذیرد.
مقدار نمونه: \fBESC[1m\fR.
.TP
.B LESS_TERMCAP_md
قالب‌بندی مورد استفاده برای متن‌های پررنگ (bold) در صفحه راهنما.
.TP
.B LESS_TERMCAP_us
قالب‌بندی مورد استفاده برای متن‌های زیرخط‌دار (underlined) در صفحه راهنما.
.TP
.B LESS_TERMCAP_so
قالب‌بندی مورد استفاده برای نوار وضعیت و نتایج جستجو.
.TP
.B LESSSECURE
تنظیم این متغیر روی «1»، طبق الزامات
.B systemctl(1)\&
از باز کردن فایل‌های جدید یا راه‌اندازی برنامه‌های خارجی توسط moor جلوگیری می‌کند.
در حالت امن، دستور «v» برای باز کردن فایل جاری در یک ویرایشگر غیرفعال می‌شود و فایل تاریخچه جستجو به‌روزرسانی نخواهد شد.
.TP
.B MOOR
در صورت تنظیم بودن این متغیر، گزینه‌های اضافی از آن خوانده می‌شوند؛ درست مانند آنکه همان گزینه‌ها به‌صورت دستی در هر بار فراخوانی moor اضافه شده باشند. با مقداردهی آن به
\fB\-\-reformat\fR
می‌توانید ورودی‌های JSON را به‌صورت خودکار بازقالب‌بندی کنید!
.TP
.B PAGER
در صورت تنظیم روی «moor»، بسیاری از برنامه‌ها از
.B moor
به عنوان صفحه‌بندی‌کننده خود استفاده خواهند کرد.
.TP
.B PAGER_WRAP_COLUMNS
در صورت تنظیم روی یک عدد مثبت، حداکثر عرض مجاز برای شکستن خطوط طولانی را محدود می‌کند.
.TP
.B PAGER_LABEL
برنامه‌های دیگر می‌توانند این متغیر را برای تعیین نام نمایشی ورودی استاندارد (stdin) در moor تنظیم کنند.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً هرگونه باگ یا اشکال را در اینجا گزارش دهید: https://github.com/walles/moor/issues