نام (NAME)

moor - صفحه‌بندی‌کننده متنی خوش‌دست و کارآمد

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

moor [گزینه‌ها] file...
moor --help
moor --version

توضیحات (DESCRIPTION)

دستور moor یک صفحه‌بندی‌کننده متنی (pager) بسیار شبیه به less (1) است، اما به‌طور کلی با رفتار پیش‌فرض بهتر، روان‌تر و کاربرپسندتر ارائه شده است.

اطلاعات بیشتر و نماگرفت‌ها: https://github.com/walles/moor#readme

درون moor، برای دسترسی به راهنمای توکار کلید h را فشار دهید.

انتظار می‌رود ورودی متنی با کدگذاری UTF-8 (و در صورت تمایل فشرده‌شده) باشد. نویسه‌های نامعتبر یا غیرقابل‌چاپ به‌طور پیش‌فرض به شکل «?» نمایش داده می‌شوند.

اگر چندین فایل را باز کرده‌اید، برای جابه‌جایی میان آن‌ها کلید : را فشار دهید.

گزینه‌ها (OPTIONS)

در گزینه‌های چندگزینه‌ای، همواره مقدار پیش‌فرض در ابتدا ذکر شده است.

تمام این گزینه‌ها را می‌توان برای ماندگاری پیکربندی به متغیر محیطی MOOR اضافه کرد.

اجرای دستور moor --help نیز این گزینه‌ها را فهرست می‌کند.

--colors={auto | 8 | 16 | 256 | 16M}: اندازه پالت رنگی خروجی به ترمینال.
--debug: چاپ گزارش‌های اشکال‌زدایی پس از خروج؛ با جزئیات کمتر نسبت به --trace.
--follow: پیمایش خودکار به منظور دنبال کردن ورودی لوله‌کشی‌شده (piped)، دقیقاً مانند tail -f.
--lang=string: برای برجسته‌سازی نحوی (syntax highlighting) به کار می‌رود. بدون این پرچم، برجسته‌سازی بر اساس نام فایل ورودی تعیین می‌شود. مقادیر معتبر شامل انواع MIME مانند text/x-markdown، پسوندهای فایل مانند md یا نام زبان‌ها مانند markdown هستند. برای مشاهده مرجع دقیق آنچه پشتیبانی می‌شود، به نشانی https://github.com/alecthomas/chroma/tree/master/lexers/embedded یا پوشه والد آن مراجعه کنید.
--mousemode={auto | select | scroll}: تضمین عملکرد انتخاب متن با ماوس (اما احتمالاً بدون پشتیبانی از پیمایش با ماوس)، یا تضمین عملکرد پیمایش با ماوس (اما نیازمند تلاش مضاعف برای انتخاب متن). جزئیات در اینجا: https://github.com/walles/moor/blob/master/MOUSE.md
--no-clear-on-exit: حفظ محتویات صفحه هنگام خروج از moor. تحت تأثیر گزینه --no-clear-on-exit-margin قرار می‌گیرد.
--no-clear-on-exit-margin=int: تعداد خطوط خالی پس از خروج برای اعلان شل (shell prompt). مقدار پیش‌فرض ۱ است. بر گزینه‌های --no-clear-on-exit و --quit-if-one-screen اثر می‌گذارد.
--no-linenumbers: پنهان کردن شماره خطوط در ابتدای اجرا؛ برای نمایش آن کلید جهت‌نمای چپ را فشار دهید.
--no-reformat: هیچ اثری ندارد و صرفاً برای سازگاری با نسخه‌های پیشین وجود دارد. به گزینه --reformat مراجعه کنید.
--no-search-line-highlight: عدم برجسته‌سازی پس‌زمینه خطوط دارای نتایج جستجو. با این حال، خود موارد منطبق بر جستجو حتی با این گزینه نیز برجسته نمایش داده می‌شوند.
--no-statusbar: پنهان کردن نوار وضعیت؛ تغییر وضعیت با کلید =
--quit-if-one-screen: اگر محتوای ورودی در یک صفحه بگنجد، بدون صفحه‌بندی آن را چاپ می‌کند. تحت تأثیر گزینه --no-clear-on-exit-margin قرار دارد.
--reformat: قالب‌بندی مجدد فایل‌های ورودی پشتیبانی‌شده (مانند JSON) پیش از نمایش آن‌ها.
--render-unprintable={highlight | whitespace}: نحوه رندر و نمایش نویسه‌های غیرقابل‌چاپ.
--scroll-left-hint=string: نویسه UTF-8 برای نشان دادن امکان پیمایش نما به چپ؛ مقدار پیش‌فرض نویسه معکوس < است. این مقدار می‌تواند رشته‌ای حاوی قالب‌بندی ANSI باشد. کلمه ESC با حروف بزرگ به عنوان یک نویسه گریز (Escape) تفسیر می‌شود. مقدار نمونه برای نویسه تیلد کم‌رنگ (با استفاده از کد ANSI SGR 2): ESC[2m~
--scroll-right-hint=string: نویسه UTF-8 برای نشان دادن امکان پیمایش نما به راست؛ مقدار پیش‌فرض نویسه معکوس > است. این مقدار می‌تواند رشته‌ای حاوی قالب‌بندی ANSI باشد. کلمه ESC با حروف بزرگ به عنوان یک نویسه گریز (Escape) تفسیر می‌شود. مقدار نمونه برای نویسه تیلد کم‌رنگ (با استفاده از کد ANSI SGR 2): ESC[2m~
--shift=int: میزان پیمایش افقی با کلیدهای جهت‌نما. همچنین می‌توانید برای پیمایش ستون به ستون از ALT+جهت‌نما استفاده کنید.
--statusbar={inverse | plain | bold}: سبک و شیوه نمایش نوار وضعیت.
--style={native | style}: سبک برجسته‌سازی نحوی برگرفته از https://xyproto.github.io/splash/docs/longer/all.html
--tab-size=int: تعداد فاصله‌ها به ازای هر تب (tab stop)، پیش‌فرض ۸ است. همچنین می‌توانید هنگام اجرای moor از CTRL-t برای تغییر وضعیت استفاده کنید.
--terminal-fg: استفاده از رنگ پیش‌زمینه ترمینال به جای رنگ پیش‌زمینه سبک برای متن‌های بدون قالب. اگر پنجره ترمینال شما به جای یک رنگ یکدست دارای تصویر پس‌زمینه است، این گزینه را امتحان کنید.
--trace: چاپ گزارش‌های ردگیری (trace) پس از خروج؛ با جزئیات بیشتر نسبت به --debug.
--wrap: شکستن خطوط طولانی؛ تغییر وضعیت با کلید w
+1234: پیمایش فوری به خط 1234
+/pattern: پیمایش فوری به خط منطبق بر pattern

فایل‌ها (FILES)

$XDG_DATA_HOME/moor/search_history: دستور moor تاریخچه جستجوی شما را در این فایل ذخیره می‌کند. اگر متغیر $XDG_DATA_HOME تنظیم نشده باشد، این فایل در مسیر پیش‌فرض XDG که معمولاً ~/.local/share/moor/search_history است ذخیره می‌شود.

محیط (ENVIRONMENT)

LESS_TERMCAP_*: برای سازگاری عقروعلی با less، دستور moor تمام مقادیر LESS_TERMCAP_* را می‌خواند. در این مقادیر، هم نویسه‌های گریز واقعی و هم کلمه ESC با حروف بزرگ به عنوان نویسه گریز تفسیر می‌شوند. در moor، سبک‌بندی باید به‌جای این متغیرهای محیطی با استفاده از گزینه --style انجام پذیرد. مقدار نمونه: ESC[1m.
LESS_TERMCAP_md: قالب‌بندی مورد استفاده برای متن‌های پررنگ (bold) در صفحه راهنما.
LESS_TERMCAP_us: قالب‌بندی مورد استفاده برای متن‌های زیرخط‌دار (underlined) در صفحه راهنما.
LESS_TERMCAP_so: قالب‌بندی مورد استفاده برای نوار وضعیت و نتایج جستجو.
LESSSECURE: تنظیم این متغیر روی «1»، طبق الزامات systemctl(1) از باز کردن فایل‌های جدید یا راه‌اندازی برنامه‌های خارجی توسط moor جلوگیری می‌کند. در حالت امن، دستور «v» برای باز کردن فایل جاری در یک ویرایشگر غیرفعال می‌شود و فایل تاریخچه جستجو به‌روزرسانی نخواهد شد.
MOOR: در صورت تنظیم بودن این متغیر، گزینه‌های اضافی از آن خوانده می‌شوند؛ درست مانند آنکه همان گزینه‌ها به‌صورت دستی در هر بار فراخوانی moor اضافه شده باشند. با مقداردهی آن به --reformat می‌توانید ورودی‌های JSON را به‌صورت خودکار بازقالب‌بندی کنید!
PAGER: در صورت تنظیم روی «moor»، بسیاری از برنامه‌ها از moor به عنوان صفحه‌بندی‌کننده خود استفاده خواهند کرد.
PAGER_WRAP_COLUMNS: در صورت تنظیم روی یک عدد مثبت، حداکثر عرض مجاز برای شکستن خطوط طولانی را محدود می‌کند.
PAGER_LABEL: برنامه‌های دیگر می‌توانند این متغیر را برای تعیین نام نمایشی ورودی استاندارد (stdin) در moor تنظیم کنند.

گزارش باگ‌ها (BUGS)

لطفاً هرگونه باگ یا اشکال را در اینجا گزارش دهید: https://github.com/walles/moor/issues