توضیحات (DESCRIPTION)

نرم‌افزار ranger یک مدیر فایل متنی (کنسولی) با کلیدهای میانبر VI است.

منابع (RESOURCES)

این راهنما شامل دستورالعمل‌هایی دربارهٔ نحوهٔ استفاده و پیکربندی ranger است.

در داخل محیط ranger، می‌توانید با فشردن کلید ? فهرستی از میانبرهای صفحه کلید، دستورها یا تنظیمات را مشاهده کنید.

فایل README شامل دستورالعمل‌های نصب است.

فایل HACKING.md حاوی رهنمودهایی برای اصلاح و توسعهٔ کد منبع است.

دایرکتوری doc/configs شامل فایل‌های پیکربندی است. این فایل‌ها معمولاً در /usr/share/doc/ranger/config نصب می‌شوند و از طریق گزینهٔ --copy-config در ranger قابل دریافت هستند.

دایرکتوری examples شامل پیاده‌سازی‌های نمونه برای افزونه‌های ranger، نمونه فایل‌های پیکربندی و برنامه‌هایی جهت یکپارچه‌سازی ranger با سایر نرم‌افزارها است. این فایل‌ها معمولاً در /usr/share/doc/ranger/examples نصب می‌شوند.

صفحهٔ راهنمای rifle(1) وظایف و عملکردهای بازکنندهٔ فایل (file opener) را شرح می‌دهد.

بخش LINKS در این صفحهٔ راهنما شامل منابع بیشتری است.

آرگومان‌های مکانی (POSITIONAL ARGUMENTS)

path ...

هر مسیر در یک زبانه (تب) باز می‌شود و در صورتی که مسیر اشاره به یک فایل باشد، آن فایل انتخاب خواهد شد. حذف این آرگومان معادل ارائهٔ مسیر دایرکتوری جاری است.

گزینه‌ها (OPTIONS)

-d, --debug

فعال‌سازی حالت اشکال‌زدایی: با وقوع هر خطا، ranger خارج شده و گزارش کامل ردیابی (traceback) را چاپ می‌کند. رفتار پیش‌فرض این است که صرفاً نام استثنا در نوار وضعیت/لاگ چاپ شود و برنامه به کار خود ادامه دهد.

-c, --clean

فعال‌سازی حالت پاک: ranger به هیچ فایل پیکربندی دسترسی نخواهد داشت و هیچ فایلی نیز ایجاد نخواهد کرد و اثری از خود بر روی سیستم شما باقی نمی‌گذارد. این گزینه زمانی که پیکربندی شما خراب شده، یا می‌خواهید از ایجاد داده‌های اضافی جلوگیری کنید، مفید است.

--cachedir=dir

تغییر دایرکتوری حافظهٔ پنهان (cache) در ranger از مسیر $XDG_CACHE_HOME یا ~/.cache/ranger به "dir".

-r dir, --confdir=dir

تغییر دایرکتوری پیکربندی ranger از مسیر $XDG_CONFIG_HOME یا ~/.config/ranger به "dir".

--datadir=dir

تغییر دایرکتوری داده‌های ranger از مسیر $XDG_DATA_HOME یا ~/.local/share/ranger به "dir".

--copy-config=file

رونوشت فایل‌های پیکربندی پیش‌فرض را در دایرکتوری پیکربندی محلی شما ایجاد می‌کند. فایل‌های موجود بازنویسی نخواهند شد. مقادیر مجاز: all، commands، commands_full، rc، rifle، scope.

نکته: با صادر کردن RANGER_LOAD_DEFAULT_RC=FALSE در محیط کاربری خود، می‌توانید بارگذاری فایل‌های پیکربندی سراسری را غیرفعال کنید. همچنین ببینید: FILES، ENVIRONMENT

گزینهٔ --copy-config=commands تنها یک فایل پیکربندی نمونهٔ مختصر را همراه با مستندات و مثال‌های کامل رونوشت می‌کند. توصیه می‌شود این فایل را تمیز و کم‌حجم نگه دارید تا هنگام ارتقای ranger دچار دستورهای منسوخ و ازکارافتاده نشوید. فایل پیش‌فرض کامل commands.py را می‌توان با --copy-config=commands_full رونوشت کرد، اما ranger آن فایل را نادیده می‌گیرد و صرفاً به عنوان مرجعی برای نوشتن دستورهای اختصاصی شما کاربرد دارد.

--choosefile=targetfile

امکان انتخاب یک فایل از طریق ranger را فراهم می‌کند. این گزینه رفتار برنامه را به گونه‌ای تغییر می‌دهد که با باز کردن یک فایل، ranger خارج شده و مسیر مطلق آن فایل را در targetfile می‌نویسد.

--choosefiles=targetfile

امکان انتخاب چند فایل از طریق ranger را فراهم می‌کند. این گزینه رفتار برنامه را تغییر می‌دهد تا با باز کردن یک فایل، ranger خارج شده و مسیر مطلق تمام فایل‌های انتخاب‌شده را با افزودن یک خط جدید پس از نام هر فایل، در targetfile بنویسد.

--choosedir=targetfile

امکان انتخاب یک دایرکتوری از طریق ranger را فراهم می‌کند. هنگام خروج از ranger، آخرین دایرکتوری بازدید شده در targetfile نوشته خواهد شد.

--selectfile=targetfile

باز کردن ranger در حالی که targetfile به حالت انتخاب درآمده است. این یک گزینهٔ قدیمی (legacy) است و رفتار بخش POSITIONAL ARGUMENTS جایگزین آن شده است.

--show-only-dirs

فقط نمایش دادن دایرکتوری‌ها. می‌تواند همراه با گزینهٔ --choosedir=targetfile استفاده شود.

--list-unused-keys

فهرست کردن کلیدهای رایجی که در محیط "browser" به هیچ عملیاتی متصل نشده‌اند. این فهرست کامل نیست؛ شما می‌توانید هر کلیدی را که curses پشتیبانی می‌کند اختصاص دهید: از کد کلید بازگردانده شده توسط "getch()" استفاده کنید.

--list-tagged-files=tag

فهرست کردن تمام فایل‌هایی که با برچسب ارائه‌شده مشخص شده‌اند. نکته: برچسب‌ها تک‌نویسه‌ای هستند. برچسب پیش‌فرض "*" است.

--profile

چاپ آمار مصرف پردازنده (CPU) در زمان خروج.

--cmd=command

اجرای دستور پس از خواندن کامل پیکربندی. برای اجرای چند دستور می‌توانید از این گزینه چندین بار استفاده کنید.

--version

نمایش نسخه و خروج.

-h، --help

نمایش فهرست گزینه‌ها و خروج..SH "مفاهیم (CONCEPTS)" این بخش نحوه کارکرد بخش‌های خاصی از ranger و چگونگی استفاده بهینه از آن‌ها را توضیح می‌دهد.

%f   فایل برجسته‌شده (زیر نشانگر)
%d   مسیر دایرکتوری جاری
%s   فایل‌های انتخاب‌شده در دایرکتوری جاری
%t   همهٔ فایل‌های برچسب‌خورده در دایرکتوری جاری
%c   مسیرهای کامل فایل‌های کپی یا بریده‌شدهٔ (cut) فعلی
%p   مسیرهای کامل فایل‌های انتخاب‌شده

فایل A را کپی (yank) کنید (yy را بزنید)، به فایل B بروید، سپس بنویسید:
@diff %c %f

map c<any> echo %any

map m<any> set_bookmark %any

map c<any> echo %any_path

map p'<any> paste dest=%any_path

f   انشعاب فرایند (Fork)، یعنی اجرا در پس‌زمینه. لطفاً از این پرچم
    به‌جای فراخوانی "disown" یا "nohup" استفاده کنید، تا هنگام فشردن
    Ctrl+C در ranger، از بسته شدن دستور پس‌زمینه جلوگیری شود.
c   اجرای تنها فایل جاری، به‌جای موارد انتخاب‌شده
r   اجرای برنامه با دسترسی ریشه (نیازمند sudo)
t   اجرای برنامه در یک پنجره پایانه جدید

p   هدایت خروجی به صفحه‌بندی‌کننده (pager)
s   حالت بی‌صدا (Silent). خروجی دور ریخته خواهد شد.
w   انتظار برای فشردن کلید Enter هنگام پایان فرایند

grep 'def hook_' -r /path/to/rangers/source

pydoc ranger.api

دکمه‌های ماوس (MOUSE BUTTONS)

Left Mouse Button

روی یک مورد کلیک کنید تا به آنجا بروید. برای اجرای یک فایل، با کلیک روی پیش‌نمایش، مانند یک دایرکتوری "وارد" آن شوید.

Right Mouse Button

ورود به یک دایرکتوری یا اجرای یک فایل.

Scroll Wheel

پیمایش به بالا یا پایین. می‌توانید هنگام پیمایش به ستون دایرکتوری والد اشاره کنید تا بین دایرکتوری‌ها جابه‌جا شوید..SH "تنظیمات (SETTINGS)" این بخش تمام تنظیمات توکار ranger را فهرست می‌کند. انواع معتبر برای مقدار در [کروکه‌ها] آمده‌اند. کلید فوری برای تغییر وضعیت تنظیم در صورت وجود، درون <علامت‌های زاویه‌دار> قرار دارد.

تنظیمات را می‌توان در فایل ~/.config/ranger/rc.conf یا در حین اجرا با دستور :set option value تغییر داد. مثال‌ها:

set column_ratios 1,2,3
set show_hidden true

تغییر وضعیت گزینه‌ها را می‌توان با این دستور انجام داد:

set show_hidden!

انواع مختلف تنظیمات و یک مثال برای هر نوع:

setting type   | example values
---------------+----------------------------
bool           | true, false
integer        | 1, 23, 1337
string         | foo, hello world
list           | 1,2,3,4
none           | none

می‌توانید با فشردن "3?" در ranger، فهرستی از تمام تنظیمات و مقادیر فعلی آن‌ها را مشاهده کنید.

automatically_count_files [bool]

آیا ranger باید به محض نمایان شدن هر دایرکتوری، تعداد فایل‌های درون آن را شمارش کرده و نمایش دهد؟ این کار در سیستم‌فایل‌های دوردست (remote) کُند می‌شود. خاموش کردن آن همچنان به شما امکان می‌دهد پس از ورود به دایرکتوری، تعداد فایل‌ها را مشاهده کنید.

autosave_bookmarks [bool]

ذخیرهٔ فوری نشانک‌ها (استفاده‌شده با mX و `X)؟ این کار به همگام‌سازی نشانک‌ها میان چندین نمونهٔ ranger کمک می‌کند اما منجر به افت عملکرد *اندکی* می‌شود. در صورت false بودن، نشانک‌ها هنگام خروج از ranger ذخیره می‌شوند.

autoupdate_cumulative_size [bool]

شما می‌توانید با استفاده از دستور :get_cumulative_size یا تایپ "dc"، حجم تجمیعی «واقعی» دایرکتوری‌ها را نمایش دهید. محاسبهٔ این حجم سنگین است و به‌صورت خودکار به‌روزرسانی نخواهد شد. با این حال، با فعال کردن این گزینه می‌توانید به‌روزرسانی خودکار آن را انتخاب کنید.

cd_bookmarks [bool]

مشخص می‌کند که آیا نشانک‌ها باید در تکمیل خودکار با کلید تب (tab completion) برای دستور "cd" گنجانده شوند یا خیر.

cd_tab_case [string]

حساسیت به حروف بزرگ و کوچک را برای تکمیل با تب در دستور "cd" تغییر می‌دهد. مقادیر ممکن عبارتند از:

sensitive
insensitive
smart

cd_tab_fuzzy [bool]

استفاده از تکمیل فازی با کلید تب در دستور "cd". برای مثال، :cd /u/lo/b<TAB> به :cd /usr/local/bin بسط می‌یابد.

clear_filters_on_dir_change [bool]

اگر روی 'true' تنظیم شود، فیلترهای ماندگار با ترک دایرکتوری پاک خواهند شد.

collapse_preview [bool] <zc>

هنگامی که هیچ پیش‌نمایشی نمایان نیست، آیا ستون آخر باید جمع شود تا از فضای خالی استفاده به عمل آید؟

colorscheme [string]

کدام طرح رنگی استفاده شود؟ این طرح‌های رنگی به‌طور پیش‌فرض در دسترس هستند: default، jungle، snow. طرح snow یک طرح تک‌رنگ است، و jungle برای وضوح بهتر در برخی ترمینال‌ها، دایرکتوری‌های آبی را با رنگ سبز جایگزین می‌کند.

column_ratios [list]

چند ستون وجود دارد، و عرض‌های نسبی آن‌ها چقدر است؟ برای مثال، مقدار 1,1,1 به معنای ۳ ستون با اندازه‌های مساوی است. مقدار 1,1,1,1,4 یعنی ۵ ستون که در آن ستون پیش‌نمایش به اندازهٔ مجموع تمام ستون‌های دیگر است.

confirm_on_delete [string]

آیا هنگام اجرای دستور "delete" تأییدیه خواسته شود؟ مقادیر معتبر عبارتند از "always" (پیش‌فرض)، "never"، "multiple". با مقدار "multiple"، نرم‌افزار ranger تنها در صورتی درخواست تأیید می‌کند که چند فایل را هم‌زمان حذف کنید.

dirname_in_tabs [bool]

آیا نام دایرکتوری در زبانه‌ها نمایش داده شود؟

display_size_in_main_column [bool]

آیا حجم فایل در ستون اصلی نمایش داده شود؟

display_size_in_status_bar [bool]

آیا حجم فایل در نوار وضعیت نمایش داده شود؟

display_free_space_in_status_bar [bool]

آیا فضای خالی دیسک در نوار وضعیت نمایش داده شود؟

display_tags_in_all_columns [bool]

آیا برچسب‌ها در تمام ستون‌ها نمایش داده شوند؟

draw_borders [string]

رسم حاشیه‌ها در اطراف یا بین ستون‌ها؟ مقادیر ممکن عبارتند از:

none           بدون هیچ‌گونه حاشیه
outline        رسم کادر بیرونی دور تمام ستون‌ها
separators     رسم تنها خطوط عمودی بین ستون‌ها
both           هر دو مورد بالا

draw_progress_bar_in_status_bar [bool]

آیا یک نوار پیشرفت در نوار وضعیت رسم شود که وضعیت میانگین تمام وظایف در حال اجرای پشتیبانی‌کننده از نوار پیشرفت را نمایش دهد؟

flushinput [bool] <zi>

تخلیهٔ ورودی پس از هر بار فشردن کلید؟ یک مزیت این است که هنگام پیمایش به پایین با "j"، به محض رها کردن کلید، ranger فوراً پیمایش را متوقف می‌کند. یک عیب آن این است که هنگام تایپ سریع و ندیدهٔ دستورها، ممکن است برخی کلیدها از دست بروند.

freeze_files [bool] <F>

در صورت فعال بودن، دایرکتوری‌ها و فایل‌ها بارگذاری نخواهند شد، که در صورت بارگذاری بودن تمام فایل‌های مورد نیاز شما، کارایی را بهبود می‌بخشد. این مورد بر پیش‌نمایش فایل‌ها تأثیری ندارد.

global_inode_type_filter [string]

مشابه filter_inode_type، اما به‌صورت سراسری برای تمام دایرکتوری‌ها. در ترکیب با --choosedir کاربردی است:

ranger --choosedir=/tmp/x --cmd='set global_inode_type_filter d'

hidden_filter [string]

یک الگوی عبارت منظم برای فایل‌هایی که باید پنهان شوند. برای نمونه، این الگو تمام فایل‌هایی را که با نقطه شروع شده یا با تیلدا پایان می‌یابند پنهان می‌کند.

set hidden_filter ^\.|~$

hint_collapse_threshold [int]

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

hostname_in_titlebar [bool]

آیا hostname در نوار عنوان نمایش داده شود؟

size_in_bytes [bool]

چاپ اندازهٔ فایل‌ها به بایت، به جای قالب پیش‌فرض خوانا برای انسان.

idle_delay [integer]

مدت زمانی (به میلی‌ثانیه) که ranger در حالت بی‌کار منتظر ورودی کاربر می‌ماند، با دقت ۱۰۰ میلی‌ثانیه. تأخیر کمتر، وقفهٔ بین به‌روزرسانی‌های دایرکتوری را کاهش می‌دهد اما بار پردازنده (CPU) را افزایش می‌دهد.

iterm2_font_height [integer]

تغییر ارتفاع فرض‌شدهٔ قلم در iTerm2، که ممکن است به پیش‌نمایش تصویر در iTerm کمک کند.

iterm2_font_width [integer]

تغییر عرض فرض‌شدهٔ قلم در iTerm2، که ممکن است به پیش‌نمایش تصویر در iTerm کمک کند.

line_numbers [string]

نمایش شماره خط‌ها در ستون اصلی. مقادیر ممکن عبارتند از:

false      خاموش کردن این ویژگی
absolute   شماره‌خط‌های مطلق برای استفاده با "<N>gg"
relative   شماره‌خط‌های نسبی برای "<N>k" یا "<N>j"

max_console_history_size [integer, none]

چه تعداد از دستورهای کنسول باید در تاریخچه نگه داشته شوند؟ مقدار "none" این محدودیت را غیرفعال می‌کند..IP "max_history_size [integer, none]" 4 چه تعداد تغییر دایرکتوری باید در تاریخچه نگه‌داری شود؟

metadata_deep_search [bool]

هنگامی که پودمان مدیریت فراداده (metadata) به دنبال فراداده می‌گردد، آیا تنها به دنبال یک فایل ".metadata.json" در دایرکتوری جاری بگردد، یا یک جستجوی عمیق انجام دهد و تمام دایرکتوری‌های بالاتر از دایرکتوری جاری را نیز بررسی کند؟

mouse_enabled [bool] <zm>

ورودی موشواره فعال شود؟

nested_ranger_warning [string]

هنگام راه‌اندازی هشدار داده شود اگر "RANGER_LEVEL" بزرگتر از ۰ باشد؛ به عبارت دیگر هنگامی که ranger را در یک زیرپوسته اجرا شده توسط ranger به صورت تو در تو اجرا می‌کنید، هشدار داده شود. مقادیر مجاز عبارتند از "true"، "false" و "error". مقدار ویژهٔ "error" این هشدار را به یک خطا ارتقا می‌دهد؛ این معمولاً به عنوان متن قرمز نمایش داده می‌شود اما در صورت اجرا با پرچم "--debug"، باعث خرابی و بسته شدن ناگهانی (crash) برنامه ranger خواهد شد.

one_indexed [bool]

شروع شماره خطوط از ۱. مقادیر ممکن عبارتند از:

false      شروع شماره خطوط از ۰
true       شروع شماره خطوط از ۱

open_all_images [bool]

آیا هنگام اجرای نمایش‌دهنده‌های تصویر خاصی مانند feh یا sxiv، تمام تصاویر موجود در این دایرکتوری باز شوند؟ شما همچنان می‌توانید با علامت‌گذاری فایل‌ها، فایل‌های انتخابی را باز کنید.

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

padding_right [bool]

هنگامی که collapse_preview روشن است و پیش‌نمایشی وجود ندارد، آیا حاشیه خالی کمی در سمت راست باقی بماند؟ این به شما امکان می‌دهد تا با کلیک روی آن فضا، فایل را اجرا کنید.

preview_directories [bool] <zP>

پیش‌نمایش دایرکتوری‌ها در ستون پیش‌نمایش نمایش داده شود؟

preview_files [bool] <zp>

پیش‌نمایش فایل‌ها در ستون پیش‌نمایش نمایش داده شود؟

preview_images [bool]

تصاویر درون کنسول با استفاده از برنامه خارجی w3mimgpreview رسم شوند؟

preview_images_method [string]

تنظیم روش پیش‌نمایش تصویر. روش‌های پشتیبانی‌شده: w3m، iterm2، urxvt، urxvt-full، terminology. بخش PREVIEWS را ببینید.

preview_max_size [int]

خودداری از پیش‌نمایش فایل‌هایی که از اندازه‌ای مشخص (به بایت) تجاوز می‌کنند. برای غیرفعال کردن این ویژگی از مقدار ۰ استفاده کنید.

preview_script [string, none]

کدام اسکریپت باید تولید پیش‌نمایش‌ها را مدیریت کند؟ اگر فایل وجود نداشته باشد، یا use_preview_script خاموش باشد، ranger خود پیش‌نمایش‌ها را صرفاً با چاپ محتوا مدیریت خواهد کرد.

relative_current_zero [bool]

هنگامی که line_numbers روی relative تنظیم شده باشد، در صورت true بودن روی خط جاری عدد ۰ را نشان می‌دهد و در صورت false بودن شماره مطلق خط جاری نمایش داده می‌شود.

save_backtick_bookmark [bool]

نشانک "`" روی دیسک ذخیره شود. این نشانک برای رفتن به آخرین دایرکتوری با تایپ کردن "``" استفاده می‌شود.

save_console_history [bool]

آیا تاریخچه کنسول هنگام خروج ذخیره شود؟ در صورت غیرفعال بودن، تاریخچه کنسول هنگام راه‌اندازی مجدد ranger بازنشانی می‌شود.

save_tabs_on_exit [bool]

تمام تب‌ها، به جز تب فعال، هنگام خروج ذخیره شوند؟ آخرین تب‌های ذخیره‌شده یک بار هنگام شروع نشست بعدی بازیابی می‌شوند. نشست‌های متعدد در یک پشته (stack) ذخیره می‌شوند و قدیمی‌ترین تب‌های ذخیره‌شده ابتدا بازیابی خواهند شد.

scroll_offset [integer]

هنگام پیمایش، تلاش شود این مقدار فضا بین حاشیه بالا/پایین حفظ شود.

shorten_title [integer]

اگر عنوان پنجره طولانی شد، کوتاه شود؟ این عدد مشخص می‌کند چه تعداد دایرکتوری به طور همزمان نمایش داده شوند. مقدار ۰ این ویژگی را خاموش می‌کند.

show_cursor [bool]

مکان‌نمای ترمینال همیشه نمایش داده شود؟

show_hidden_bookmarks [bool]

نمایش فایل‌های نقطه‌دار (مخفی) در پنجره پیش‌نمایش نشانک‌ها؟ (تایپ کنید ')

show_hidden [bool] <zh>, <^H>

فایل‌های مخفی نمایش داده شوند؟

show_selection_in_titlebar [bool]

فایل برجسته‌شده به مسیر در نوار عنوان اضافه شود

sort_case_insensitive [bool] <zc>

مرتب‌سازی بدون حساسیت به بزرگی و کوچکی حروف؟ اگر true باشد، "a" قبل از "B" فهرست می‌شود حتی اگر مقدار ASCII آن بزرگتر باشد.

sort_directories_first [bool] <zd>

دایرکتوری‌ها در ابتدا مرتب شوند؟

sort_reverse [bool] <or>

ترتیب فایل‌ها معکوس شود؟

sort_unicode [bool]

هنگام مرتب‌سازی بر اساس یک رشته، آیا برای صرفه‌جویی در زمان به جای بررسی مقادیر خام نویسه‌ها، نویسه‌های یونیکد مقایسه شوند؟

sort [string] <oa>, <ob>, <oc>, <oe>, <om>, <on>, <ot>, <os>, <oz>

از چه سازوکار مرتب‌سازی استفاده شود؟ یکی از گزینه‌های atime، basename، ctime، extension، mtime، natural، type، size، random را انتخاب کنید.

نکته: می‌توانید با فشردن دومین حرف ترکیب کلیدی به صورت بزرگ، ترتیب را برعکس کنید؛ برای نمونه "oN" برای مرتب‌سازی از Z به A.

status_bar_on_top [bool]

نوار وضعیت در بالای پنجره قرار گیرد؟

tilde_in_titlebar [bool]

مسیر $HOME با ~ در نوار عنوان (خط اول) ranger کوتاه شود؟

unicode_ellipsis [bool]

استفاده از نویسه یونیکد "..." به جای "~" برای مشخص کردن نام‌های بریده‌شده فایل‌ها؟

bidi_support [bool]

تلاش برای نمایش صحیح نام فایل‌ها در زبان‌های راست‌به‌چپ (RTL) (مانند عبری و عربی) با استفاده از الگوریتم BIDI برای معکوس کردن بخش‌های مرتبط متن. به بسته pip با نام python-bidi نیاز دارد.

update_title [bool]

عنوان پنجره تنظیم شود؟ هر دو ویژگی WM_NAME و WM_ICON_NAME را به‌روزرسانی می‌کند.

update_tmux_title [bool]

مقدار window-name در tmux/screen به "ranger" تنظیم شود؟

use_preview_script [bool] <zv>

از اسکریپت پیش‌نمایش تعریف‌شده در تنظیم preview_script استفاده شود؟

vcs_aware [bool]

گردآوری و نمایش داده‌های مربوط به سیستم‌های کنترل نسخه. سیستم‌های vcs پشتیبانی‌شده: git، hg.

vcs_backend_git, vcs_backend_hg, vcs_backend_bzr, vcs_backend_svn [string]

وضعیت را برای باک‌اند سیستم کنترل نسخه تنظیم می‌کند. مقادیر ممکن عبارتند از:

disabled   هیچ اطلاعاتی نمایش نده.
local      تنها وضعیت محلی نمایش داده شود.
enabled    نمایش هر دو وضعیت محلی و دوردست.
           ممکن است برای hg و bzr کند باشد.

vcs_msg_length [int]

طول برش خط اول پیام‌های کامیت هنگام نمایش در نوار وضعیت. مقدار پیش‌فرض ۵۰ است.

viewmode [string]

حالت نما را تنظیم می‌کند، که می‌تواند miller برای نمایش فایل‌ها در نمای سنتی ستونی میلر (که چندین سطح از سلسله‌مراتب را نشان می‌دهد) باشد، یا multipane برای استفاده از چندین قاب (یکی به ازای هر تب) مشابه با midnight-commander.

w3m_delay [float]

تأخیر به ثانیه پیش از نمایش یک تصویر با روش w3m. در صورت مواجهه با به‌هم‌ریختگی در نمایش تصویر، آن را افزایش دهید.

w3m_offset [int]

انحراف (offset) به پیکسل برای حاشیه داخلی ترمینال. برخی ترمینال‌ها مانند st و UXterm نیاز دارند که این انحراف به‌طور صریح مشخص شود، و برخی دیگر مانند urxvt نیازی به آن ندارند.

wrap_plaintext_previews [bool]

آیا خطوط طولانی در پیجر (صفحه‌بندی‌کننده) شکسته شوند یا نه؛ این شامل پیش‌نمایش فایل‌های متنی ساده نیز می‌شود.

wrap_scroll [bool]

فعال‌سازی پیمایش چرخشی - حرکت به سمت پایین هنگامی که روی آخرین مورد قرار دارید، به ابتدا بازمی‌گردد و برعکس.

xterm_alt_key [bool]

اگر ترکیب‌های کلیدی با کلید Alt برای شما کار نمی‌کنند، این گزینه را فعال کنید. (به‌ویژه در xterm).SH "دستورها (COMMANDS)" شما می‌توانید دستورها را در کنسول، که با فشردن ":" باز می‌شود، وارد کنید.

شما همیشه می‌توانید با تایپ کردن "?c" در ranger، فهرستی از دستورهای موجود کنونی را دریافت کنید. جهت راحتی شما، این فهرستی از دستورهای «عمومی» شامل پارامترهای آن‌ها، بدون توضیحات است:

alias [newcommand] [oldcommand]
bulkrename
cd [path]
chain command1[; command2[; command3...]]
chmod octal_number
cmap key command
console [-pSTARTPOSITION] command
copycmap key newkey [newkey2...]
copymap key newkey [newkey2...]
copypmap key newkey [newkey2...]
copytmap key newkey [newkey2...]
cunmap keys...
default_linemode [path=regexp | tag=tags] linemodename
delete
echo [text]
edit [filename]
eval [-q] python_code
filter [string]
filter_inode_type [dfl]
find pattern
flat level
grep pattern
help
jump_non [-FLAGS...]
linemode linemodename
load_copy_buffer
map key command
mark pattern
mark_tag [tags]
meta key value
mkdir dirname
open_with [application] [flags] [mode]
pmap key command
prompt_metadata [key1 [key2 [...]]]
punmap keys...
quit
quit!
quitall
quitall!
relink newpath
rename_append [-FLAGS...]
rename newname
save_copy_buffer
scout [-FLAGS...] pattern
search pattern
search_inc pattern
set option value
setintag tags option value
setlocal [path=<path>] option value
shell [-FLAGS...] command
source filename
terminal
tmap key command
touch filename
trash
travel pattern
tunmap keys...
unmap keys...
unmark pattern
unmark_tag [tags]

دستورهای دیگری نیز وجود دارند که مستقیماً به توابع پایتون ترجمه می‌شوند، یک دستور به‌ازای هر متد در کلاس ranger.core.actions.Actions. این دستورها در اینجا مستند نشده‌اند، چرا که بیشتر برای مقیدسازی کلیدها هستند و نه برای تایپ شدن توسط کاربر. در صورت تمایل به دانستن دربارهٔ آن‌ها سورس‌کد را مطالعه کنید.

این‌ها دستورهای عمومی به‌همراه توضیحات آن‌ها هستند:

alias [newcommand] [oldcommand]

دستور oldcommand را با عنوان newcommand کپی می‌کند.

bulkrename

این دستور فهرستی از فایل‌های انتخاب‌شده را در یک ویرایشگر بیرونی باز می‌کند. پس از ویرایش و ذخیرهٔ فایل، یک اسکریپت شل تولید می‌شود که تغییر نام دسته‌جمعی را بر اساس تغییراتی که در فایل داده‌اید انجام می‌دهد.

این اسکریپت شل جهت بازبینی برای شما در یک ویرایشگر باز می‌شود. پس از بستن آن، اجرا خواهد شد.

cd [path]

دستور cd دایرکتوری را تغییر می‌دهد. اگر path یک فایل باشد، آن فایل را انتخاب می‌کند. دستور ":cd -" معادل تایپ کردن `` است.

chain command1[; command2[; command3...]]

چندین دستور را که با نقطه‌ویرگول از هم جدا شده‌اند، در یک دستور ترکیب می‌کند.

chmod octal_number

مجوزهای موارد انتخاب‌شده را به عدد در مبنای هشت تعیین می‌کند.

عدد مبنای هشت بین 000 و 777 است. ارقام مشخص‌کنندهٔ مجوزها برای کاربر، گروه و دیگران هستند. عدد ۱ اجازهٔ اجرا، ۲ اجازهٔ نوشتن و ۴ اجازهٔ خواندن می‌دهد. برای ترکیب این مجوزها، اعداد را با هم جمع کنید؛ بنابراین عدد ۷ به همه‌چیز اجازه می‌دهد.

کلیدهای مقیدشده به‌فرم [-+]<who><what> و <octal>= نیز وجود دارند. برای مثال، +ar اجازهٔ خواندن به همه می‌دهد، -ow دیگران را از نوشتن منع می‌کند و 777= اجازهٔ همه‌چیز را می‌دهد.

همچنین ببینید: man 1 chmod

console [-pN] command

کنسول را در حالی باز می‌کند که command از قبل در آن تایپ شده است. مکان‌نما روی N قرار می‌گیرد.

copymap key newkey [newkey2 ...]

copycmap key newkey [newkey2 ...]

copypmap key newkey [newkey2 ...]

copytmap key newkey [newkey2 ...]

کلید مقیدشدهٔ key را به newkey در بافتار "browser" کپی می‌کند. این یک کپی عمیق است؛ بنابراین اگر بعداً مقیدسازی جدید (یا بخش‌هایی از آن) را تغییر دهید، کلید قدیمی تغییر نخواهد کرد. برای مثال، copymap j down موجب می‌شود که توالی کلید "down" مکان‌نما را یک مورد به پایین ببرد.

برای کپی کردن کلیدهای مقیدشده در console، pager یا taskview، به‌ترتیب از "copycmap"، "copypmap" یا "copytmap" استفاده کنید.

default_linemode [path=regexp | tag=tags] linemodename

حالت خط پیش‌فرض را تعیین می‌کند. دستور linemode را ببینید.

مثال‌ها:

تنظیم حالت خط پیش‌فرض سراسری روی "permissions":
:default_linemode permissions

تنظیم حالت خط پیش‌فرض روی "permissions" برای تمام فایل‌هایی که با "p" یا "P" برچسب‌گذاری شده‌اند:
:default_linemode tag=pP permissions

تنظیم حالت خط پیش‌فرض برای تمام فایل‌های درون ~/books/ روی "metatitle":
:default_linemode path=/home/.*?/books/.* metatitle

delete

تمام فایل‌های انتخاب‌شده را با لگد چرخشی نابود می‌کند! اگر تلاش کنید چندین فایل (علامت‌گذاری‌شده) یا دایرکتوری‌های غیرخالی را حذف کنید، ranger از شما تأییدیه می‌خواهد. این رفتار با تغییر تنظیمات "confirm_on_delete" قابل تغییر است.

echo text

متن را در نوار وضعیت نمایش می‌دهد.

edit [filename]

فایل جاری یا فایل مشخص‌شده در آرگومان را ویرایش می‌کند.

eval [-q] python_code

کد پایتون را ارزیابی می‌کند. `fm' ارجاعی به نمونهٔ FM است. برای نمایش متن، از تابع `p' استفاده کنید. نتیجه روی صفحه نمایش داده می‌شود مگر آن‌که از گزینهٔ "-q" استفاده کنید.

مثال‌ها:
:eval fm
:eval len(fm.tabs)
:eval p("Hello World!")

filter [string]

تنها فایل‌هایی را نمایش می‌دهد که شامل string در basename خود باشند. اجرای این دستور بدون هیچ پارامتری فیلتر را بازنشانی می‌کند.

این دستور بر پایهٔ دستور scout است و از تمام گزینه‌های آن پشتیبانی می‌کند.

filter_inode_type [dfl]

تنها فایل‌های مربوط به نوع inode مشخص‌شده را نمایش می‌دهد. برای نمایش فقط دایرکتوری‌ها، از پارامتر 'd' استفاده کنید. برای نمایش فقط فایل‌ها، از پارامتر 'f' استفاده کنید. برای نمایش فقط پیوندها، از پارامتر 'l' استفاده کنید. پارامترها را می‌توان با هم ترکیب کرد. برای حذف این فیلتر، از هیچ پارامتری استفاده نکنید.

filter_stack [command [args]]

مدیریت پشتهٔ فیلتر، افزودن، حذف و دستکاری فیلترها. برای مثال، برای نمایش فقط فایل‌های تکراری و پیوندهای نمادین: :filter_stack add type f :filter_stack add duplicate :filter_stack add and :filter_stack add type l :filter_stack add or

یا با استفاده از کلیدهای نگاشت‌شده:

.f ." .& .l .|

زیردستورهای موجود:

find pattern

جستجوی هم‌زمان با تایپ در فایل‌های دایرکتوری فعلی که نام آن‌ها حاوی رشتهٔ داده‌شده (بدون حساسیت به حروف بزرگ و کوچک) باشد. به محض اینکه یک نتیجهٔ بدون ابهام حاصل شود، بلافاصله اجرا خواهد شد. (یا اگر یک دایرکتوری باشد، وارد آن می‌شود.)

این دستور بر پایهٔ دستور scout است و از تمام گزینه‌های آن پشتیبانی می‌کند.

flat level

مسطح (تخت) کردن نمای دایرکتوری تا سطح مشخص‌شده. سطح -1 به معنای سطح نامحدود است. سطح 0 به معنای نمای استاندارد بدون نمای دایرکتوری مسطح‌شده است. مقادیر سطح -2 و کمتر نامعتبر هستند.

grep pattern

جستجوی یک رشته در تمام فایل‌ها یا دایرکتوری‌های نشانه‌گذاری‌شده.

help

روشی سریع برای مشاهدهٔ مستندات ranger فراهم می‌کند.

jump_non [-flags...]

در صورتی که فایل برجسته‌شده یک دایرکتوری باشد، به نخستین غیر دایرکتوری پرش می‌کند و برعکس.

پرچم‌ها:
-r پرش در جهت معکوس
-w چرخش به ابتدای فهرست در صورت رسیدن به انتهای فهرست فایل‌ها

linemode linemodename

حالت خطی (linemode) تمام فایل‌های موجود در دایرکتوری فعلی را تنظیم می‌کند. حالت خطی می‌تواند یکی از موارد زیر باشد:

"filename":
  نمایش هر خط به صورت "<basename>...<size>"
"fileinfo":
  نمایش هر خط به صورت "<basename>...<file(1) output>"
"mtime":
  نمایش هر خط به صورت "<basename>...<mtime>" در قالب ISO
"humanreadablemtime":
  نمایش هر خط به صورت "<basename>...<mtime>" در قالبی انسان‌خوانا،
  هرچه جدیدتر باشد دقیق‌تر است.
"sizemtime":
  نمایش هر خط به صورت "<basename>...<size> <mtime>" در قالب ISO
"humanreadablesizemtime":
  نمایش هر خط به صورت "<basename>...<size> <mtime>" در قالبی
  انسان‌خوانا، هرچه جدیدتر باشد دقیق‌تر است.
"permissions":
  نمایش هر خط به صورت "<permissions> <owner> <group> <basename>"
"metatitle":
  نمایش متادیتا از فایل‌های .metadata.json در صورت وجود، بازگشت
  به حالت خطی "filename" در صورتی که هیچ متادیتایی یافت نشود.
  دستور :meta را ببینید.

حالت‌های خطی سفارشی را می‌توان با ایجاد زیرکلاس از کلاس LinemodeBase افزود. برای دیدن چند مثال، ماژول ranger.core.linemode را ببینید.

load_copy_buffer

بارگذاری بافر رونوشت از ~/.config/ranger/copy_buffer. این دستور می‌تواند برای انتقال فهرست فایل‌های رونوشت‌شده به یک نمونهٔ دیگر از ranger به کار رود.

map key command

cmap key command

pmap key command

tmap key command

اختصاص ترکیب کلید به دستور داده‌شده. هر زمان که کلید/کلیدها را بفشارید، دستور اجرا خواهد شد. علاوه بر این، اگر هنگام تایپ کلید از یک شمارنده استفاده کنید، مانند 5j، این مقدار به عنوان صفت "self.quantifier" به دستور ارسال می‌شود.

کلیدهایی که با این دستور مقید (bind) می‌کنید، تنها در مرورگر فایل در دسترس هستند، نه در کنسول، pager یا taskview. برای مقید کردن کلیدها در آن بخش‌ها، از دستورهای "cmap"، "pmap" یا "tmap" استفاده کنید.

mark pattern

نشانه‌گذاری تمام فایل‌هایی که با الگوی عبارت باقاعده مطابقت دارند.

این دستور بر پایهٔ دستور scout است و از تمام گزینه‌های آن پشتیبانی می‌کند.

mark_tag [tags]

نشانه‌گذاری تمام فایل‌هایی که با هر یک از تگ‌های داده‌شده برچسب‌گذاری شده‌اند. هنگام حذف آرگومان تگ، تمام فایل‌های برچسب‌دار نشانه‌گذاری می‌شوند.

meta key value

تنظیم متادیتای فایل برجسته‌شدهٔ فعلی. مثال:

:meta title The Hitchhiker's Guide to the Galaxy
:meta year 1979

این متادیتا را می‌توان به عنوان مثال، با استفاده از حالت خطی "metatitle" از طریق فشردن Mt نمایش داد.

mkdir dirname

ایجاد یک دایرکتوری با نام dirname.

open_with [application] [flags] [mode]

باز کردن فایل‌های انتخاب‌شده با برنامهٔ داده‌شده، مگر اینکه این آرگومان حذف شود که در این صورت از برنامهٔ پیش‌فرض استفاده می‌شود. flags نحوهٔ اجرای برنامه را تغییر می‌دهند و در بخش مربوط به خود در این صفحهٔ راهنما توضیح داده شده‌اند. mode عددی است که مشخص می‌کند از کدام برنامه استفاده شود. فهرست برنامه‌ها توسط بازکنندهٔ فایل خارجی "rifle" تولید می‌شود و هنگام فشردن "r" در ranger قابل نمایش است.

توجه داشته باشید که در صورت مشخص کردن یک برنامه، حالت (mode) نادیده گرفته می‌شود..IP "prompt_metadata [keys ...]" 2 از کاربر درخواست می‌کند تا برای چندین کلید به‌طور پیاپی، فراداده‌ها را با دستور "meta" وارد کند.

quit

اگر تنها یک زبانه وجود داشته باشد، زبانهٔ جاری را می‌بندد؛ در غیر این صورت، اگر هیچ وظیفه‌ای در حال اجرا نباشد، خارج می‌شود. دایرکتوری جاری به عنوان ' نشانه‌گذاری خواهد شد تا بتوانید دفعهٔ بعد که ranger را اجرا کردید، با فشردن `` یا '' مجدداً وارد آن شوید.

quit!

مشابه "quit" است، با این تفاوت که حتی در صورت در حال اجرا بودن وظایف، خروج را اجباری می‌کند.

quitall

مشابه "quit" است، با این تفاوت که حتی در صورت باز بودن چندین زبانه نیز خارج می‌شود.

quitall!

مشابه "quitall" است، با این تفاوت که حتی اگر وظایفی در حال اجرا باشند، خروج اجباری انجام می‌دهد.

relink newpath

مقصد پیوندِ فایل پیوند نمادین (symlink) جاری را به <newpath> تغییر می‌دهد. فشردن نخستین کلید <tab>، پیوند اولیه را بارگذاری می‌کند.

rename newname

نام فایل جاری را تغییر می‌دهد. اگر فایلی با همان نام از پیش وجود داشته باشد، تغییر نام شکست خواهد خورد. همچنین کلید میانبر A را برای افزودن چیزی به انتهای نام فایل امتحان کنید.

rename_append [-flags...]

کنسول را با عبارت ":rename <current file>" باز می‌کند، در حالی که مکان‌نما قبل از پسوند فایل قرار دارد.

پرچم‌ها:
-a قرارگیری مکان‌نما پیش از تمامی پسوندها
-r حذف هر آنچه قبل از پسوندها قرار دارد

save_copy_buffer

بافر رونوشت را در ~/.config/ranger/copy_buffer ذخیره می‌کند. از این دستور می‌توان برای انتقال فهرست فایل‌های کپی‌شده به نمونه‌ای دیگر از ranger استفاده کرد.

scout [-flags...] [--] pattern

دستوری همه‌کاره برای جستجو، جابه‌جایی و فیلتر کردن فایل‌ها.

پرچم‌ها:
-a باز کردن خودکار فایل در صورت تطابق قطعی و غیرمبهم
-e باز کردن فایل انتخاب‌شده هنگام فشردن enter
-f فیلتر کردن فایل‌هایی که با الگوی جستجوی فعلی تطابق دارند
-g تفسیر الگو به عنوان الگوی glob
-i نادیده گرفتن بزرگی و کوچکی حروف در فایل‌ها
-k باز نگه داشتن کنسول هنگام تغییر دایرکتوری با این دستور
-l پرش از روی حروف؛ مثلاً تطابق "rdme" با فایل "readme"
-m علامت‌گذاری فایل‌های منطبق پس از فشردن enter
-M برداشتن علامت فایل‌های منطبق پس از فشردن enter
-p فیلتر دائمی: پنهان کردن فایل‌های نامنطبق پس از فشردن enter
-r تفسیر الگو به عنوان یک عبارت باقاعده (regular expression)
-s حساسیت هوشمند به حروف؛ مانند -i رفتار می‌کند مگر اینکه الگو حاوی حروف بزرگ باشد
-t اعمال فیلتر و الگوی جستجو هم‌زمان با تایپ کردن
-v معکوس کردن نتیجهٔ تطابق

می‌توان چندین پرچم را ترکیب کرد. برای نمونه، ":scout -gpt" دستوری مشابه :filter با استفاده از globbing ایجاد می‌کند.

search pattern

جستجوی فایل‌ها در دایرکتوری جاری که با الگوی عبارت باقاعدهٔ داده‌شده (بدون حساسیت به بزرگی و کوچکی حروف) تطابق دارند.

این دستور بر پایهٔ دستور scout است و از تمامی گزینه‌های آن پشتیبانی می‌کند.

search_inc pattern

جستجوی فایل‌ها در دایرکتوری جاری که با الگوی عبارت باقاعدهٔ داده‌شده (بدون حساسیت به بزرگی و کوچکی حروف) تطابق دارند. این دستور هم‌زمان با تایپ کردن، شما را به فایل‌های منطبق هدایت می‌کند.

این دستور بر پایهٔ دستور scout است و از تمامی گزینه‌های آن پشتیبانی می‌کند.

set option value

مقدار جدیدی را به یک گزینه اختصاص می‌دهد. گزینه‌های معتبر در بخش تنظیمات فهرست شده‌اند. برای دریافت مقدار فعلی یک گزینه از تکمیل با کلید tab استفاده کنید، اگرچه این قابلیت برای توابع و عبارت‌های باقاعده کار نمی‌کند. مقادیر معتبر عبارتند از:

setting type   | example values
---------------+----------------------------
bool           | true, false
integer        | 1, 23, 1337
string         | foo, hello world
list           | 1,2,3,4
none           | none

setintag tags option value

مقدار جدیدی را به یک گزینه اختصاص می‌دهد، اما به‌صورت محلی برای دایرکتوری‌هایی که با tag علامت‌گذاری شده‌اند. این بدان معناست که این گزینه تنها هنگام مشاهدهٔ آن دایرکتوری اعمال می‌شود.

به عنوان مثال، برای تغییر ترتیب مرتب‌سازی در دایرکتوری بارگیری‌های خود، با فشردن "v آن را با برچسب v علامت‌گذاری کنید، سپس از این دستور استفاده نمایید:

setintag v sort ctime

setlocal [path=path] option value

مقدار جدیدی را به یک گزینه اختصاص می‌دهد، اما به‌صورت محلی برای دایرکتوری مشخص‌شده توسط path. این بدان معناست که این گزینه تنها هنگام بازدید از آن دایرکتوری اعمال می‌شود. اگر مسیری مشخص نشود، از دایرکتوری جاری استفاده خواهد شد.

path یک عبارت باقاعده است. این بدان معناست که "path=~/dl" برای تمامی مسیرهایی که با ~/dl شروع می‌شوند اعمال می‌شود، مانند ~/dl2 و ~/dl/foo. برای جلوگیری از این حالت، از "path=~/dl$" استفاده کنید.

برای جلوگیری از تفکیک ناخواسته، می‌توان path را درون کوتیشن تکی یا دوتایی قرار داد: path='~/dl dl$' یا path="~/dl dl$"

shell [-flags] command

یک دستور شل را اجرا می‌کند. flags در بخش مربوط به خود بررسی شده‌اند.

source filename

دستورها را از یک فایل می‌خواند و آن‌ها را در کنسول ranger اجرا می‌کند.

این دستور می‌تواند برای ارزیابی مجدد فایل rc.conf پس از تغییر آن به کار رود:

map X chain shell vim -p %confdir/rc.conf %rangerdir/config/rc.conf; \
                  source %confdir/rc.conf

scroll_preview value

پیش‌نمایش فایل را به میزان value خط پیمایش می‌کند.

terminal

برنامهٔ x-terminal-emulator را با شروع از دایرکتوری جاری اجرا می‌کند.

touch filename

یک فایل خالی با نام filename ایجاد می‌کند، مگر اینکه از قبل وجود داشته باشد.

trash

تمام فایل‌های انتخاب‌شده را با استفاده از rifle به سطل زباله منتقل می‌کند. در صورت در دسترس بودن، rifle سعی می‌کند از یک مدیر سطل زباله مانند trash-cli استفاده کند، اما در غیر این صورت به انتقال فایل‌ها به $XDG_DATA_HOME/ranger-trash یا ~/.ranger/ranger-trash بازمی‌گردد. این نسخهٔ موقت‌تری نسبت به delete است که خالی کردن سطل زباله را به زمان مناسب برای کاربر واگذار می‌کند، در حالی که امکان بازیابی فایل‌های حذف‌شده تا پیش از آن وجود دارد. اگر قصد انتقال چندین فایل (علامت‌گذاری‌شده) یا دایرکتوری‌های غیرخالی به سطل زباله را داشته باشید، ranger تأییدیه خواهد خواست. این رفتار را می‌توان با تغییر تنظیم "confirm_on_delete" اصلاح کرد.

travel pattern

دایرکتوری جاری را برای فایل‌هایی که شامل حروف موجود در رشته هستند فیلتر می‌کند، حتی اگر حروف دیگری بین آن‌ها قرار گرفته باشد. فیلتر هم‌زمان با تایپ اعمال می‌شود. هنگامی که تنها یک دایرکتوری باقی بماند، وارد آن شده و کنسول به‌طور خودکار مجدداً باز می‌شود که امکان جابه‌جایی سریع را فراهم می‌سازد. برای بستن کنسول، ESC را فشار دهید یا فایلی را اجرا کنید.

این دستور بر پایهٔ دستور scout است و از تمامی گزینه‌های آن پشتیبانی می‌کند.

unmap [keys ...]

cunmap [keys ...]

punmap [keys ...]

tunmap [keys ...]

نگاشت‌های کلید مشخص‌شده را در بستر "browser" حذف می‌کند. برای لغو نگاشت کلیدها در کنسول، pager یا taskview از "cunmap"، "punmap" یا "tunmap" استفاده کنید.

unmark pattern

علامت‌گذاری تمامی فایل‌های منطبق با یک الگوی عبارت باقاعده را برمی‌دارد.

این دستور بر پایهٔ دستور scout است و از تمامی گزینه‌های آن پشتیبانی می‌کند.

unmark_tag [tags]

علامت‌گذاری تمامی برچسب‌هایی را که با هر یک از برچسب‌های داده‌شده نشانه‌گذاری شده‌اند برمی‌دارد. در صورت حذف آرگومان برچسب، علامت تمامی فایل‌های برچسب‌دار برداشته می‌شود..SH "فایل‌ها (FILES)" ranger چندین فایل پیکربندی را می‌خواند که در $HOME/.config/ranger یا در صورت تعریف شدن $XDG_CONFIG_HOME، در $XDG_CONFIG_HOME/ranger قرار دارند. می‌توانید از گزینهٔ --copy-config برای به‌دست آوردن فایل‌های پیکربندی پیش‌فرض استفاده کنید. این فایل‌ها شامل توضیحات و مستندات بیشتری هستند.

نیازی نیست فایل‌های rc.conf، commands.py و colorschemes به‌طور کامل کپی شوند؛ چرا که این فایل‌ها تنها به فایل‌های پیکربندی پیش‌فرض افزوده می‌شوند، مگر اینکه صراحتاً بازنویسی شوند. این ممکن است به وضعیت‌های گیج‌کننده‌ای منجر شود، برای نمونه زمانی که یک کلید با وجود حذف شدن خط مربوطه از نسخهٔ فایل پیکربندی کاربر، همچنان مقید باقی مانده باشد. این رفتار را می‌توان با یک متغیر محیطی غیرفعال کرد (همچنین ببینید: ENVIRONMENT). نکته: تمامی دیگر فایل‌های پیکربندی تنها از یک منبع خوانده می‌شوند؛ یعنی پیش‌فرض یا کاربر، نه هر دو. اگر rc.conf و commands.py در /etc/ranger برای پیکربندی سراسری سیستم وجود داشته باشند، از آنجا نیز خوانده می‌شوند؛ پیکربندی کاربر بر پیکربندی سیستم اولویت دارد که آن نیز بر پیکربندی پیش‌فرض اولویت دارد.

هنگام اجرای ranger با گزینهٔ --clean، برنامه به هیچ‌یک از این فایل‌ها دسترسی پیدا نکرده یا آن‌ها را ایجاد نخواهد کرد.

محیط (ENVIRONMENT)

این متغیرهای محیطی بر روی ranger تأثیر می‌گذارند:

RANGER_LEVEL

برنامهٔ ranger این متغیر محیطی را به "1" مقداردهی می‌کند یا در صورت وجود، مقدار آن را افزایش می‌دهد. برنامه‌های خارجی می‌توانند با بررسی این متغیر بررسی کنند که آیا از ranger اجرا شده‌اند یا خیر.

RANGER_LOAD_DEFAULT_RC

اگر این متغیر برابر با FALSE تنظیم شده باشد، ranger فایل rc.conf پیش‌فرض را بارگذاری نخواهد کرد. اگر تمام rc.conf را در ~/.config/ranger/ کپی کرده‌اید و به فایل پیش‌فرض اصلاً نیازی ندارید، این کار می‌تواند در زمان صرفه‌جویی کند.

VISUAL

ویرایشگری را تعیین می‌کند که برای کلید "E" استفاده خواهد شد. در صورت تعریف نشدن یا خالی بودن، به EDITOR برمی‌گردد.

EDITOR

ویرایشگری را تعیین می‌کند که اگر VISUAL تعریف نشده یا خالی باشد، برای کلید "E" استفاده می‌شود. مقدار پیش‌فرض "vim" است.

SHELL

پوسته‌ای را مشخص می‌کند که ranger همراه با دستور :shell و کلید "S" از آن استفاده خواهد کرد. پیش‌فرض "/bin/sh" است.

TERMCMD

دستور شبیه‌ساز ترمینالی را تعیین می‌کند که ranger همراه با دستور :terminal و نشان اجرای "t" از آن استفاده خواهد کرد. پیش‌فرض "xterm" است.

BAT_STYLE

تم مورد استفاده برای برجسته‌سازی نحو هنگام نصب بودن bat را مشخص می‌کند، مگر اینکه highlight نیز نصب شده باشد. با اجرای "bat --list-themes" مقادیر ممکن را بیابید.

PYGMENTIZE_STYLE

تم مورد استفاده برای برجسته‌سازی نحو هنگام نصب بودن pygmentize را مشخص می‌کند، مگر اینکه highlight نیز نصب شده باشد. مقادیر ممکن را می‌توانید با اجرای دستور زیر بیابید:
python -c 'import pygments.styles; [print(stl) for stl in
pygments.styles.get_all_styles()]'

HIGHLIGHT_STYLE

تم مورد استفاده برای برجسته‌سازی نحو را هنگامی که highlight نصب باشد، مشخص می‌کند. با اجرای "highlight --list-themes" مقادیر ممکن را بیابید.

HIGHLIGHT_TABWIDTH

تعداد فاصله‌هایی را مشخص می‌کند که برای جایگزینی تب‌ها در فایل‌های پردازش‌شده با highlight استفاده می‌شود.

HIGHLIGHT_OPTIONS

برنامهٔ highlight گزینه‌های خط فرمان مشخص‌شده در این متغیر را دریافت خواهد کرد. گزینهٔ "--style=" مشخص‌شده در اینجا، بر "HIGHLIGHT_STYLE" اولویت خواهد داشت. به‌طور مشابه، "--replace-tabs=" بر "HIGHLIGHT_TABWIDTH" اولویت دارد.

OPENSCAD_COLORSCHEME

طرح رنگی مورد استفاده توسط openscad را هنگام پیش‌نمایش مدل‌های سه‌بعدی تعیین می‌کند. برای طرح‌های رنگی، صفحهٔ راهنمای openscad را مطالعه کنید. پیش‌فرض ranger طرح Tomorrow Night خواهد بود.

OPENSCAD_IMGSIZE

وضوح (رزولوشن) داخلی مورد استفادهٔ openscad را برای رندر مدل‌های سه‌بعدی تعیین می‌کند. تصویر برای قرارگیری در قاب پیش‌نمایش کوچک خواهد شد. در صورت مشخص نشدن، مقدار این وضوح به‌طور پیش‌فرض "1000,1000" خواهد بود.

XDG_CONFIG_HOME

دایرکتوری فایل‌های پیکربندی را مشخص می‌کند. پیش‌فرض $HOME/.config است.

PYTHONOPTIMIZE

این متغیر سطح بهینه‌سازی python را تعیین می‌کند.

استفاده از PYTHONOPTIMIZE=1 (مانند python -O) باعث می‌شود python گزاره‌های assert را نادیده بگیرد. با فدا کردن مقداری از اطلاعات اشکال‌زدایی، کارایی بهتری به دست خواهید آورد.

استفاده از PYTHONOPTIMIZE=2 (مانند python -OO) علاوه بر آن تمامی docstringها را نیز نادیده می‌گیرد. استفاده از این مقدار، کلید <F1> را در دستورها غیرفعال می‌کند.

W3MIMGDISPLAY_PATH

با تغییر این متغیر می‌توانید مسیر فایل اجرایی پیش‌نمایش تصاویر را تغییر دهید. به‌طور پیش‌فرض، روی /usr/lib/w3m/w3mimgdisplay تنظیم شده است..SH "مثال‌ها (EXAMPLES)" مثال‌های گوناگونی دربارهٔ چگونگی گسترش ranger با افزونه‌ها یا ترکیب ranger با دیگر برنامه‌ها وجود دارد. این نمونه‌ها را می‌توان در دایرکتوری /usr/share/doc/ranger/examples/ یا در doc/ranger/ که همراه با کد منبع ارائه می‌شود، یافت.

مجوز (LICENSE)

GNU General Public License 3 یا (به انتخاب شما) هر نسخهٔ بعدی.

پیوندها (LINKS)

دانلود: https://ranger.github.io/ranger-stable.tar.gz

صفحهٔ پروژه: https://ranger.github.io

فهرست پستی: https://savannah.nongnu.org/mail/?group=ranger

کانال IRC: کانال #ranger در freenode.net

توسعه و نگهداری ranger با سیستم کنترل نسخهٔ git انجام می‌شود. برای دریافت یک نسخهٔ تازه، دستور زیر را اجرا کنید:

git clone git@github.com:ranger/ranger.git

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

rifle(1)

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

باگ‌ها را در اینجا گزارش کنید: https://github.com/ranger/ranger/issues

لطفاً تا حد امکان اطلاعات مرتبط را لحاظ کنید. برای دریافت کامل‌ترین خروجی تشخیصی (عیب‌یابی)، ranger را به این صورت اجرا کنید: "PYTHONOPTIMIZE= ranger --debug"