.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "RANGER 1" .TH RANGER 1 "ranger-1.9.4" "2024-11-04" "راهنمای ranger" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh ranger \- مدیر فایل دیداری.SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBranger\fR [\fB\-\-version\fR] [\fB\-\-help\fR] [\fB\-\-debug\fR] [\fB\-\-clean\fR] [\fB\-\-cachedir\fR=\fIdirectory\fR] [\fB\-\-confdir\fR=\fIdirectory\fR] [\fB\-\-datadir\fR=\fIdirectory\fR] [\fB\-\-copy\-config\fR=\fIwhich\fR] [\fB\-\-choosefile\fR=\fItarget\fR] [\fB\-\-choosefiles\fR=\fItarget\fR] [\fB\-\-choosedir\fR=\fItarget\fR] [\fB\-\-selectfile\fR=\fIfilepath\fR] [\fB\-\-show\-only\-dirs\fR] [\fB\-\-list\-unused\-keys\fR] [\fB\-\-list\-tagged\-files\fR=\fItag\fR] [\fB\-\-profile\fR] [\fB\-\-cmd\fR=\fIcommand\fR] [\fIpath ...\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" نرم‌افزار ranger یک مدیر فایل متنی (کنسولی) با کلیدهای میانبر \s-1VI\s0 است. .SH "منابع (RESOURCES)" .IX Header "RESOURCES" این \fIراهنما\fR شامل دستورالعمل‌هایی دربارهٔ نحوهٔ استفاده و پیکربندی ranger است. .PP در داخل محیط \fIranger\fR، می‌توانید با فشردن کلید \fI?\fR فهرستی از میانبرهای صفحه کلید، دستورها یا تنظیمات را مشاهده کنید. .PP فایل \fI\s-1README\s0\fR شامل دستورالعمل‌های نصب است. .PP فایل \fI\s-1HACKING\s0.md\fR حاوی رهنمودهایی برای اصلاح و توسعهٔ کد منبع است. .PP دایرکتوری \fIdoc/configs\fR شامل فایل‌های پیکربندی است. این فایل‌ها معمولاً در \fI/usr/share/doc/ranger/config\fR نصب می‌شوند و از طریق گزینهٔ \&\-\-copy\-config در ranger قابل دریافت هستند. .PP دایرکتوری \fIexamples\fR شامل پیاده‌سازی‌های نمونه برای افزونه‌های ranger، نمونه فایل‌های پیکربندی و برنامه‌هایی جهت یکپارچه‌سازی ranger با سایر نرم‌افزارها است. این فایل‌ها معمولاً در \&\fI/usr/share/doc/ranger/examples\fR نصب می‌شوند. .PP صفحهٔ راهنمای \fBrifle\fR\|(1) وظایف و عملکردهای بازکنندهٔ فایل (file opener) را شرح می‌دهد. .PP بخش \fI\s-1LINKS\s0\fR در این صفحهٔ راهنما شامل منابع بیشتری است. .SH "آرگومان‌های مکانی (POSITIONAL ARGUMENTS)" .IX Header "POSITIONAL ARGUMENTS" .IP "\fIpath ...\fR" 14 .IX Item "path ..." هر مسیر در یک زبانه (تب) باز می‌شود و در صورتی که مسیر اشاره به یک فایل باشد، آن فایل انتخاب خواهد شد. حذف این آرگومان معادل ارائهٔ مسیر دایرکتوری جاری است. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-d\fR, \fB\-\-debug\fR" 14 .IX Item "-d, --debug" فعال‌سازی حالت اشکال‌زدایی: با وقوع هر خطا، ranger خارج شده و گزارش کامل ردیابی (traceback) را چاپ می‌کند. رفتار پیش‌فرض این است که صرفاً نام استثنا در نوار وضعیت/لاگ چاپ شود و برنامه به کار خود ادامه دهد. .IP "\fB\-c\fR, \fB\-\-clean\fR" 14 .IX Item "-c, --clean" فعال‌سازی حالت پاک: ranger به هیچ فایل پیکربندی دسترسی نخواهد داشت و هیچ فایلی نیز ایجاد نخواهد کرد و اثری از خود بر روی سیستم شما باقی نمی‌گذارد. این گزینه زمانی که پیکربندی شما خراب شده، یا می‌خواهید از ایجاد داده‌های اضافی جلوگیری کنید، مفید است. .IP "\fB\-\-cachedir\fR=\fIdir\fR" 14 .IX Item "--cachedir=dir" تغییر دایرکتوری حافظهٔ پنهان (cache) در ranger از مسیر \f(CW$XDG_CACHE_HOME\fR یا ~/.cache/ranger به \*(L"dir\*(R". .IP "\fB\-r\fR \fIdir\fR, \fB\-\-confdir\fR=\fIdir\fR" 14 .IX Item "-r dir, --confdir=dir" تغییر دایرکتوری پیکربندی ranger از مسیر \f(CW$XDG_CONFIG_HOME\fR یا ~/.config/ranger به \*(L"dir\*(R". .IP "\fB\-\-datadir\fR=\fIdir\fR" 14 .IX Item "--datadir=dir" تغییر دایرکتوری داده‌های ranger از مسیر \f(CW$XDG_DATA_HOME\fR یا ~/.local/share/ranger به \*(L"dir\*(R". .IP "\fB\-\-copy\-config\fR=\fIfile\fR" 14 .IX Item "--copy-config=file" رونوشت فایل‌های پیکربندی پیش‌فرض را در دایرکتوری پیکربندی محلی شما ایجاد می‌کند. فایل‌های موجود بازنویسی نخواهند شد. مقادیر مجاز: \fIall\fR، \&\fIcommands\fR، \fIcommands_full\fR، \fIrc\fR، \fIrifle\fR، \fIscope\fR. .Sp نکته: با صادر کردن \fIRANGER_LOAD_DEFAULT_RC=FALSE\fR در محیط کاربری خود، می‌توانید بارگذاری فایل‌های پیکربندی سراسری را غیرفعال کنید. همچنین ببینید: \&\fB\s-1FILES\s0\fR، \fB\s-1ENVIRONMENT\s0\fR .Sp گزینهٔ \&\-\-copy\-config=\fBcommands\fR تنها یک فایل پیکربندی نمونهٔ مختصر را همراه با مستندات و مثال‌های کامل رونوشت می‌کند. توصیه می‌شود این فایل را تمیز و کم‌حجم نگه دارید تا هنگام ارتقای ranger دچار دستورهای منسوخ و ازکارافتاده نشوید. فایل پیش‌فرض کامل commands.py را می‌توان با \-\-copy\-config=\fBcommands_full\fR رونوشت کرد، اما ranger آن فایل را نادیده می‌گیرد و صرفاً به عنوان مرجعی برای نوشتن دستورهای اختصاصی شما کاربرد دارد. .IP "\fB\-\-choosefile\fR=\fItargetfile\fR" 14 .IX Item "--choosefile=targetfile" امکان انتخاب یک فایل از طریق ranger را فراهم می‌کند. این گزینه رفتار برنامه را به گونه‌ای تغییر می‌دهد که با باز کردن یک فایل، ranger خارج شده و مسیر مطلق آن فایل را در \&\fItargetfile\fR می‌نویسد. .IP "\fB\-\-choosefiles\fR=\fItargetfile\fR" 14 .IX Item "--choosefiles=targetfile" امکان انتخاب چند فایل از طریق ranger را فراهم می‌کند. این گزینه رفتار برنامه را تغییر می‌دهد تا با باز کردن یک فایل، ranger خارج شده و مسیر مطلق تمام فایل‌های انتخاب‌شده را با افزودن یک خط جدید پس از نام هر فایل، در \fItargetfile\fR بنویسد. .IP "\fB\-\-choosedir\fR=\fItargetfile\fR" 14 .IX Item "--choosedir=targetfile" امکان انتخاب یک دایرکتوری از طریق ranger را فراهم می‌کند. هنگام خروج از ranger، آخرین دایرکتوری بازدید شده در \fItargetfile\fR نوشته خواهد شد. .IP "\fB\-\-selectfile\fR=\fItargetfile\fR" 14 .IX Item "--selectfile=targetfile" باز کردن ranger در حالی که \fItargetfile\fR به حالت انتخاب درآمده است. این یک گزینهٔ قدیمی (legacy) است و رفتار بخش \s-1POSITIONAL ARGUMENTS\s0 جایگزین آن شده است. .IP "\fB\-\-show\-only\-dirs\fR" 14 .IX Item "--show-only-dirs" فقط نمایش دادن دایرکتوری‌ها. می‌تواند همراه با گزینهٔ \&\fB\-\-choosedir\fR=\fItargetfile\fR استفاده شود. .IP "\fB\-\-list\-unused\-keys\fR" 14 .IX Item "--list-unused-keys" فهرست کردن کلیدهای رایجی که در محیط \*(L"browser\*(R" به هیچ عملیاتی متصل نشده‌اند. این فهرست کامل نیست؛ شما می‌توانید هر کلیدی را که curses پشتیبانی می‌کند اختصاص دهید: از کد کلید بازگردانده شده توسط \f(CW\*(C`getch()\*(C'\fR استفاده کنید. .IP "\fB\-\-list\-tagged\-files\fR=\fItag\fR" 14 .IX Item "--list-tagged-files=tag" فهرست کردن تمام فایل‌هایی که با برچسب ارائه‌شده مشخص شده‌اند. نکته: برچسب‌ها تک‌نویسه‌ای هستند. برچسب پیش‌فرض \*(L"*\*(R" است. .IP "\fB\-\-profile\fR" 14 .IX Item "--profile" چاپ آمار مصرف پردازنده (\s-1CPU\s0) در زمان خروج. .IP "\fB\-\-cmd\fR=\fIcommand\fR" 14 .IX Item "--cmd=command" اجرای دستور پس از خواندن کامل پیکربندی. برای اجرای چند دستور می‌توانید از این گزینه چندین بار استفاده کنید. .IP "\fB\-\-version\fR" 14 .IX Item "--version" نمایش نسخه و خروج. .IP "\fB\-h\fR، \fB\-\-help\fR" 14 .IX Item "-h, --help" نمایش فهرست گزینه‌ها و خروج..SH "مفاهیم (CONCEPTS)" .IX Header "CONCEPTS" این بخش نحوه کارکرد بخش‌های خاصی از ranger و چگونگی استفاده بهینه از آن‌ها را توضیح می‌دهد. .SS "\s-1برچسب‌ها (TAGS)\s0" .IX Subsection "TAGS" برچسب‌ها تک‌نویسه‌هایی هستند که در سمت چپ نام فایل نمایش می‌یابند. شما می‌توانید به هر نحوی که می‌خواهید از برچسب‌ها استفاده کنید. برای تغییر وضعیت برچسب‌ها \*(L"t\*(R" و برای حذف تمام برچسب‌های موارد انتخاب‌شده \*(L"ut\*(R" را فشار دهید. برچسب پیش‌فرض ستاره (\*(L"*\*(R") است، اما می‌توانید با تایپ \fI"\fR از هر برچسبی استفاده کنید. .SS "\s-1پیش‌نمایش‌ها (PREVIEWS)\s0" .IX Subsection "PREVIEWS" به‌طور پیش‌فرض، تنها برای فایل‌های متنی پیش‌نمایش ارائه می‌شود، اما می‌توانید با تنظیم گزینه‌های \f(CW\*(C`use_preview_script\*(C'\fR و \f(CW\*(C`preview_files\*(C'\fR روی true، اسکریپت‌های خارجی پیش‌نمایش را فعال کنید. .PP این اسکریپت پیش‌فرض \fI\f(CI%rangerdir\fI/data/scope.sh\fR است. این اسکریپت شامل مستندات بیشتر و فراخوانی برنامه‌های خارجی متعددی برای تولید پیش‌نمایش‌ها است. آن‌ها در صورت در دسترس بودن به‌طور خودکار استفاده می‌شوند اما کاملاً اختیاری هستند. .IP "برای استفاده عمومی:" 2 .IX Item "For general usage:" .RS 2 .PD 0 .IP "\-" 2 .PD \&\f(CW\*(C`file\*(C'\fR برای تشخیص نوع فایل .IP "\-" 2 \&\f(CW\*(C`chardet\*(C'\fR (بسته Python) برای بهبود تشخیص کدبندی فایل‌های متنی .IP "\-" 2 \&\f(CW\*(C`sudo\*(C'\fR برای استفاده از قابلیت «اجرا به عنوان ریشه» (\*(L"run as root\*(R") .IP "\-" 2 \&\f(CW\*(C`python\-bidi\*(C'\fR (بسته Python) برای نمایش صحیح نام فایل‌های راست‌به‌چپ (عبری، عربی) .RE .RS 2 .RE .IP "برای پیش‌نمایش‌های بهبودیافته فایل (با scope.sh):" 2 .IX Item "For enhanced file previews (with scope.sh):" .RS 2 .PD 0 .IP "\-" 2 .PD \&\f(CW\*(C`img2txt\*(C'\fR (از \f(CW\*(C`caca\-utils\*(C'\fR) برای پیش‌نمایش تصاویر به صورت هنر اسکی (ASCII-art) .IP "\-" 2 \&\f(CW\*(C`w3mimgdisplay\*(C'\fR، \f(CW\*(C`ueberzug\*(C'\fR، \f(CW\*(C`mpv\*(C'\fR، \f(CW\*(C`iTerm2\*(C'\fR، \f(CW\*(C`kitty\*(C'\fR، \f(CW\*(C`terminology\*(C'\fR یا \&\f(CW\*(C`urxvt\*(C'\fR برای پیش‌نمایش تصاویر .IP "\-" 2 \&\f(CW\*(C`convert\*(C'\fR (از \f(CW\*(C`imagemagick\*(C'\fR) برای چرخش خودکار تصاویر و پیش‌نمایش‌های \s-1SVG\s0 .IP "\-" 2 \&\f(CW\*(C`ffmpegthumbnailer\*(C'\fR برای تصاویر بندانگشتی ویدیو .IP "\-" 2 \&\f(CW\*(C`highlight\*(C'\fR، \f(CW\*(C`bat\*(C'\fR یا \f(CW\*(C`pygmentize\*(C'\fR برای برجسته‌سازی نحو کدها .IP "\-" 2 \&\f(CW\*(C`atool\*(C'\fR، \f(CW\*(C`bsdtar\*(C'\fR، \f(CW\*(C`unrar\*(C'\fR و/یا \f(CW\*(C`7z\*(C'\fR برای پیش‌نمایش آرشیوها .IP "\-" 2 \&\f(CW\*(C`bsdtar\*(C'\fR، \f(CW\*(C`tar\*(C'\fR، \f(CW\*(C`unrar\*(C'\fR، \f(CW\*(C`unzip\*(C'\fR و/یا \f(CW\*(C`zipinfo\*(C'\fR (و \f(CW\*(C`sed\*(C'\fR) برای پیش‌نمایش آرشیوها به صورت نخستین تصویر آن‌ها .IP "\-" 2 \&\f(CW\*(C`lynx\*(C'\fR، \f(CW\*(C`w3m\*(C'\fR یا \f(CW\*(C`elinks\*(C'\fR برای پیش‌نمایش صفحات html .IP "\-" 2 \&\f(CW\*(C`pdftotext\*(C'\fR یا \f(CW\*(C`mutool\*(C'\fR (و \f(CW\*(C`fmt\*(C'\fR) برای پیش‌نمایش متنی pdf، و \f(CW\*(C`pdftoppm\*(C'\fR برای پیش‌نمایش به صورت تصویر .IP "\-" 2 \&\f(CW\*(C`djvutxt\*(C'\fR برای پیش‌نمایش متنی DjVu، و \f(CW\*(C`ddjvu\*(C'\fR برای پیش‌نمایش به صورت تصویر .IP "\-" 2 \&\f(CW\*(C`calibre\*(C'\fR یا \f(CW\*(C`epub\-thumbnailer\*(C'\fR برای پیش‌نمایش تصویری کتاب‌های الکترونیکی .IP "\-" 2 \&\f(CW\*(C`transmission\-show\*(C'\fR برای مشاهده اطلاعات BitTorrent .IP "\-" 2 \&\f(CW\*(C`mediainfo\*(C'\fR یا \f(CW\*(C`exiftool\*(C'\fR برای مشاهده اطلاعات فایل‌های چندرسانه‌ای .IP "\-" 2 \&\f(CW\*(C`odt2txt\*(C'\fR برای فایل‌های متنی OpenDocument (شامل odt، ods، odp و sxw) .IP "\-" 2 \&\f(CW\*(C`python\*(C'\fR یا \f(CW\*(C`jq\*(C'\fR برای فایل‌های \s-1JSON\s0 .IP "\-" 2 \&\f(CW\*(C`fontimage\*(C'\fR برای پیش‌نمایش قلم‌ها .RE .RS 2 .RE .PP این برنامه‌ها را نصب کنید (تنها مواردی که نیاز دارید) و scope.sh به‌طور خودکار از آن‌ها استفاده خواهد کرد. .PP جدا از اسکریپت پیش‌نمایش، قابلیتی برای پیش‌نمایش تصاویر با ترسیم مستقیم آن‌ها درون ترمینال وجود دارد. برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images\*(C'\fR را روی true قرار داده و یکی از حالت‌های پیش‌نمایش تصویر را فعال کنید: .PP \fIiTerm2\fR .IX Subsection "iTerm2" .PP این حالت تنها در iTerm2 که با پشتیبانی از پیش‌نمایش تصویر کامپایل شده باشد کار می‌کند، اما بر بستر ssh نیز عمل می‌کند. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی iterm2 تنظیم کنید. .PP این قابلیت به ابعاد قلم ترمینال متکی است. به‌طور پیش‌فرض، عرض ۸ و ارتفاع ۱۱ استفاده می‌شود. برای استفاده از مقادیر دیگر، گزینه‌های \&\f(CW\*(C`iterm2_font_width\*(C'\fR و \f(CW\*(C`iterm2_font_height\*(C'\fR را روی مقادیر دلخواه تنظیم کنید. .PP \fIkitty\fR .IX Subsection "kitty" .PP این حالت تنها در Kitty کار می‌کند. برای کارکرد به \s-1PIL\s0 (یا pillow) نیاز دارد. امکان پیش‌نمایش تصویر از راه دور، برای نمونه در یک نشست ssh را فراهم می‌سازد. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی kitty تنظیم کنید. .PP \fIterminology\fR .IX Subsection "terminology" .PP این حالت تنها در terminology کار می‌کند. می‌تواند گرافیک‌های برداری را رندر کند، اما فقط به‌صورت محلی کار می‌کند. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی terminology تنظیم کنید. .PP \fIueberzug\fR .IX Subsection "ueberzug" .PP ابزار U\*:berzug یک ابزار خط فرمان است که تصاویر را با استفاده از پنجره‌های فرزند در ترمینال‌ها رسم می‌کند. این ابزار به \s-1PIL\s0 (یا pillow) نیاز داشته و به X11 متکی است. این ویژگی آن را (به شکلی محدود، به این معنی که تقسیم پنجره‌ها در tmux پشتیبانی نمی‌شود) با بسیاری از ترمینال‌ها و tmux سازگار می‌کند، اما با کنسول لینوکس یا Wayland سازگار نیست. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی ueberzug تنظیم کنید. .PP \fIurxvt\fR .IX Subsection "urxvt" .PP این حالت تنها در urxvt کامپایل‌شده با پشتیبانی از pixbuf کار می‌کند. بر بستر ssh کار نمی‌کند. .PP در اصل این حالت تصویری را به‌طور موقت به عنوان پس‌زمینه ترمینال قرار می‌دهد، بنابراین هر پس‌زمینه تصویری که از قبل تنظیم شده باشد را دچار اختلال می‌کند. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی urxvt تنظیم کنید. .PP \fIurxvt-full\fR .IX Subsection "urxvt-full" .PP مشابه urxvt است، اما نه تنها از قاب پیش‌نمایش بلکه از کل پنجره ترمینال استفاده می‌کند. .PP برای فعال‌سازی این قابلیت، گزینه \f(CW\*(C`preview_images_method\*(C'\fR را روی urxvt-full تنظیم کنید. .PP \fIw3m\fR .IX Subsection "w3m" .PP این حالت بر بستر ssh کار نمی‌کند، به ترمینال‌های خاصی نیاز دارد (روی \*(L"xterm\*(R" و \&\*(L"urxvt\*(R" آزمایش شده است) و با tmux ناسازگار است، هرچند با screen کار می‌کند. .PP برای فعال‌سازی این قابلیت، برنامه \*(L"w3m\*(R" را نصب کرده و گزینه \&\f(CW\*(C`preview_images_method\*(C'\fR را روی w3m تنظیم کنید. .PP هنگام استفاده از ترمینالی با حاشیه غیر صفر که به‌طور خودکار شناسایی نمی‌شود، پیش‌نمایش w3m تراز نخواهد بود. از گزینه \f(CW\*(C`w3m_offset\*(C'\fR برای تنظیم دستی آفست تصویر استفاده کنید. این مقدار باید برابر با اندازه حاشیه ترمینال باشد..SS "انتخاب (\s-1SELECTION\s0)" .IX Subsection "SELECTION" \fIانتخاب\fR به‌صورت \*(L"همهٔ فایل‌های علامت‌گذاری‌شده \s-1در صورت وجود،\s0 در غیر این صورت فایل جاری\*(R" تعریف می‌شود. هنگام استفاده از دستور :delete به این موضوع دقت کنید، زیرا این دستور تمام فایل‌های موجود در انتخاب را حذف می‌کند. .PP می‌توانید با فشردن ، v و غیره فایل‌ها را علامت‌گذاری کنید. یک نماد زرد‌رنگ \fBMrk\fR در پایین سمت راست نشان می‌دهد که فایل‌های علامت‌گذاری‌شده‌ای در این دایرکتوری وجود دارند. .SS "ماکروها (\s-1MACROS\s0)" .IX Subsection "MACROS" می‌توان از ماکروها در دستورها برای خلاصه‌سازی استفاده کرد. .PP .Vb 6 \& %f فایل برجسته‌شده (زیر نشانگر) \& %d مسیر دایرکتوری جاری \& %s فایل‌های انتخاب‌شده در دایرکتوری جاری \& %t همهٔ فایل‌های برچسب‌خورده در دایرکتوری جاری \& %c مسیرهای کامل فایل‌های کپی یا بریده‌شدهٔ (cut) فعلی \& %p مسیرهای کامل فایل‌های انتخاب‌شده .Ve .PP ماکروهای \f(CW%f\fR، \f(CW%d\fR، \f(CW%p\fR و \f(CW%s\fR همچنین دارای حالت حروف بزرگ، یعنی \f(CW%F\fR، \f(CW%D\fR، \f(CW%P\fR و \&\f(CW%S\fR هستند که به برگهٔ (tab) بعدی اشاره دارند. برای اشاره به برگه‌های خاص، عددی را بین آن‌ها قرار دهید. (%7s = موارد انتخاب‌شده در برگهٔ هفتم.) .PP \&\f(CW%c\fR تنها ماکرویی است که فراتر از دایرکتوری جاری عمل می‌کند. بنابراین می‌توانید از قابلیت کپی برای اهداف دیگر \*(L"سوءاستفاده\*(R" کنید، مانند مقایسهٔ (diff) دو فایل که در دایرکتوری‌های متفاوتی قرار دارند: .PP .Vb 2 \& فایل A را کپی (yank) کنید (yy را بزنید)، به فایل B بروید، سپس بنویسید: \& @diff %c %f .Ve .PP ماکروهای مربوط به مسیرهای فایل عموماً برای پوسته گریز داده می‌شوند (shell-escaped) تا بتوان از آن‌ها در دستور \&\f(CW\*(C`shell\*(C'\fR استفاده کرد. .PP هنگام نگاشت کلیدها می‌توانید از جانگهدار استفاده کنید؛ کلیدی که در آن جایگاه وارد می‌شود می‌تواند از طریق ماکروهای \f(CW%any\fR و \f(CW%any_path\fR مورد استفاده قرار گیرد. (هنگام استفاده از چندین جانگهدار می‌توانید ماکروها را شماره‌گذاری کنید: \f(CW%any0\fR، \f(CW%any_path0\fR، \f(CW%any1\fR، \&\f(CW%any_path1\fR...). ماکروی \f(CW%any\fR با کلیدی که در جایگاه جانگهدار فشرده شده جایگزین خواهد شد. ماکروی \f(CW%any_path\fR با مسیر نشانکی که به کلید فشرده‌شده در جایگاه جانگهدار نگاشت شده جایگزین می‌شود. برای نمونه این ماکرو می‌تواند برای چاپ کلیدی که پس از \*(L"c\*(R" فشرده شده استفاده شود: .PP .Vb 1 \& map c echo %any .Ve .PP \&\f(CW%any\fR در پیکربندی ranger برای ایجاد یک کلید میانبر جهت افزودن نشانک استفاده می‌شود. c یک نشانک برای دایرکتوری جاری ایجاد می‌کند و کلید مربوط به نشانک نخستین آرگومان ارائه‌شده است. در این حالت کلیدی که پس از \*(L"m\*(R" فشرده می‌شود: .PP .Vb 1 \& map m set_bookmark %any .Ve .PP ماکروی \f(CW%any_path\fR می‌تواند برای چاپ مسیر نشانکی استفاده شود که به کلید فشرده‌شده پس از \*(L"c\*(R" اختصاص یافته است: .PP .Vb 1 \& map c echo %any_path .Ve .PP یک نمونهٔ کاربردی از استفاده از \f(CW%any_path\fR، جای‌گذاری (paste) فایل‌های بریده/کپی‌شده در یک دایرکتوری نشانک‌گذاری‌شده است: .PP .Vb 1 \& map p\*(Aq paste dest=%any_path .Ve .PP ماکروی \f(CW%rangerdir\fR به دایرکتوری کتابخانهٔ پایتون ranger بسط می‌یابد؛ می‌توانید از آن برای دستوری مانند این استفاده کنید: alias show_commands shell less \f(CW%rangerdir\fR/config/commands.py .PP \&\f(CW%confdir\fR به دایرکتوری مشخص‌شده توسط \fB\-\-confdir\fR باز می‌شود. .PP \&\f(CW%datadir\fR به دایرکتوری مشخص‌شده توسط \fB\-\-datadir\fR باز می‌شود. .PP ماکروی \f(CW%space\fR به یک نویسهٔ فاصله باز می‌شود. می‌توانید از آن برای افزودن فاصله به انتهای دستور در صورت نیاز استفاده کنید، در حالی که مانع از حذف خودکار فاصله‌های انتهای خط توسط ویرایشگرها می‌شود. .PP برای نوشتن نویسهٔ % به‌صورت لفظی، باید آن را با نوشتن %% گریز دهید (escape کنید). .PP توجه داشته باشید که هنگام استفاده از chain، ماکروها دو بار بسط می‌یابند. برای مثال، جهت درج یک نویسهٔ فاصله در یک دستور زنجیره‌ای، باید %%space را بنویسید: chain command1; command2%%space.SS "\s-1نشانک‌ها (BOOKMARKS)\s0" .IX Subsection "BOOKMARKS" برای نشانه‌گذاری دایرکتوری جاری، \fBm\fR را تایپ کنید. با تایپ \fB`\fR می‌توانید دوباره وارد این دایرکتوری شوید. می‌تواند هر حرف یا رقمی باشد. برخلاف vim، هر دو نشانک حروف کوچک و بزرگ ماندگار هستند. .PP هر بار که به یک نشانک پرش می‌کنید، نشانک ویژه روی کلید ` روی دایرکتوری قبلی تنظیم می‌شود. بنابراین تایپ کردن \*(L"``\*(R" شما را به جایی که پیش‌تر بودید بازمی‌گرداند. .PP نشانک‌ها هنگام فشردن کلید Tab در دستور :cd قابل انتخاب هستند. .PP نکته: نشانک‌های ' (آپاستروف) و ` (بک‌تیک) یکسان هستند. .SS "\s-1RIFLE\s0" .IX Subsection "RIFLE" ابزار rifle بازکننده فایل در ranger است. می‌توان از آن به‌عنوان یک برنامه مستقل یا یک ماژول python استفاده کرد. این ابزار در \fI\f(CI$repo\fI/ranger/ext/rifle.py\fR قرار دارد. بر خلاف سایر بازکننده‌های فایل ساده‌تر، rifle می‌تواند برنامه‌های نصب‌شده را به‌طور خودکار پیدا کند تا بتوان بدون نیاز به پیکربندی اولیه (out of the box) به‌شکلی کارآمد در انواع سیستم‌ها از آن استفاده کرد. .PP پیکربندی آن در \fIrifle.conf\fR از طریق فهرستی از شرایط و دستورها انجام می‌شود. برای هر خط، شرایط بررسی می‌شوند و در صورت برآورده شدن، دستور مربوطه مد نظر قرار می‌گیرد. به‌طور پیش‌فرض، تنها نخستین قاعده منطبق استفاده می‌شود. در ranger، می‌توانید با فشردن \*(L"r\*(R" یا به‌سادگی با تایپ \*(L"\*(R" قوانین را فهرست و انتخاب کنید. اگر از rifle به‌صورت مستقل استفاده می‌کنید، می‌توانید همه قوانین را با گزینه \*(L"\-l\*(R" فهرست کرده و قانونی را با \*(L"\-p \*(R" برگزینید. .PP قوانین، به‌همراه مستندات تکمیلی، در \&\fI\f(CI$repo\fI/ranger/config/rifle.conf\fR موجود هستند. .SS "\s-1پرچم‌ها (FLAGS)\s0" .IX Subsection "FLAGS" پرچم‌ها روشی را برای تغییر رفتار فرایند ایجادشده ارائه می‌دهند. آن‌ها در دستورهای \f(CW\*(C`:open_with\*(C'\fR (کلید \*(L"r\*(R") و \f(CW\*(C`:shell\*(C'\fR (کلید \*(L"!\*(R") به کار می‌روند. .PP .Vb 6 \& f انشعاب فرایند (Fork)، یعنی اجرا در پس‌زمینه. لطفاً از این پرچم \& به‌جای فراخوانی "disown" یا "nohup" استفاده کنید، تا هنگام فشردن \& Ctrl+C در ranger، از بسته شدن دستور پس‌زمینه جلوگیری شود. \& c اجرای تنها فایل جاری، به‌جای موارد انتخاب‌شده \& r اجرای برنامه با دسترسی ریشه (نیازمند sudo) \& t اجرای برنامه در یک پنجره پایانه جدید .Ve .PP پرچم‌های دیگری نیز وجود دارند که در حال حاضر فقط در دستور \f(CW\*(C`shell\*(C'\fR قابل استفاده هستند: (برای نمونه \f(CW\*(C`:shell \-w df\*(C'\fR) .PP .Vb 3 \& p هدایت خروجی به صفحه‌بندی‌کننده (pager) \& s حالت بی‌صدا (Silent). خروجی دور ریخته خواهد شد. \& w انتظار برای فشردن کلید Enter هنگام پایان فرایند .Ve .PP به‌طور پیش‌فرض، همه پرچم‌ها غیرفعال هستند مگر اینکه در کلیدهای مقیدشده در \fIrc.conf\fR یا قوانین \fIrifle.conf\fR به‌گونه دیگری تعیین شده باشد. می‌توانید هر تعداد پرچم که مایلید مشخص کنید. پرچم با حروف بزرگ اثر را خنثی می‌کند: \*(L"ffcccFsf\*(R" معادل \*(L"cs\*(R" است. .PP نام برنامه پایانه برای پرچم \*(L"t\*(R" از متغیر محیطی \f(CW$TERMCMD\fR گرفته می‌شود. اگر این متغیر وجود نداشته باشد، تلاش می‌کند آن را از \f(CW$TERM\fR استخراج کند، از \*(L"x\-terminal-emulator\*(R" به‌عنوان جایگزین پشتیبان استفاده می‌کند، و اگر این هم با شکست مواجه شود، از \*(L"xterm\*(R" بهره می‌گیرد. .PP مثال‌ها: دستور \f(CW\*(C`:open_with c\*(C'\fR فایلی را که هم‌اکنون به آن اشاره می‌کنید باز می‌کند، حتی اگر فایل‌های دیگری را انتخاب کرده باشید. دستور \f(CW\*(C`:shell \-w df\*(C'\fR نیز \*(L"df\*(R" را اجرا کرده و پیش از بازگشت به ranger، منتظر فشردن کلید Enter از سوی شما می‌ماند. .SS "\s-1افزونه‌ها (PLUGINS)\s0" .IX Subsection "PLUGINS" سامانه افزونه‌های ranger از فایل‌های python واقع در \&\fI~/.config/ranger/plugins/\fR تشکیل شده است که هنگام راه‌اندازی ranger به ترتیب حروف الفبا بارگذاری (import) می‌شوند. یک افزونه با رونویسی یا بسط دادن تابعی که ranger به کار می‌گیرد، رفتار آن را تغییر می‌دهد. این ویژگی امکان تغییر تقریباً هر بخشی از ranger را به شما می‌دهد، اما تضمینی وجود ندارد که با بازنویسی و تکامل کد منبع در نسخه‌های آینده، این تغییرات همچنان کار کنند. .PP افزودن دستورهای تازه از طریق افزونه، به‌سادگیِ تعریف آن‌ها همانند روش معمول در \fIcommands.py\fR است. .PP برخی قلاب‌ها (hook) به‌طور خاص برای استفاده در افزونه‌ها در نظر گرفته شده‌اند. آن‌ها توابعی هستند که نامشان با hook_ آغاز می‌شود و در سراسر کد یافت می‌شوند. .PP .Vb 1 \& grep \*(Aqdef hook_\*(Aq \-r /path/to/rangers/source .Ve .PP همچنین امتحان کنید: .PP .Vb 1 \& pydoc ranger.api .Ve .PP توجه داشته باشید که \s-1نباید\s0 صرفاً یک تابع را رونویسی کنید مگر آنکه دقیقاً بدانید چه کاری انجام می‌دهید. در عوض، تابع موجود را ذخیره کرده و آن را از درون تابع جدید خود فراخوانی کنید. با این روش، چندین افزونه می‌توانند از یک قلاب مشترک استفاده کنند. چندین افزونه نمونه در دایرکتوری \fI/usr/share/doc/ranger/examples/\fR قرار دارد، از جمله یک افزونه hello-world که این فرایند را شرح می‌دهد..SH "کلیدهای میان‌بر (KEY BINDINGS)" .IX Header "KEY BINDINGS" کلیدهای میان‌بر در فایل \fI\f(CI%rangerdir\fI/config/rc.conf\fR تعریف شده‌اند. برای مشاهده فهرستی از تمامی کلیدهای میان‌بر، این فایل را بررسی کنید. می‌توانید با استفاده از گزینه \-\-copy\-config=rc آن را در دایرکتوری پیکربندی محلی خود کپی کنید. .PP بسیاری از کلیدهای میان‌بر یک آرگومان عددی اضافی نیز دریافت می‌کنند. برای رفتن به ۵ سطر پایین‌تر عبارت \fI5j\fR، برای باز کردن یک فایل در حالت ۲ عبارت \fI2l\fR، و برای علامت‌گذاری ۱۰ فایل عبارت \fI10\fR را وارد کنید. .PP این فهرست شامل کاربردی‌ترین کلیدها است: .SS "\s-1کلیدهای اصلی (MAIN BINDINGS)\s0" .IX Subsection "MAIN BINDINGS" .IP "h, j, k, l" 14 .IX Item "h, j, k, l" حرکت به چپ، پایین، بالا یا راست .IP "^D or J, ^U or K" 14 .IX Item "^D or J, ^U or K" حرکت به اندازه نیم‌صفحه به پایین، بالا .IP "H, L" 14 .IX Item "H, L" حرکت به عقب و جلو در تاریخچه .IP "gg" 14 .IX Item "gg" حرکت به بالای فهرست .IP "G" 14 .IX Item "G" حرکت به پایین فهرست .IP "[, ]" 14 حرکت به بالا و پایین در دایرکتوری والد. .IP "^R" 14 .IX Item "^R" بارگذاری مجدد همه‌چیز .IP "F" 14 .IX Item "F" تغییر وضعیت تنظیم \fIfreeze_files\fR. هنگام فعال بودن (که با پیام فیروزه‌ای \fI\s-1FROZEN\s0\fR در نوار وضعیت مشخص می‌شود)، دایرکتوری‌ها و فایل‌ها بارگذاری نخواهند شد؛ این ویژگی در حالتی که تمامی فایل‌های مورد نیاز قبلاً بارگذاری شده‌اند، عملکرد را بهبود می‌بخشد. این کار روی پیش‌نمایش فایل‌ها، که می‌تواند با \fIzI\fR تغییر وضعیت داده شود، تأثیری ندارد. همچنین می‌توانید پیش‌نمایش دایرکتوری‌ها را با \fIzP\fR غیرفعال کنید. .IP "^L" 14 .IX Item "^L" بازترسیم صفحه نمایش .IP "i" 14 .IX Item "i" بررسی فایل جاری در پنجره‌ای بزرگ‌تر. .IP "E" 14 .IX Item "E" ویرایش فایل جاری در \f(CW$VISUAL\fR، در غیر این صورت در \f(CW$EDITOR\fR وگرنه در \*(L"vim\*(R" .IP "S" 14 .IX Item "S" باز کردن یک شل در دایرکتوری جاری .IP "?" 14 باز کردن همین صفحه راهنما (man page) .IP "W" 14 .IX Item "W" باز کردن پنجره لاگ برای بازبینی پیام‌هایی که در پایین صفحه نمایان می‌شوند. .IP "w" 14 .IX Item "w" باز کردن پنجره وظایف که در آن می‌توانید فرآیندهای پس‌زمینه‌ای را که در حال حاضر در ranger اجرا می‌شوند مشاهده و ویرایش کنید. در آنجا می‌توانید با فشردن \*(L"dd\*(R" یک فرآیند را لغو کرده و با \&\*(L"J\*(R" یا \*(L"K\*(R" اولویت فرآیند را تغییر دهید. در هر زمان تنها یک فرآیند اجرا می‌شود. .IP "^C" 14 .IX Item "^C" توقف فرآیند پس‌زمینه در حال اجرایی که ranger آغاز کرده است، مانند کپی کردن فایل‌ها، بارگذاری دایرکتوری‌ها یا پیش‌نمایش فایل‌ها. .IP "=, +, \-" 14 .IX Item "=, +, -" تغییر مجوزهای موارد انتخاب‌شده. برای نمونه، \f(CW\*(C`777=\*(C'\fR معادل \&\f(CW\*(C`chmod 777 %s\*(C'\fR است، \f(CW\*(C`+ar\*(C'\fR دستور \f(CW\*(C`chmod a+r %s\*(C'\fR را اجرا می‌کند، \f(CW\*(C`\-ow\*(C'\fR دستور \f(CW\*(C`chmod o\-w %s\*(C'\fR را اجرا می‌کند و غیره. .IP "yy" 14 .IX Item "yy" کپی (yank) موارد انتخاب‌شده، مانند فشردن Ctrl+C در برنامه‌های مدرن \s-1GUI\s0. (همچنین می‌توانید \*(L"ya\*(R" را برای افزودن فایل‌ها به بافر کپی، \*(L"yr\*(R" را برای حذف مجدد فایل‌ها، یا \*(L"yt\*(R" را برای تغییر وضعیت وارد کنید.) .IP "dd" 14 .IX Item "dd" برش (cut) موارد انتخاب‌شده، مانند فشردن Ctrl+X در برنامه‌های مدرن \s-1GUI\s0. (کلیدهای میان‌بر \*(L"da\*(R"، \*(L"dr\*(R" و \*(L"dt\*(R" نیز معادل \*(L"ya\*(R"، \*(L"yr\*(R" و \*(L"yt\*(R" وجود دارند.) .IP "pp" 14 .IX Item "pp" جای‌گذاری (paste) فایل‌هایی که قبلاً کپی یا بریده شده‌اند، مانند فشردن Ctrl+V در برنامه‌های مدرن \s-1GUI\s0. .Sp نام فایل‌های دارای تداخل با افزودن یک '_' (و در صورت نیاز یک شمارنده) تغییر می‌یابد، که حاصل آن \f(CW\*(C`file.ext_\*(C'\fR، \f(CW\*(C`file.ext_0\*(C'\fR و غیره خواهد بود. اگر ترجیح می‌دهید به صورت \f(CW\*(C`file_.ext\*(C'\fR باشد، می‌توانید از دستور \f(CW\*(C`paste_ext\*(C'\fR استفاده کنید. .IP "po" 14 .IX Item "po" جای‌گذاری فایل‌های کپی/بریده‌شده، با رونویسی روی فایل‌های موجود. .IP "pP, pO" 14 .IX Item "pP, pO" مانند pp و po، اما عملیات را در صف قرار می‌دهد تا \fIپس از\fR تمامی عملیات دیگر اجرا شود. یادآوری: \f(CW\*(C`w\*(C'\fR را برای باز کردن پنجره وظایف فشار دهید. .IP "pl, pL" 14 .IX Item "pl, pL" ایجاد پیوندهای نمادین (symlinks) مطلق یا نسبی به فایل‌های کپی‌شده .IP "phl" 14 .IX Item "phl" ایجاد پیوندهای سخت (hardlinks) به فایل‌های کپی‌شده .IP "pht" 14 .IX Item "pht" تکثیر ساختار زیردایرکتوری‌های دایرکتوری کپی‌شده، و سپس ایجاد پیوندهای سخت برای تک‌تک فایل‌های موجود درون درخت دایرکتوری جدید. .IP "m\fIX\fR" 14 .IX Item "mX" ایجاد یک نشانک با نام \fIX\fR .IP "`\fIX\fR" 14 .IX Item "`X" حرکت به نشانک با نام \fIX\fR .IP "n" 14 .IX Item "n" یافتن فایل بعدی. به‌طور پیش‌فرض، شما را به جدیدترین فایل در دایرکتوری می‌برد، اما اگر با استفاده از کلیدهای /، cm، ct و... جستجو کرده باشید، شما را به مورد منطبق بعدی خواهد برد. .IP "N" 14 .IX Item "N" یافتن فایل قبلی. .IP "o\fIX\fR" 14 .IX Item "oX" تغییر روش مرتب‌سازی (مانند mutt) .IP "z\fIX\fR" 14 .IX Item "zX" تغییر تنظیمات. برای مشاهده فهرستی از تنظیمات و کلیدهای میان‌بر آن‌ها، بخش تنظیمات را ببینید. .IP "u\fI?\fR" 14 .IX Item "u?" کلید واگرد (undo) سراسری. بسته به کلیدی که پس از \*(L"u\*(R" فشار می‌دهید، زبانه‌های بسته‌شده را بازیابی می‌کند (uq)، برچسب‌ها را حذف می‌کند (ut)، بافر کپی/برش را پاک می‌کند (ud)، حالت دیداری معکوس را آغاز می‌کند (uV) یا موارد انتخاب‌شده را لغو می‌کند (uv). .IP "f" 14 .IX Item "f" پیمایش سریع با وارد کردن بخشی از نام فایل. .IP "Space" 14 .IX Item "Space" علامت‌گذاری یک فایل. .IP "v" 14 .IX Item "v" تغییر وضعیت علامت‌گذاری همه فایل‌ها .IP "V" 14 .IX Item "V" آغاز حالت دیداری (visual mode) که تمام فایل‌های بین نقطه شروع و مکان‌نما را تا زمان فشردن \s-1ESC\s0 انتخاب می‌کند. برای لغو انتخاب فایل‌ها به همین شیوه، از \*(L"uV\*(R" استفاده کنید. .IP "/" 14 جستجوی فایل‌ها در دایرکتوری جاری. .IP ":" 14 باز کردن کنسول. .IP "!" 14 باز کردن کنسول با عبارت پیش‌فرض \*(L"shell \*(R" برای اجرای سریع دستورها. .IP "@" 14 باز کردن کنسول با عبارت \*(L"shell \f(CW%s\fR\*(R"، که مکان‌نما قبل از \&\*(L" \f(CW%s\fR\*(R" قرار می‌گیرد تا بتوانید سریعاً دستورها را با موارد انتخاب‌شده جاری به عنوان آرگومان اجرا کنید. .IP "r" 14 .IX Item "r" باز کردن کنسول با عبارت \*(L"open with \*(R" تا بتوانید تعیین کنید چه برنامه‌ای برای باز کردن فایل‌های انتخاب‌شده فعلی استفاده شود. .IP "cd" 14 .IX Item "cd" باز کردن کنسول با عبارت \*(L"cd \*(R" .IP "^P" 14 .IX Item "^P" باز کردن کنسول با آخرین دستور اجراشده. .IP "Alt\-\fIN\fR" 14 .IX Item "Alt-N" باز کردن یک زبانه. مقدار N باید عددی از 0 تا 9 باشد. اگر زبانه از قبل وجود نداشته باشد، ایجاد خواهد شد. .IP "Alt-l, Alt-r" 14 .IX Item "Alt-l, Alt-r" انتقال زبانه به ترتیب به چپ یا به راست. .IP "gn, ^N" 14 .IX Item "gn, ^N" ایجاد یک زبانه جدید. .IP "gt, gT" 14 .IX Item "gt, gT" رفتن به زبانه بعدی یا قبلی. همچنین می‌توانید به جای آن از \s-1TAB\s0 و \s-1SHIFT+TAB\s0 استفاده کنید. .IP "gc, ^W" 14 .IX Item "gc, ^W" بستن زبانه جاری. آخرین زبانه را نمی‌توان به این شیوه بست. .IP "M" 14 .IX Item "M" یک توالی کلید که امکان تغییر سریع حالت نمایش خط (line mode) همه فایل‌های دایرکتوری جاری را فراهم می‌کند. برای یک راه‌حل ماندگارتر، از دستور \&\*(L"default_linemode\*(R" در فایل rc.conf خود استفاده کنید..IP ".d" 14 .IX Item ".d" اعمال فیلتر نوع \*(L"directory\*(R". .IP ".f" 14 .IX Item ".f" اعمال فیلتر نوع \*(L"file\*(R". .IP ".l" 14 .IX Item ".l" اعمال فیلتر نوع \*(L"symlink\*(R". .IP ".m" 14 .IX Item ".m" اعمال یک فیلتر mimetype جدید. .IP ".n" 14 .IX Item ".n" اعمال یک فیلتر نام فایل جدید. .IP ".#" 14 اعمال یک فیلتر hash جدید. .IP ".""" 14 اعمال یک فیلتر تکراری (duplicate) جدید. .IP ".'" 14 اعمال یک فیلتر یکتا (unique) جدید. .IP ".|" 14 ترکیب دو فیلتر بالایی پشته فیلتر با رابطه \f(CW\*(C`OR\*(C'\fR، به جای رابطه \f(CW\*(C`AND\*(C'\fR که به صورت ضمنی استفاده می‌شود. .IP ".&" 14 ترکیب صریح دو فیلتر بالایی با رابطه \f(CW\*(C`AND\*(C'\fR. معمولاً نیازی به آن نیست زیرا فیلترها به صورت ضمنی در این رابطه هستند، با این حال ممکن است در سناریوهای پیچیده‌تر مفید باشد. .IP ".!" 14 نفی کردن (NOT) بالاترین فیلتر. .IP ".r" 14 .IX Item ".r" چرخش پشته فیلتر به اندازه N عنصر. که در آن N به عنوان یک پیشوند عددی مانند \fIcount\fR در vim ارائه می‌شود و پیش‌فرض آن ۱ است، یعنی بالاترین عنصر را به انتهای پشته منتقل می‌کند. .IP ".c" 14 .IX Item ".c" پاکسازی پشته فیلتر. .IP ".*" 14 تجزیه ترکیب‌کننده فیلتر بالایی (مانند \f(CW\*(C`.!\*(C'\fR، \f(CW\*(C`.|\*(C'\fR). .IP ".p" 14 .IX Item ".p" برداشتن (Pop) بالاترین فیلتر از پشته فیلتر. .IP ".." 14 نمایش وضعیت فعلی پشته فیلتر. .SS "کلیدهای مشابه READLINE در کنسول (\s-1READLINE-LIKE BINDINGS IN THE CONSOLE\s0)" .IX Subsection "READLINE-LIKE BINDINGS IN THE CONSOLE" .IP "^B, ^F" 14 .IX Item "^B, ^F" حرکت به چپ و راست (B برای عقب، F برای جلو) .IP "^P, ^N" 14 .IX Item "^P, ^N" حرکت به بالا و پایین (P برای قبلی، N برای بعدی) .IP "^A, ^E" 14 .IX Item "^A, ^E" حرکت به ابتدا یا انتها .IP "Alt-B, Alt-LEFT" 14 .IX Item "Alt-B, Alt-LEFT" حرکت کلمه‌ای به عقب. .IP "Alt-F, Alt-RIGHT" 14 .IX Item "Alt-F, Alt-RIGHT" حرکت کلمه‌ای به جلو. .IP "^D" 14 .IX Item "^D" حذف نویسه فعلی. .IP "^H" 14 .IX Item "^H" حذف نویسه قبلی (Backspace). .SH "دکمه‌های ماوس (MOUSE BUTTONS)" .IX Header "MOUSE BUTTONS" .IP "Left Mouse Button" 4 .IX Item "Left Mouse Button" روی یک مورد کلیک کنید تا به آنجا بروید. برای اجرای یک فایل، با کلیک روی پیش‌نمایش، مانند یک دایرکتوری \*(L"وارد\*(R" آن شوید. .IP "Right Mouse Button" 4 .IX Item "Right Mouse Button" ورود به یک دایرکتوری یا اجرای یک فایل. .IP "Scroll Wheel" 4 .IX Item "Scroll Wheel" پیمایش به بالا یا پایین. می‌توانید هنگام پیمایش به ستون دایرکتوری والد اشاره کنید تا بین دایرکتوری‌ها جابه‌جا شوید..SH "تنظیمات (SETTINGS)" .IX Header "SETTINGS" این بخش تمام تنظیمات توکار ranger را فهرست می‌کند. انواع معتبر برای مقدار در [کروکه‌ها] آمده‌اند. کلید فوری برای تغییر وضعیت تنظیم در صورت وجود، درون <علامت‌های زاویه‌دار> قرار دارد. .PP تنظیمات را می‌توان در فایل \fI~/.config/ranger/rc.conf\fR یا در حین اجرا با دستور \fB:set option value\fR تغییر داد. مثال‌ها: .PP .Vb 2 \& set column_ratios 1,2,3 \& set show_hidden true .Ve .PP تغییر وضعیت گزینه‌ها را می‌توان با این دستور انجام داد: .PP .Vb 1 \& set show_hidden! .Ve .PP انواع مختلف تنظیمات و یک مثال برای هر نوع: .PP .Vb 7 \& setting type | example values \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& bool | true, false \& integer | 1, 23, 1337 \& string | foo, hello world \& list | 1,2,3,4 \& none | none .Ve .PP می‌توانید با فشردن \*(L"3?\*(R" در ranger، فهرستی از تمام تنظیمات و مقادیر فعلی آن‌ها را مشاهده کنید. .IP "automatically_count_files [bool]" 4 .IX Item "automatically_count_files [bool]" آیا ranger باید به محض نمایان شدن هر دایرکتوری، تعداد فایل‌های درون آن را شمارش کرده و نمایش دهد؟ این کار در سیستم‌فایل‌های دوردست (remote) کُند می‌شود. خاموش کردن آن همچنان به شما امکان می‌دهد پس از ورود به دایرکتوری، تعداد فایل‌ها را مشاهده کنید. .IP "autosave_bookmarks [bool]" 4 .IX Item "autosave_bookmarks [bool]" ذخیرهٔ فوری نشانک‌ها (استفاده‌شده با mX و `X)؟ این کار به همگام‌سازی نشانک‌ها میان چندین نمونهٔ ranger کمک می‌کند اما منجر به افت عملکرد *اندکی* می‌شود. در صورت false بودن، نشانک‌ها هنگام خروج از ranger ذخیره می‌شوند. .IP "autoupdate_cumulative_size [bool]" 4 .IX Item "autoupdate_cumulative_size [bool]" شما می‌توانید با استفاده از دستور :get_cumulative_size یا تایپ \*(L"dc\*(R"، حجم تجمیعی «واقعی» دایرکتوری‌ها را نمایش دهید. محاسبهٔ این حجم سنگین است و به‌صورت خودکار به‌روزرسانی نخواهد شد. با این حال، با فعال کردن این گزینه می‌توانید به‌روزرسانی خودکار آن را انتخاب کنید. .IP "cd_bookmarks [bool]" 4 .IX Item "cd_bookmarks [bool]" مشخص می‌کند که آیا نشانک‌ها باید در تکمیل خودکار با کلید تب (tab completion) برای دستور \*(L"cd\*(R" گنجانده شوند یا خیر. .IP "cd_tab_case [string]" 4 .IX Item "cd_tab_case [string]" حساسیت به حروف بزرگ و کوچک را برای تکمیل با تب در دستور \*(L"cd\*(R" تغییر می‌دهد. مقادیر ممکن عبارتند از: .Sp .Vb 3 \& sensitive \& insensitive \& smart .Ve .IP "cd_tab_fuzzy [bool]" 4 .IX Item "cd_tab_fuzzy [bool]" استفاده از تکمیل فازی با کلید تب در دستور \*(L"cd\*(R". برای مثال، \&\fB:cd /u/lo/b<\s-1TAB\s0>\fR به \fB:cd /usr/local/bin\fR بسط می‌یابد. .IP "clear_filters_on_dir_change [bool]" 4 .IX Item "clear_filters_on_dir_change [bool]" اگر روی 'true' تنظیم شود، فیلترهای ماندگار با ترک دایرکتوری پاک خواهند شد. .IP "collapse_preview [bool] " 4 .IX Item "collapse_preview [bool] " هنگامی که هیچ پیش‌نمایشی نمایان نیست، آیا ستون آخر باید جمع شود تا از فضای خالی استفاده به عمل آید؟ .IP "colorscheme [string]" 4 .IX Item "colorscheme [string]" کدام طرح رنگی استفاده شود؟ این طرح‌های رنگی به‌طور پیش‌فرض در دسترس هستند: \&\fBdefault\fR، \fBjungle\fR، \fBsnow\fR. طرح snow یک طرح تک‌رنگ است، و jungle برای وضوح بهتر در برخی ترمینال‌ها، دایرکتوری‌های آبی را با رنگ سبز جایگزین می‌کند. .IP "column_ratios [list]" 4 .IX Item "column_ratios [list]" چند ستون وجود دارد، و عرض‌های نسبی آن‌ها چقدر است؟ برای مثال، مقدار 1,1,1 به معنای ۳ ستون با اندازه‌های مساوی است. مقدار 1,1,1,1,4 یعنی ۵ ستون که در آن ستون پیش‌نمایش به اندازهٔ مجموع تمام ستون‌های دیگر است. .IP "confirm_on_delete [string]" 4 .IX Item "confirm_on_delete [string]" آیا هنگام اجرای دستور \*(L"delete\*(R" تأییدیه خواسته شود؟ مقادیر معتبر عبارتند از \&\*(L"always\*(R" (پیش‌فرض)، \*(L"never\*(R"، \*(L"multiple\*(R". با مقدار \*(L"multiple\*(R"، نرم‌افزار ranger تنها در صورتی درخواست تأیید می‌کند که چند فایل را هم‌زمان حذف کنید. .IP "dirname_in_tabs [bool]" 4 .IX Item "dirname_in_tabs [bool]" آیا نام دایرکتوری در زبانه‌ها نمایش داده شود؟ .IP "display_size_in_main_column [bool]" 4 .IX Item "display_size_in_main_column [bool]" آیا حجم فایل در ستون اصلی نمایش داده شود؟ .IP "display_size_in_status_bar [bool]" 4 .IX Item "display_size_in_status_bar [bool]" آیا حجم فایل در نوار وضعیت نمایش داده شود؟ .IP "display_free_space_in_status_bar [bool]" 4 .IX Item "display_free_space_in_status_bar [bool]" آیا فضای خالی دیسک در نوار وضعیت نمایش داده شود؟ .IP "display_tags_in_all_columns [bool]" 4 .IX Item "display_tags_in_all_columns [bool]" آیا برچسب‌ها در تمام ستون‌ها نمایش داده شوند؟ .IP "draw_borders [string]" 4 .IX Item "draw_borders [string]" رسم حاشیه‌ها در اطراف یا بین ستون‌ها؟ مقادیر ممکن عبارتند از: .Sp .Vb 4 \& none بدون هیچ‌گونه حاشیه \& outline رسم کادر بیرونی دور تمام ستون‌ها \& separators رسم تنها خطوط عمودی بین ستون‌ها \& both هر دو مورد بالا .Ve .IP "draw_progress_bar_in_status_bar [bool]" 4 .IX Item "draw_progress_bar_in_status_bar [bool]" آیا یک نوار پیشرفت در نوار وضعیت رسم شود که وضعیت میانگین تمام وظایف در حال اجرای پشتیبانی‌کننده از نوار پیشرفت را نمایش دهد؟ .IP "flushinput [bool] " 4 .IX Item "flushinput [bool] " تخلیهٔ ورودی پس از هر بار فشردن کلید؟ یک مزیت این است که هنگام پیمایش به پایین با \*(L"j\*(R"، به محض رها کردن کلید، ranger فوراً پیمایش را متوقف می‌کند. یک عیب آن این است که هنگام تایپ سریع و ندیدهٔ دستورها، ممکن است برخی کلیدها از دست بروند. .IP "freeze_files [bool] " 4 .IX Item "freeze_files [bool] " در صورت فعال بودن، دایرکتوری‌ها و فایل‌ها بارگذاری نخواهند شد، که در صورت بارگذاری بودن تمام فایل‌های مورد نیاز شما، کارایی را بهبود می‌بخشد. این مورد بر پیش‌نمایش فایل‌ها تأثیری ندارد. .IP "global_inode_type_filter [string]" 4 .IX Item "global_inode_type_filter [string]" مشابه filter_inode_type، اما به‌صورت سراسری برای تمام دایرکتوری‌ها. در ترکیب با \fB\-\-choosedir\fR کاربردی است: .Sp .Vb 1 \& ranger \-\-choosedir=/tmp/x \-\-cmd=\*(Aqset global_inode_type_filter d\*(Aq .Ve .IP "hidden_filter [string]" 4 .IX Item "hidden_filter [string]" یک الگوی عبارت منظم برای فایل‌هایی که باید پنهان شوند. برای نمونه، این الگو تمام فایل‌هایی را که با نقطه شروع شده یا با تیلدا پایان می‌یابند پنهان می‌کند. .Sp .Vb 1 \& set hidden_filter ^\e.|~$ .Ve .IP "hint_collapse_threshold [int]" 4 .IX Item "hint_collapse_threshold [int]" فهرست‌های راهنمای کلیدها تا این اندازه، زیرفهرست‌هایشان باز خواهد شد. در غیر این صورت، نگاشت‌های فرعی با \*(L"...\*(R" جایگزین می‌شوند. .IP "hostname_in_titlebar [bool]" 4 .IX Item "hostname_in_titlebar [bool]" آیا hostname در نوار عنوان نمایش داده شود؟ .IP "size_in_bytes [bool]" 4 .IX Item "size_in_bytes [bool]" چاپ اندازهٔ فایل‌ها به بایت، به جای قالب پیش‌فرض خوانا برای انسان. .IP "idle_delay [integer]" 4 .IX Item "idle_delay [integer]" مدت زمانی (به میلی‌ثانیه) که ranger در حالت بی‌کار منتظر ورودی کاربر می‌ماند، با دقت ۱۰۰ میلی‌ثانیه. تأخیر کمتر، وقفهٔ بین به‌روزرسانی‌های دایرکتوری را کاهش می‌دهد اما بار پردازنده (\s-1CPU\s0) را افزایش می‌دهد. .IP "iterm2_font_height [integer]" 4 .IX Item "iterm2_font_height [integer]" تغییر ارتفاع فرض‌شدهٔ قلم در iTerm2، که ممکن است به پیش‌نمایش تصویر در iTerm کمک کند. .IP "iterm2_font_width [integer]" 4 .IX Item "iterm2_font_width [integer]" تغییر عرض فرض‌شدهٔ قلم در iTerm2، که ممکن است به پیش‌نمایش تصویر در iTerm کمک کند. .IP "line_numbers [string]" 4 .IX Item "line_numbers [string]" نمایش شماره خط‌ها در ستون اصلی. مقادیر ممکن عبارتند از: .Sp .Vb 3 \& false خاموش کردن این ویژگی \& absolute شماره‌خط‌های مطلق برای استفاده با "gg" \& relative شماره‌خط‌های نسبی برای "k" یا "j" .Ve .IP "max_console_history_size [integer, none]" 4 .IX Item "max_console_history_size [integer, none]" چه تعداد از دستورهای کنسول باید در تاریخچه نگه داشته شوند؟ مقدار \*(L"none\*(R" این محدودیت را غیرفعال می‌کند..IP "max_history_size [integer, none]" 4 .IX Item "max_history_size [integer, none]" چه تعداد تغییر دایرکتوری باید در تاریخچه نگه‌داری شود؟ .IP "metadata_deep_search [bool]" 4 .IX Item "metadata_deep_search [bool]" هنگامی که پودمان مدیریت فراداده (metadata) به دنبال فراداده می‌گردد، آیا تنها به دنبال یک فایل \&\*(L".metadata.json\*(R" در دایرکتوری جاری بگردد، یا یک جستجوی عمیق انجام دهد و تمام دایرکتوری‌های بالاتر از دایرکتوری جاری را نیز بررسی کند؟ .IP "mouse_enabled [bool] " 4 .IX Item "mouse_enabled [bool] " ورودی موشواره فعال شود؟ .IP "nested_ranger_warning [string]" 4 .IX Item "nested_ranger_warning [string]" هنگام راه‌اندازی هشدار داده شود اگر \f(CW\*(C`RANGER_LEVEL\*(C'\fR بزرگتر از ۰ باشد؛ به عبارت دیگر هنگامی که ranger را در یک زیرپوسته اجرا شده توسط ranger به صورت تو در تو اجرا می‌کنید، هشدار داده شود. مقادیر مجاز عبارتند از \f(CW\*(C`true\*(C'\fR، \f(CW\*(C`false\*(C'\fR و \f(CW\*(C`error\*(C'\fR. مقدار ویژهٔ \f(CW\*(C`error\*(C'\fR این هشدار را به یک خطا ارتقا می‌دهد؛ این معمولاً به عنوان متن قرمز نمایش داده می‌شود اما در صورت اجرا با پرچم \f(CW\*(C`\-\-debug\*(C'\fR، باعث خرابی و بسته شدن ناگهانی (crash) برنامه ranger خواهد شد. .IP "one_indexed [bool]" 4 .IX Item "one_indexed [bool]" شروع شماره خطوط از ۱. مقادیر ممکن عبارتند از: .Sp .Vb 2 \& false شروع شماره خطوط از ۰ \& true شروع شماره خطوط از ۱ .Ve .IP "open_all_images [bool]" 4 .IX Item "open_all_images [bool]" آیا هنگام اجرای نمایش‌دهنده‌های تصویر خاصی مانند feh یا sxiv، تمام تصاویر موجود در این دایرکتوری باز شوند؟ شما همچنان می‌توانید با علامت‌گذاری فایل‌ها، فایل‌های انتخابی را باز کنید. .Sp اگر تعداد فایل‌ها برای پردازش توسط سیستم بیش از حد زیاد باشد، این گزینه به طور خودکار و موقت غیرفعال خواهد شد. .IP "padding_right [bool]" 4 .IX Item "padding_right [bool]" هنگامی که collapse_preview روشن است و پیش‌نمایشی وجود ندارد، آیا حاشیه خالی کمی در سمت راست باقی بماند؟ این به شما امکان می‌دهد تا با کلیک روی آن فضا، فایل را اجرا کنید. .IP "preview_directories [bool] " 4 .IX Item "preview_directories [bool] " پیش‌نمایش دایرکتوری‌ها در ستون پیش‌نمایش نمایش داده شود؟ .IP "preview_files [bool] " 4 .IX Item "preview_files [bool] " پیش‌نمایش فایل‌ها در ستون پیش‌نمایش نمایش داده شود؟ .IP "preview_images [bool]" 4 .IX Item "preview_images [bool]" تصاویر درون کنسول با استفاده از برنامه خارجی w3mimgpreview رسم شوند؟ .IP "preview_images_method [string]" 4 .IX Item "preview_images_method [string]" تنظیم روش پیش‌نمایش تصویر. روش‌های پشتیبانی‌شده: w3m، iterm2، urxvt، urxvt-full، terminology. بخش \fI\s-1PREVIEWS\s0\fR را ببینید. .IP "preview_max_size [int]" 4 .IX Item "preview_max_size [int]" خودداری از پیش‌نمایش فایل‌هایی که از اندازه‌ای مشخص (به بایت) تجاوز می‌کنند. برای غیرفعال کردن این ویژگی از مقدار ۰ استفاده کنید. .IP "preview_script [string, none]" 4 .IX Item "preview_script [string, none]" کدام اسکریپت باید تولید پیش‌نمایش‌ها را مدیریت کند؟ اگر فایل وجود نداشته باشد، یا use_preview_script خاموش باشد، ranger خود پیش‌نمایش‌ها را صرفاً با چاپ محتوا مدیریت خواهد کرد. .IP "relative_current_zero [bool]" 4 .IX Item "relative_current_zero [bool]" هنگامی که line_numbers روی relative تنظیم شده باشد، در صورت true بودن روی خط جاری عدد ۰ را نشان می‌دهد و در صورت false بودن شماره مطلق خط جاری نمایش داده می‌شود. .IP "save_backtick_bookmark [bool]" 4 .IX Item "save_backtick_bookmark [bool]" نشانک \f(CW\*(C`\`\*(C'\fR روی دیسک ذخیره شود. این نشانک برای رفتن به آخرین دایرکتوری با تایپ کردن \f(CW\*(C`\`\`\*(C'\fR استفاده می‌شود. .IP "save_console_history [bool]" 4 .IX Item "save_console_history [bool]" آیا تاریخچه کنسول هنگام خروج ذخیره شود؟ در صورت غیرفعال بودن، تاریخچه کنسول هنگام راه‌اندازی مجدد ranger بازنشانی می‌شود. .IP "save_tabs_on_exit [bool]" 4 .IX Item "save_tabs_on_exit [bool]" تمام تب‌ها، به جز تب فعال، هنگام خروج ذخیره شوند؟ آخرین تب‌های ذخیره‌شده یک بار هنگام شروع نشست بعدی بازیابی می‌شوند. نشست‌های متعدد در یک پشته (stack) ذخیره می‌شوند و قدیمی‌ترین تب‌های ذخیره‌شده ابتدا بازیابی خواهند شد. .IP "scroll_offset [integer]" 4 .IX Item "scroll_offset [integer]" هنگام پیمایش، تلاش شود این مقدار فضا بین حاشیه بالا/پایین حفظ شود. .IP "shorten_title [integer]" 4 .IX Item "shorten_title [integer]" اگر عنوان پنجره طولانی شد، کوتاه شود؟ این عدد مشخص می‌کند چه تعداد دایرکتوری به طور همزمان نمایش داده شوند. مقدار ۰ این ویژگی را خاموش می‌کند. .IP "show_cursor [bool]" 4 .IX Item "show_cursor [bool]" مکان‌نمای ترمینال همیشه نمایش داده شود؟ .IP "show_hidden_bookmarks [bool]" 4 .IX Item "show_hidden_bookmarks [bool]" نمایش فایل‌های نقطه‌دار (مخفی) در پنجره پیش‌نمایش نشانک‌ها؟ (تایپ کنید ') .IP "show_hidden [bool] , <^H>" 4 .IX Item "show_hidden [bool] , <^H>" فایل‌های مخفی نمایش داده شوند؟ .IP "show_selection_in_titlebar [bool]" 4 .IX Item "show_selection_in_titlebar [bool]" فایل برجسته‌شده به مسیر در نوار عنوان اضافه شود .IP "sort_case_insensitive [bool] " 4 .IX Item "sort_case_insensitive [bool] " مرتب‌سازی بدون حساسیت به بزرگی و کوچکی حروف؟ اگر true باشد، \*(L"a\*(R" قبل از \*(L"B\*(R" فهرست می‌شود حتی اگر مقدار \s-1ASCII\s0 آن بزرگتر باشد. .IP "sort_directories_first [bool] " 4 .IX Item "sort_directories_first [bool] " دایرکتوری‌ها در ابتدا مرتب شوند؟ .IP "sort_reverse [bool] " 4 .IX Item "sort_reverse [bool] " ترتیب فایل‌ها معکوس شود؟ .IP "sort_unicode [bool]" 4 .IX Item "sort_unicode [bool]" هنگام مرتب‌سازی بر اساس یک رشته، آیا برای صرفه‌جویی در زمان به جای بررسی مقادیر خام نویسه‌ها، نویسه‌های یونیکد مقایسه شوند؟ .IP "sort [string] , , , , , , , , " 4 .IX Item "sort [string] , , , , , , , , " از چه سازوکار مرتب‌سازی استفاده شود؟ یکی از گزینه‌های \fBatime\fR، \fBbasename\fR، \&\fBctime\fR، \fBextension\fR، \fBmtime\fR، \fBnatural\fR، \fBtype\fR، \fBsize\fR، \fBrandom\fR را انتخاب کنید. .Sp نکته: می‌توانید با فشردن دومین حرف ترکیب کلیدی به صورت بزرگ، ترتیب را برعکس کنید؛ برای نمونه \*(L"oN\*(R" برای مرتب‌سازی از Z به A. .IP "status_bar_on_top [bool]" 4 .IX Item "status_bar_on_top [bool]" نوار وضعیت در بالای پنجره قرار گیرد؟ .IP "tilde_in_titlebar [bool]" 4 .IX Item "tilde_in_titlebar [bool]" مسیر \f(CW$HOME\fR با ~ در نوار عنوان (خط اول) ranger کوتاه شود؟ .IP "unicode_ellipsis [bool]" 4 .IX Item "unicode_ellipsis [bool]" استفاده از نویسه یونیکد \*(L"...\*(R" به جای \*(L"~\*(R" برای مشخص کردن نام‌های بریده‌شده فایل‌ها؟ .IP "bidi_support [bool]" 4 .IX Item "bidi_support [bool]" تلاش برای نمایش صحیح نام فایل‌ها در زبان‌های راست‌به‌چپ (\s-1RTL\s0) (مانند عبری و عربی) با استفاده از الگوریتم \s-1BIDI\s0 برای معکوس کردن بخش‌های مرتبط متن. به بسته pip با نام python-bidi نیاز دارد. .IP "update_title [bool]" 4 .IX Item "update_title [bool]" عنوان پنجره تنظیم شود؟ هر دو ویژگی \fI\s-1WM_NAME\s0\fR و \fI\s-1WM_ICON_NAME\s0\fR را به‌روزرسانی می‌کند. .IP "update_tmux_title [bool]" 4 .IX Item "update_tmux_title [bool]" مقدار \fIwindow-name\fR در tmux/screen به \*(L"ranger\*(R" تنظیم شود؟ .IP "use_preview_script [bool] " 4 .IX Item "use_preview_script [bool] " از اسکریپت پیش‌نمایش تعریف‌شده در تنظیم \fIpreview_script\fR استفاده شود؟ .IP "vcs_aware [bool]" 4 .IX Item "vcs_aware [bool]" گردآوری و نمایش داده‌های مربوط به سیستم‌های کنترل نسخه. سیستم‌های vcs پشتیبانی‌شده: git، hg. .IP "vcs_backend_git, vcs_backend_hg, vcs_backend_bzr, vcs_backend_svn [string]" 4 .IX Item "vcs_backend_git, vcs_backend_hg, vcs_backend_bzr, vcs_backend_svn [string]" وضعیت را برای باک‌اند سیستم کنترل نسخه تنظیم می‌کند. مقادیر ممکن عبارتند از: .Sp .Vb 4 \& disabled هیچ اطلاعاتی نمایش نده. \& local تنها وضعیت محلی نمایش داده شود. \& enabled نمایش هر دو وضعیت محلی و دوردست. \& ممکن است برای hg و bzr کند باشد. .Ve .IP "vcs_msg_length [int]" 4 .IX Item "vcs_msg_length [int]" طول برش خط اول پیام‌های کامیت هنگام نمایش در نوار وضعیت. مقدار پیش‌فرض ۵۰ است. .IP "viewmode [string]" 4 .IX Item "viewmode [string]" حالت نما را تنظیم می‌کند، که می‌تواند \fBmiller\fR برای نمایش فایل‌ها در نمای سنتی ستونی میلر (که چندین سطح از سلسله‌مراتب را نشان می‌دهد) باشد، یا \&\fBmultipane\fR برای استفاده از چندین قاب (یکی به ازای هر تب) مشابه با midnight-commander. .IP "w3m_delay [float]" 4 .IX Item "w3m_delay [float]" تأخیر به ثانیه پیش از نمایش یک تصویر با روش w3m. در صورت مواجهه با به‌هم‌ریختگی در نمایش تصویر، آن را افزایش دهید. .IP "w3m_offset [int]" 4 .IX Item "w3m_offset [int]" انحراف (offset) به پیکسل برای حاشیه داخلی ترمینال. برخی ترمینال‌ها مانند st و UXterm نیاز دارند که این انحراف به‌طور صریح مشخص شود، و برخی دیگر مانند urxvt نیازی به آن ندارند. .IP "wrap_plaintext_previews [bool]" 4 .IX Item "wrap_plaintext_previews [bool]" آیا خطوط طولانی در پیجر (صفحه‌بندی‌کننده) شکسته شوند یا نه؛ این شامل پیش‌نمایش فایل‌های متنی ساده نیز می‌شود. .IP "wrap_scroll [bool]" 4 .IX Item "wrap_scroll [bool]" فعال‌سازی پیمایش چرخشی \- حرکت به سمت پایین هنگامی که روی آخرین مورد قرار دارید، به ابتدا بازمی‌گردد و برعکس. .IP "xterm_alt_key [bool]" 4 .IX Item "xterm_alt_key [bool]" اگر ترکیب‌های کلیدی با کلید Alt برای شما کار نمی‌کنند، این گزینه را فعال کنید. (به‌ویژه در xterm).SH "دستورها (COMMANDS)" .IX Header "COMMANDS" شما می‌توانید دستورها را در کنسول، که با فشردن \*(L":\*(R" باز می‌شود، وارد کنید. .PP شما همیشه می‌توانید با تایپ کردن \*(L"?c\*(R" در ranger، فهرستی از دستورهای موجود کنونی را دریافت کنید. جهت راحتی شما، این فهرستی از دستورهای «عمومی» شامل پارامترهای آن‌ها، بدون توضیحات است: .PP .Vb 10 \& 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=] 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] .Ve .PP دستورهای دیگری نیز وجود دارند که مستقیماً به توابع پایتون ترجمه می‌شوند، یک دستور به‌ازای هر متد در کلاس ranger.core.actions.Actions. این دستورها در اینجا مستند نشده‌اند، چرا که بیشتر برای مقیدسازی کلیدها هستند و نه برای تایپ شدن توسط کاربر. در صورت تمایل به دانستن دربارهٔ آن‌ها سورس‌کد را مطالعه کنید. .PP این‌ها دستورهای عمومی به‌همراه توضیحات آن‌ها هستند: .IP "alias [\fInewcommand\fR] [\fIoldcommand\fR]" 2 .IX Item "alias [newcommand] [oldcommand]" دستور oldcommand را با عنوان newcommand کپی می‌کند. .IP "bulkrename" 2 .IX Item "bulkrename" این دستور فهرستی از فایل‌های انتخاب‌شده را در یک ویرایشگر بیرونی باز می‌کند. پس از ویرایش و ذخیرهٔ فایل، یک اسکریپت شل تولید می‌شود که تغییر نام دسته‌جمعی را بر اساس تغییراتی که در فایل داده‌اید انجام می‌دهد. .Sp این اسکریپت شل جهت بازبینی برای شما در یک ویرایشگر باز می‌شود. پس از بستن آن، اجرا خواهد شد. .IP "cd [\fIpath\fR]" 2 .IX Item "cd [path]" دستور cd دایرکتوری را تغییر می‌دهد. اگر path یک فایل باشد، آن فایل را انتخاب می‌کند. دستور \f(CW\*(C`:cd \-\*(C'\fR معادل تایپ کردن `` است. .IP "chain \fIcommand1\fR[; \fIcommand2\fR[; \fIcommand3\fR...]]" 2 .IX Item "chain command1[; command2[; command3...]]" چندین دستور را که با نقطه‌ویرگول از هم جدا شده‌اند، در یک دستور ترکیب می‌کند. .IP "chmod \fIoctal_number\fR" 2 .IX Item "chmod octal_number" مجوزهای موارد انتخاب‌شده را به عدد در مبنای هشت تعیین می‌کند. .Sp عدد مبنای هشت بین 000 و 777 است. ارقام مشخص‌کنندهٔ مجوزها برای کاربر، گروه و دیگران هستند. عدد ۱ اجازهٔ اجرا، ۲ اجازهٔ نوشتن و ۴ اجازهٔ خواندن می‌دهد. برای ترکیب این مجوزها، اعداد را با هم جمع کنید؛ بنابراین عدد ۷ به همه‌چیز اجازه می‌دهد. .Sp کلیدهای مقیدشده به‌فرم [\-+] و = نیز وجود دارند. برای مثال، \fB+ar\fR اجازهٔ خواندن به همه می‌دهد، \-ow دیگران را از نوشتن منع می‌کند و 777= اجازهٔ همه‌چیز را می‌دهد. .Sp همچنین ببینید: man 1 chmod .IP "console [\-p\fIN\fR] \fIcommand\fR" 2 .IX Item "console [-pN] command" کنسول را در حالی باز می‌کند که command از قبل در آن تایپ شده است. مکان‌نما روی \&\fIN\fR قرار می‌گیرد. .IP "copymap \fIkey\fR \fInewkey\fR [\fInewkey2\fR ...]" 2 .IX Item "copymap key newkey [newkey2 ...]" .PD 0 .IP "copycmap \fIkey\fR \fInewkey\fR [\fInewkey2\fR ...]" 2 .IX Item "copycmap key newkey [newkey2 ...]" .IP "copypmap \fIkey\fR \fInewkey\fR [\fInewkey2\fR ...]" 2 .IX Item "copypmap key newkey [newkey2 ...]" .IP "copytmap \fIkey\fR \fInewkey\fR [\fInewkey2\fR ...]" 2 .IX Item "copytmap key newkey [newkey2 ...]" .PD کلید مقیدشدهٔ \fIkey\fR را به \fInewkey\fR در بافتار \*(L"browser\*(R" کپی می‌کند. این یک کپی عمیق است؛ بنابراین اگر بعداً مقیدسازی جدید (یا بخش‌هایی از آن) را تغییر دهید، کلید قدیمی تغییر نخواهد کرد. برای مثال، \fIcopymap j down\fR موجب می‌شود که توالی کلید \*(L"down\*(R" مکان‌نما را یک مورد به پایین ببرد. .Sp برای کپی کردن کلیدهای مقیدشده در console، pager یا taskview، به‌ترتیب از \*(L"copycmap\*(R"، \*(L"copypmap\*(R" یا \*(L"copytmap\*(R" استفاده کنید. .IP "default_linemode [\fIpath=regexp\fR | \fItag=tags\fR] \fIlinemodename\fR" 2 .IX Item "default_linemode [path=regexp | tag=tags] linemodename" حالت خط پیش‌فرض را تعیین می‌کند. دستور \fIlinemode\fR را ببینید. .Sp مثال‌ها: .Sp تنظیم حالت خط پیش‌فرض سراسری روی \*(L"permissions\*(R": :default_linemode permissions .Sp تنظیم حالت خط پیش‌فرض روی \*(L"permissions\*(R" برای تمام فایل‌هایی که با \*(L"p\*(R" یا \*(L"P\*(R" برچسب‌گذاری شده‌اند: :default_linemode tag=pP permissions .Sp تنظیم حالت خط پیش‌فرض برای تمام فایل‌های درون ~/books/ روی \*(L"metatitle\*(R": :default_linemode path=/home/.*?/books/.* metatitle .IP "delete" 2 .IX Item "delete" تمام فایل‌های انتخاب‌شده را با لگد چرخشی نابود می‌کند! اگر تلاش کنید چندین فایل (علامت‌گذاری‌شده) یا دایرکتوری‌های غیرخالی را حذف کنید، ranger از شما تأییدیه می‌خواهد. این رفتار با تغییر تنظیمات \*(L"confirm_on_delete\*(R" قابل تغییر است. .IP "echo \fItext\fR" 2 .IX Item "echo text" متن را در نوار وضعیت نمایش می‌دهد. .IP "edit [\fIfilename\fR]" 2 .IX Item "edit [filename]" فایل جاری یا فایل مشخص‌شده در آرگومان را ویرایش می‌کند. .IP "eval [\fI\-q\fR] \fIpython_code\fR" 2 .IX Item "eval [-q] python_code" کد پایتون را ارزیابی می‌کند. `fm' ارجاعی به نمونهٔ \s-1FM\s0 است. برای نمایش متن، از تابع `p' استفاده کنید. نتیجه روی صفحه نمایش داده می‌شود مگر آن‌که از گزینهٔ \*(L"\-q\*(R" استفاده کنید. .Sp مثال‌ها: :eval fm :eval len(fm.tabs) :eval p(\*(L"Hello World!\*(R") .IP "filter [\fIstring\fR]" 2 .IX Item "filter [string]" تنها فایل‌هایی را نمایش می‌دهد که شامل \fIstring\fR در basename خود باشند. اجرای این دستور بدون هیچ پارامتری فیلتر را بازنشانی می‌کند. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمام گزینه‌های آن پشتیبانی می‌کند. .IP "filter_inode_type [dfl]" 2 .IX Item "filter_inode_type [dfl]" تنها فایل‌های مربوط به نوع inode مشخص‌شده را نمایش می‌دهد. برای نمایش فقط دایرکتوری‌ها، از پارامتر 'd' استفاده کنید. برای نمایش فقط فایل‌ها، از پارامتر 'f' استفاده کنید. برای نمایش فقط پیوندها، از پارامتر 'l' استفاده کنید. پارامترها را می‌توان با هم ترکیب کرد. برای حذف این فیلتر، از هیچ پارامتری استفاده نکنید. .IP "filter_stack [\fIcommand\fR [\fIargs\fR]]" 2 .IX Item "filter_stack [command [args]]" مدیریت پشتهٔ فیلتر، افزودن، حذف و دستکاری فیلترها. برای مثال، برای نمایش فقط فایل‌های تکراری و پیوندهای نمادین: .Sp.Vb 5 \& :filter_stack add type f \& :filter_stack add duplicate \& :filter_stack add and \& :filter_stack add type l \& :filter_stack add or .Ve .Sp یا با استفاده از کلیدهای نگاشت‌شده: .Sp .Vb 1 \& .f ." .& .l .| .Ve .Sp زیردستورهای موجود: .RS 2 .IP "add \s-1FILTER_TYPE\s0 [\s-1ARGS...\s0]" 2 .IX Item "add FILTER_TYPE [ARGS...]" افزودن یک فیلتر جدید به بالای پشتهٔ فیلتر. هر فیلتر موجود در پشته به نوبت اعمال می‌شود که منجر به یک رابطهٔ منطقی ضمنی \f(CW\*(C`AND\*(C'\fR می‌گردد. \f(CW\*(C`FILTER_TYPE\*(C'\fRهای زیر در دسترس هستند: .RS 2 .IP "duplicate" 2 .IX Item "duplicate" فیلتر کردن فایل‌ها به‌طوری‌که تنها فایل‌هایی که نسخه‌های تکراری در همان دایرکتوری دارند نمایش داده شوند. این گزینه هنگام پاک‌سازی آهنگ‌ها یا میم‌های یکسانی که با نام‌های متفاوت ذخیره شده‌اند مفید است. .IP "filename \s-1NAME\s0" 2 .IX Item "filename NAME" فیلتر کردن فایل‌هایی که نام آن‌ها شامل \s-1NAME\s0 است؛ نحو عبارات باقاعده (regular expression) مجاز است. .IP "hash \s-1PATH\s0" 2 .IX Item "hash PATH" فیلتر کردن فایل‌ها به‌گونه‌ای که فقط فایل‌هایی با هش یکسان با \s-1PATH\s0 نمایش داده شوند. .IP "mimetype \s-1TYPE\s0" 2 .IX Item "mimetype TYPE" فیلتر کردن فایل‌های مربوط به یک نوع \s-1MIME\s0 مشخص؛ نحو عبارات باقاعده مجاز است. .IP "typefilter [d|f|l]" 2 .IX Item "typefilter [d|f|l]" فیلتر کردن فایل‌ها بر اساس نوعی مشخص؛ \f(CW\*(C`d\*(C'\fR برای دایرکتوری‌ها، \f(CW\*(C`f\*(C'\fR برای فایل‌ها و \f(CW\*(C`l\*(C'\fR برای پیوندهای نمادین (symlinks). .IP "unique" 2 .IX Item "unique" فیلتر کردن فایل‌ها به‌طوری‌که تنها فایل‌های یکتا و قدیمی‌ترین فایل از هر مجموعهٔ تکراری نمایش داده شود. .IP "and" 2 .IX Item "and" ترکیب صریح دو فیلتر بالایی پشته در رابطهٔ \*(L"\s-1AND\*(R"\s0. معمولاً نیازی به این کار نیست زیرا فیلترها به‌صورت ضمنی در این رابطه هستند، اگرچه ممکن است در سناریوهای پیچیده‌تر مفید باشد. .IP "not" 2 .IX Item "not" نقیض کردن بالاترین فیلتر پشته. .IP "or" 2 .IX Item "or" ترکیب دو فیلتر بالایی از پشتهٔ فیلتر در رابطهٔ \*(L"\s-1OR\*(R"\s0، به‌جای رابطهٔ \*(L"\s-1AND\*(R"\s0 که به‌صورت ضمنی استفاده می‌شود. .RE .RS 2 .RE .IP "pop" 2 .IX Item "pop" حذف و واکشی (pop) بالاترین فیلتر از پشتهٔ فیلتر. .IP "decompose" 2 .IX Item "decompose" تجزیه کردن ترکیب‌کنندهٔ بالاترین فیلتر (مانند \f(CW\*(C`.!\*(C'\fR، \f(CW\*(C`.|\*(C'\fR). .IP "rotate [N=1]" 2 .IX Item "rotate [N=1]" چرخاندن پشتهٔ فیلتر به اندازهٔ N عنصر. در اینجا N به عنوان آرگومان یا به صورت یک پیشوند عددی مانند \fIcount\fR در vim ارسال می‌شود؛ پیش‌فرض ۱ است، یعنی انتقال بالاترین عنصر به پایین پشته. .IP "clear" 2 .IX Item "clear" پاک کردن پشتهٔ فیلتر. .IP "show" 2 .IX Item "show" نمایش وضعیت فعلی پشتهٔ فیلتر. .RE .RS 2 .RE .IP "find \fIpattern\fR" 2 .IX Item "find pattern" جستجوی هم‌زمان با تایپ در فایل‌های دایرکتوری فعلی که نام آن‌ها حاوی رشتهٔ داده‌شده (بدون حساسیت به حروف بزرگ و کوچک) باشد. به محض اینکه یک نتیجهٔ بدون ابهام حاصل شود، بلافاصله اجرا خواهد شد. (یا اگر یک دایرکتوری باشد، وارد آن می‌شود.) .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمام گزینه‌های آن پشتیبانی می‌کند. .IP "flat level" 2 .IX Item "flat level" مسطح (تخت) کردن نمای دایرکتوری تا سطح مشخص‌شده. سطح \-1 به معنای سطح نامحدود است. سطح 0 به معنای نمای استاندارد بدون نمای دایرکتوری مسطح‌شده است. مقادیر سطح \-2 و کمتر نامعتبر هستند. .IP "grep \fIpattern\fR" 2 .IX Item "grep pattern" جستجوی یک رشته در تمام فایل‌ها یا دایرکتوری‌های نشانه‌گذاری‌شده. .IP "help" 2 .IX Item "help" روشی سریع برای مشاهدهٔ مستندات ranger فراهم می‌کند. .IP "jump_non [\-\fIflags\fR...]" 2 .IX Item "jump_non [-flags...]" در صورتی که فایل برجسته‌شده یک دایرکتوری باشد، به نخستین غیر دایرکتوری پرش می‌کند و برعکس. .Sp پرچم‌ها: \-r پرش در جهت معکوس \-w چرخش به ابتدای فهرست در صورت رسیدن به انتهای فهرست فایل‌ها .IP "linemode \fIlinemodename\fR" 2 .IX Item "linemode linemodename" حالت خطی (linemode) تمام فایل‌های موجود در دایرکتوری فعلی را تنظیم می‌کند. حالت خطی می‌تواند یکی از موارد زیر باشد: .Sp .Vb 10 \& "filename": \& نمایش هر خط به صورت "..." \& "fileinfo": \& نمایش هر خط به صورت "..." \& "mtime": \& نمایش هر خط به صورت "..." در قالب ISO \& "humanreadablemtime": \& نمایش هر خط به صورت "..." در قالبی انسان‌خوانا، \& هرچه جدیدتر باشد دقیق‌تر است. \& "sizemtime": \& نمایش هر خط به صورت "... " در قالب ISO \& "humanreadablesizemtime": \& نمایش هر خط به صورت "... " در قالبی \& انسان‌خوانا، هرچه جدیدتر باشد دقیق‌تر است. \& "permissions": \& نمایش هر خط به صورت " " \& "metatitle": \& نمایش متادیتا از فایل‌های .metadata.json در صورت وجود، بازگشت \& به حالت خطی "filename" در صورتی که هیچ متادیتایی یافت نشود. \& دستور :meta را ببینید. .Ve .Sp حالت‌های خطی سفارشی را می‌توان با ایجاد زیرکلاس از کلاس \fILinemodeBase\fR افزود. برای دیدن چند مثال، ماژول \fIranger.core.linemode\fR را ببینید. .IP "load_copy_buffer" 2 .IX Item "load_copy_buffer" بارگذاری بافر رونوشت از \fI~/.config/ranger/copy_buffer\fR. این دستور می‌تواند برای انتقال فهرست فایل‌های رونوشت‌شده به یک نمونهٔ دیگر از ranger به کار رود. .IP "map \fIkey\fR \fIcommand\fR" 2 .IX Item "map key command" .PD 0 .IP "cmap \fIkey\fR \fIcommand\fR" 2 .IX Item "cmap key command" .IP "pmap \fIkey\fR \fIcommand\fR" 2 .IX Item "pmap key command" .IP "tmap \fIkey\fR \fIcommand\fR" 2 .IX Item "tmap key command" .PD اختصاص ترکیب کلید به دستور داده‌شده. هر زمان که کلید/کلیدها را بفشارید، دستور اجرا خواهد شد. علاوه بر این، اگر هنگام تایپ کلید از یک شمارنده استفاده کنید، مانند 5j، این مقدار به عنوان صفت \*(L"self.quantifier\*(R" به دستور ارسال می‌شود. .Sp کلیدهایی که با این دستور مقید (bind) می‌کنید، تنها در مرورگر فایل در دسترس هستند، نه در کنسول، pager یا taskview. برای مقید کردن کلیدها در آن بخش‌ها، از دستورهای \*(L"cmap\*(R"، \*(L"pmap\*(R" یا \*(L"tmap\*(R" استفاده کنید. .IP "mark \fIpattern\fR" 2 .IX Item "mark pattern" نشانه‌گذاری تمام فایل‌هایی که با الگوی عبارت باقاعده مطابقت دارند. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمام گزینه‌های آن پشتیبانی می‌کند. .IP "mark_tag [\fItags\fR]" 2 .IX Item "mark_tag [tags]" نشانه‌گذاری تمام فایل‌هایی که با هر یک از تگ‌های داده‌شده برچسب‌گذاری شده‌اند. هنگام حذف آرگومان تگ، تمام فایل‌های برچسب‌دار نشانه‌گذاری می‌شوند. .IP "meta \fIkey\fR \fIvalue\fR" 2 .IX Item "meta key value" تنظیم متادیتای فایل برجسته‌شدهٔ فعلی. مثال: .Sp .Vb 2 \& :meta title The Hitchhiker\*(Aqs Guide to the Galaxy \& :meta year 1979 .Ve .Sp این متادیتا را می‌توان به عنوان مثال، با استفاده از حالت خطی \*(L"metatitle\*(R" از طریق فشردن Mt نمایش داد. .IP "mkdir \fIdirname\fR" 2 .IX Item "mkdir dirname" ایجاد یک دایرکتوری با نام \fIdirname\fR. .IP "open_with [\fIapplication\fR] [\fIflags\fR] [\fImode\fR]" 2 .IX Item "open_with [application] [flags] [mode]" باز کردن فایل‌های انتخاب‌شده با برنامهٔ داده‌شده، مگر اینکه این آرگومان حذف شود که در این صورت از برنامهٔ پیش‌فرض استفاده می‌شود. \fIflags\fR نحوهٔ اجرای برنامه را تغییر می‌دهند و در بخش مربوط به خود در این صفحهٔ راهنما توضیح داده شده‌اند. \fImode\fR عددی است که مشخص می‌کند از کدام برنامه استفاده شود. فهرست برنامه‌ها توسط بازکنندهٔ فایل خارجی \*(L"rifle\*(R" تولید می‌شود و هنگام فشردن \*(L"r\*(R" در ranger قابل نمایش است. .Sp توجه داشته باشید که در صورت مشخص کردن یک برنامه، حالت (mode) نادیده گرفته می‌شود..IP "prompt_metadata [\fIkeys ...\fR]" 2 .IX Item "prompt_metadata [keys ...]" از کاربر درخواست می‌کند تا برای چندین کلید به‌طور پیاپی، فراداده‌ها را با دستور \f(CW\*(C`meta\*(C'\fR وارد کند. .IP "quit" 2 .IX Item "quit" اگر تنها یک زبانه وجود داشته باشد، زبانهٔ جاری را می‌بندد؛ در غیر این صورت، اگر هیچ وظیفه‌ای در حال اجرا نباشد، خارج می‌شود. دایرکتوری جاری به عنوان ' نشانه‌گذاری خواهد شد تا بتوانید دفعهٔ بعد که ranger را اجرا کردید، با فشردن `` یا '' مجدداً وارد آن شوید. .IP "quit!" 2 .IX Item "quit!" مشابه \f(CW\*(C`quit\*(C'\fR است، با این تفاوت که حتی در صورت در حال اجرا بودن وظایف، خروج را اجباری می‌کند. .IP "quitall" 2 .IX Item "quitall" مشابه \f(CW\*(C`quit\*(C'\fR است، با این تفاوت که حتی در صورت باز بودن چندین زبانه نیز خارج می‌شود. .IP "quitall!" 2 .IX Item "quitall!" مشابه \f(CW\*(C`quitall\*(C'\fR است، با این تفاوت که حتی اگر وظایفی در حال اجرا باشند، خروج اجباری انجام می‌دهد. .IP "relink \fInewpath\fR" 2 .IX Item "relink newpath" مقصد پیوندِ فایل پیوند نمادین (symlink) جاری را به تغییر می‌دهد. فشردن نخستین کلید ، پیوند اولیه را بارگذاری می‌کند. .IP "rename \fInewname\fR" 2 .IX Item "rename newname" نام فایل جاری را تغییر می‌دهد. اگر فایلی با همان نام از پیش وجود داشته باشد، تغییر نام شکست خواهد خورد. همچنین کلید میانبر A را برای افزودن چیزی به انتهای نام فایل امتحان کنید. .IP "rename_append [\-\fIflags\fR...]" 2 .IX Item "rename_append [-flags...]" کنسول را با عبارت \*(L":rename \*(R" باز می‌کند، در حالی که مکان‌نما قبل از پسوند فایل قرار دارد. .Sp پرچم‌ها: \-a قرارگیری مکان‌نما پیش از تمامی پسوندها \-r حذف هر آنچه قبل از پسوندها قرار دارد .IP "save_copy_buffer" 2 .IX Item "save_copy_buffer" بافر رونوشت را در \fI~/.config/ranger/copy_buffer\fR ذخیره می‌کند. از این دستور می‌توان برای انتقال فهرست فایل‌های کپی‌شده به نمونه‌ای دیگر از ranger استفاده کرد. .IP "scout [\-\fIflags\fR...] [\-\-] \fIpattern\fR" 2 .IX Item "scout [-flags...] [--] pattern" دستوری همه‌کاره برای جستجو، جابه‌جایی و فیلتر کردن فایل‌ها. .Sp پرچم‌ها: \-a باز کردن خودکار فایل در صورت تطابق قطعی و غیرمبهم \-e باز کردن فایل انتخاب‌شده هنگام فشردن enter \-f فیلتر کردن فایل‌هایی که با الگوی جستجوی فعلی تطابق دارند \-g تفسیر الگو به عنوان الگوی glob \-i نادیده گرفتن بزرگی و کوچکی حروف در فایل‌ها \-k باز نگه داشتن کنسول هنگام تغییر دایرکتوری با این دستور \-l پرش از روی حروف؛ مثلاً تطابق \*(L"rdme\*(R" با فایل \*(L"readme\*(R" \-m علامت‌گذاری فایل‌های منطبق پس از فشردن enter \-M برداشتن علامت فایل‌های منطبق پس از فشردن enter \-p فیلتر دائمی: پنهان کردن فایل‌های نامنطبق پس از فشردن enter \-r تفسیر الگو به عنوان یک عبارت باقاعده (regular expression) \-s حساسیت هوشمند به حروف؛ مانند \-i رفتار می‌کند مگر اینکه الگو حاوی حروف بزرگ باشد \-t اعمال فیلتر و الگوی جستجو هم‌زمان با تایپ کردن \-v معکوس کردن نتیجهٔ تطابق .Sp می‌توان چندین پرچم را ترکیب کرد. برای نمونه، \*(L":scout \-gpt\*(R" دستوری مشابه :filter با استفاده از globbing ایجاد می‌کند. .IP "search \fIpattern\fR" 2 .IX Item "search pattern" جستجوی فایل‌ها در دایرکتوری جاری که با الگوی عبارت باقاعدهٔ داده‌شده (بدون حساسیت به بزرگی و کوچکی حروف) تطابق دارند. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمامی گزینه‌های آن پشتیبانی می‌کند. .IP "search_inc \fIpattern\fR" 2 .IX Item "search_inc pattern" جستجوی فایل‌ها در دایرکتوری جاری که با الگوی عبارت باقاعدهٔ داده‌شده (بدون حساسیت به بزرگی و کوچکی حروف) تطابق دارند. این دستور هم‌زمان با تایپ کردن، شما را به فایل‌های منطبق هدایت می‌کند. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمامی گزینه‌های آن پشتیبانی می‌کند. .IP "set \fIoption\fR \fIvalue\fR" 2 .IX Item "set option value" مقدار جدیدی را به یک گزینه اختصاص می‌دهد. گزینه‌های معتبر در بخش تنظیمات فهرست شده‌اند. برای دریافت مقدار فعلی یک گزینه از تکمیل با کلید tab استفاده کنید، اگرچه این قابلیت برای توابع و عبارت‌های باقاعده کار نمی‌کند. مقادیر معتبر عبارتند از: .Sp .Vb 7 \& setting type | example values \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& bool | true, false \& integer | 1, 23, 1337 \& string | foo, hello world \& list | 1,2,3,4 \& none | none .Ve .IP "setintag \fItags\fR \fIoption\fR \fIvalue\fR" 2 .IX Item "setintag tags option value" مقدار جدیدی را به یک گزینه اختصاص می‌دهد، اما به‌صورت محلی برای دایرکتوری‌هایی که با \fItag\fR علامت‌گذاری شده‌اند. این بدان معناست که این گزینه تنها هنگام مشاهدهٔ آن دایرکتوری اعمال می‌شود. .Sp به عنوان مثال، برای تغییر ترتیب مرتب‌سازی در دایرکتوری بارگیری‌های خود، با فشردن \fI"v\fR آن را با برچسب \fIv\fR علامت‌گذاری کنید، سپس از این دستور استفاده نمایید: .Sp .Vb 1 \& setintag v sort ctime .Ve .IP "setlocal [path=\fIpath\fR] \fIoption\fR \fIvalue\fR" 2 .IX Item "setlocal [path=path] option value" مقدار جدیدی را به یک گزینه اختصاص می‌دهد، اما به‌صورت محلی برای دایرکتوری مشخص‌شده توسط \&\fIpath\fR. این بدان معناست که این گزینه تنها هنگام بازدید از آن دایرکتوری اعمال می‌شود. اگر مسیری مشخص نشود، از دایرکتوری جاری استفاده خواهد شد. .Sp \&\fIpath\fR یک عبارت باقاعده است. این بدان معناست که \f(CW\*(C`path=~/dl\*(C'\fR برای تمامی مسیرهایی که با \fI~/dl\fR شروع می‌شوند اعمال می‌شود، مانند \fI~/dl2\fR و \fI~/dl/foo\fR. برای جلوگیری از این حالت، از \f(CW\*(C`path=~/dl$\*(C'\fR استفاده کنید. .Sp برای جلوگیری از تفکیک ناخواسته، می‌توان \&\fIpath\fR را درون کوتیشن تکی یا دوتایی قرار داد: \fIpath='~/dl dl$'\fR یا \fIpath=\*(L"~/dl dl$\*(R"\fR .IP "shell [\-\fIflags\fR] \fIcommand\fR" 2 .IX Item "shell [-flags] command" یک دستور شل را اجرا می‌کند. \fIflags\fR در بخش مربوط به خود بررسی شده‌اند. .IP "source \fIfilename\fR" 2 .IX Item "source filename" دستورها را از یک فایل می‌خواند و آن‌ها را در کنسول ranger اجرا می‌کند. .Sp این دستور می‌تواند برای ارزیابی مجدد فایل rc.conf پس از تغییر آن به کار رود: .Sp .Vb 2 \& map X chain shell vim \-p %confdir/rc.conf %rangerdir/config/rc.conf; \e \& source %confdir/rc.conf .Ve .IP "scroll_preview \fIvalue\fR" 2 .IX Item "scroll_preview value" پیش‌نمایش فایل را به میزان \fIvalue\fR خط پیمایش می‌کند. .IP "terminal" 2 .IX Item "terminal" برنامهٔ \fIx\-terminal-emulator\fR را با شروع از دایرکتوری جاری اجرا می‌کند. .IP "touch \fIfilename\fR" 2 .IX Item "touch filename" یک فایل خالی با نام \fIfilename\fR ایجاد می‌کند، مگر اینکه از قبل وجود داشته باشد. .IP "trash" 2 .IX Item "trash" تمام فایل‌های انتخاب‌شده را با استفاده از rifle به سطل زباله منتقل می‌کند. در صورت در دسترس بودن، rifle سعی می‌کند از یک مدیر سطل زباله مانند \fItrash-cli\fR استفاده کند، اما در غیر این صورت به انتقال فایل‌ها به \fI\f(CI$XDG_DATA_HOME\fI/ranger\-trash\fR یا \fI~/.ranger/ranger\-trash\fR بازمی‌گردد. این نسخهٔ موقت‌تری نسبت به \fIdelete\fR است که خالی کردن سطل زباله را به زمان مناسب برای کاربر واگذار می‌کند، در حالی که امکان بازیابی فایل‌های حذف‌شده تا پیش از آن وجود دارد. اگر قصد انتقال چندین فایل (علامت‌گذاری‌شده) یا دایرکتوری‌های غیرخالی به سطل زباله را داشته باشید، ranger تأییدیه خواهد خواست. این رفتار را می‌توان با تغییر تنظیم \*(L"confirm_on_delete\*(R" اصلاح کرد. .IP "travel \fIpattern\fR" 2 .IX Item "travel pattern" دایرکتوری جاری را برای فایل‌هایی که شامل حروف موجود در رشته هستند فیلتر می‌کند، حتی اگر حروف دیگری بین آن‌ها قرار گرفته باشد. فیلتر هم‌زمان با تایپ اعمال می‌شود. هنگامی که تنها یک دایرکتوری باقی بماند، وارد آن شده و کنسول به‌طور خودکار مجدداً باز می‌شود که امکان جابه‌جایی سریع را فراهم می‌سازد. برای بستن کنسول، \s-1ESC\s0 را فشار دهید یا فایلی را اجرا کنید. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمامی گزینه‌های آن پشتیبانی می‌کند. .IP "unmap [\fIkeys\fR ...]" 2 .IX Item "unmap [keys ...]" .PD 0 .IP "cunmap [\fIkeys\fR ...]" 2 .IX Item "cunmap [keys ...]" .IP "punmap [\fIkeys\fR ...]" 2 .IX Item "punmap [keys ...]" .IP "tunmap [\fIkeys\fR ...]" 2 .IX Item "tunmap [keys ...]" .PD نگاشت‌های کلید مشخص‌شده را در بستر \*(L"browser\*(R" حذف می‌کند. برای لغو نگاشت کلیدها در کنسول، pager یا taskview از \*(L"cunmap\*(R"، \*(L"punmap\*(R" یا \*(L"tunmap\*(R" استفاده کنید. .IP "unmark \fIpattern\fR" 2 .IX Item "unmark pattern" علامت‌گذاری تمامی فایل‌های منطبق با یک الگوی عبارت باقاعده را برمی‌دارد. .Sp این دستور بر پایهٔ دستور \fIscout\fR است و از تمامی گزینه‌های آن پشتیبانی می‌کند. .IP "unmark_tag [\fItags\fR]" 2 .IX Item "unmark_tag [tags]" علامت‌گذاری تمامی برچسب‌هایی را که با هر یک از برچسب‌های داده‌شده نشانه‌گذاری شده‌اند برمی‌دارد. در صورت حذف آرگومان برچسب، علامت تمامی فایل‌های برچسب‌دار برداشته می‌شود..SH "فایل‌ها (FILES)" .IX Header "FILES" ranger چندین فایل پیکربندی را می‌خواند که در \&\fI\f(CI$HOME\fI/.config/ranger\fR یا در صورت تعریف شدن \f(CW$XDG_CONFIG_HOME\fR، در \fI\f(CI$XDG_CONFIG_HOME\fI/ranger\fR قرار دارند. می‌توانید از گزینهٔ \-\-copy\-config برای به‌دست آوردن فایل‌های پیکربندی پیش‌فرض استفاده کنید. این فایل‌ها شامل توضیحات و مستندات بیشتری هستند. .PP نیازی نیست فایل‌های \fIrc.conf\fR، \fIcommands.py\fR و \fIcolorschemes\fR به‌طور کامل کپی شوند؛ چرا که این فایل‌ها تنها به فایل‌های پیکربندی پیش‌فرض افزوده می‌شوند، مگر اینکه صراحتاً بازنویسی شوند. این ممکن است به وضعیت‌های گیج‌کننده‌ای منجر شود، برای نمونه زمانی که یک کلید با وجود حذف شدن خط مربوطه از نسخهٔ فایل پیکربندی کاربر، همچنان مقید باقی مانده باشد. این رفتار را می‌توان با یک متغیر محیطی غیرفعال کرد (همچنین ببینید: \fB\s-1ENVIRONMENT\s0\fR). نکته: تمامی دیگر فایل‌های پیکربندی تنها از یک منبع خوانده می‌شوند؛ یعنی پیش‌فرض \s-1یا\s0 کاربر، نه هر دو. اگر \fIrc.conf\fR و \fIcommands.py\fR در \fI/etc/ranger\fR برای پیکربندی سراسری سیستم وجود داشته باشند، از آنجا نیز خوانده می‌شوند؛ پیکربندی کاربر بر پیکربندی سیستم اولویت دارد که آن نیز بر پیکربندی پیش‌فرض اولویت دارد. .PP هنگام اجرای ranger با گزینهٔ \fB\-\-clean\fR، برنامه به هیچ‌یک از این فایل‌ها دسترسی پیدا نکرده یا آن‌ها را ایجاد نخواهد کرد. .SS "پیکربندی (CONFIGURATION)" .IX Subsection "CONFIGURATION" .IP "rc.conf" 10 .IX Item "rc.conf" شامل فهرستی از دستورهایی است که هنگام راه‌اندازی اجرا می‌شوند. بیشتر کلیدهای میان‌بر و تنظیمات در اینجا تعریف می‌شوند. .IP "commands.py" 10 .IX Item "commands.py" یک ماژول python که دستورهایی را تعریف می‌کند که می‌توان با فشردن \*(L":\*(R" در کنسول ranger یا در فایل rc.conf از آن‌ها استفاده کرد. توجه داشته باشید که می‌توانید به همین شیوه درون افزونه‌ها نیز دستورها را تعریف کنید. .IP "commands_full.py" 10 .IX Item "commands_full.py" این فایل با دستور \-\-copy\-config=commands_full کپی می‌شود و به عنوان مرجعی برای دستورهای سفارشی عمل می‌کند. این فایل کاملاً توسط ranger نادیده گرفته می‌شود. .IP "rifle.conf" 10 .IX Item "rifle.conf" فایل پیکربندی برای اجراکنندهٔ پیش‌ساختهٔ فایل موسوم به \*(L"rifle\*(R" است. .IP "scope.sh" 10 .IX Item "scope.sh" اسکریپتی است که پیش‌نمایش فایل‌ها را مدیریت می‌کند. هنگامی که گزینه‌های \&\fIuse_preview_script\fR و \fIpreview_files\fR تنظیم شده باشند، برنامهٔ مشخص‌شده در گزینهٔ \fIpreview_script\fR اجرا می‌شود و خروجی یا وضعیت خروج آن واکنش ranger را تعیین می‌کند. .IP "colorschemes/" 10 .IX Item "colorschemes/" طرح‌های رنگی را می‌توان در اینجا قرار داد. .IP "plugins/" 10 .IX Item "plugins/" افزونه‌ها را می‌توان در اینجا قرار داد. .SS "ذخیره‌سازی (STORAGE)" .IX Subsection "STORAGE" .IP "bookmarks" 10 .IX Item "bookmarks" این فایل شامل فهرستی از نشانک‌ها است. نحو آن به صورت /^(.):(.*)$/ است. نویسهٔ نخست کلید نشانک و باقی پس از دونقطه، مسیر فایل است. در ranger، نشانک‌ها را می‌توان با تایپ m تنظیم کرد، با تایپ \&' به آن‌ها دسترسی یافت و با تایپ um آن‌ها را حذف کرد. .IP "copy_buffer" 10 .IX Item "copy_buffer" هنگام اجرای دستور :save_copy_buffer، مسیرهای تمامی فایل‌های کپی‌شدهٔ کنونی در این فایل ذخیره می‌شوند. بعداً می‌توانید :load_copy_buffer را اجرا کنید تا همان فایل‌ها دوباره کپی شوند، به یک نمونهٔ دیگر ranger منتقل شوند، یا در یک اسکریپت پردازش گردند. .IP "history" 10 .IX Item "history" شامل فهرستی از دستورهایی است که پیش‌تر وارد شده‌اند. .IP "tagged" 10 .IX Item "tagged" شامل فهرستی از فایل‌های نشان‌دار (برچسب‌خورده) است. نحو آن به صورت /^(.:)?(.*)$/ است که نویسهٔ اول نام اختیاری برچسب و باقی پس از دونقطهٔ اختیاری، مسیر فایل است. در ranger، برچسب‌ها را می‌توان با فشردن t تنظیم کرد و با T حذف نمود. برای انتساب یک برچسب نام‌دار، عبارت " را تایپ کنید. .SH "محیط (ENVIRONMENT)" .IX Header "ENVIRONMENT" این متغیرهای محیطی بر روی ranger تأثیر می‌گذارند: .IP "\s-1RANGER_LEVEL\s0" 8 .IX Item "RANGER_LEVEL" برنامهٔ ranger این متغیر محیطی را به \*(L"1\*(R" مقداردهی می‌کند یا در صورت وجود، مقدار آن را افزایش می‌دهد. برنامه‌های خارجی می‌توانند با بررسی این متغیر بررسی کنند که آیا از ranger اجرا شده‌اند یا خیر. .IP "\s-1RANGER_LOAD_DEFAULT_RC\s0" 8 .IX Item "RANGER_LOAD_DEFAULT_RC" اگر این متغیر برابر با \s-1FALSE\s0 تنظیم شده باشد، ranger فایل rc.conf پیش‌فرض را بارگذاری نخواهد کرد. اگر تمام rc.conf را در \fI~/.config/ranger/\fR کپی کرده‌اید و به فایل پیش‌فرض اصلاً نیازی ندارید، این کار می‌تواند در زمان صرفه‌جویی کند. .IP "\s-1VISUAL\s0" 8 .IX Item "VISUAL" ویرایشگری را تعیین می‌کند که برای کلید \*(L"E\*(R" استفاده خواهد شد. در صورت تعریف نشدن یا خالی بودن، به \s-1EDITOR\s0 برمی‌گردد. .IP "\s-1EDITOR\s0" 8 .IX Item "EDITOR" ویرایشگری را تعیین می‌کند که اگر \s-1VISUAL\s0 تعریف نشده یا خالی باشد، برای کلید \*(L"E\*(R" استفاده می‌شود. مقدار پیش‌فرض \*(L"vim\*(R" است. .IP "\s-1SHELL\s0" 8 .IX Item "SHELL" پوسته‌ای را مشخص می‌کند که ranger همراه با دستور :shell و کلید \*(L"S\*(R" از آن استفاده خواهد کرد. پیش‌فرض \*(L"/bin/sh\*(R" است. .IP "\s-1TERMCMD\s0" 8 .IX Item "TERMCMD" دستور شبیه‌ساز ترمینالی را تعیین می‌کند که ranger همراه با دستور :terminal و نشان اجرای \*(L"t\*(R" از آن استفاده خواهد کرد. پیش‌فرض \*(L"xterm\*(R" است. .IP "\s-1BAT_STYLE\s0" 8 .IX Item "BAT_STYLE" تم مورد استفاده برای برجسته‌سازی نحو هنگام نصب بودن \fIbat\fR را مشخص می‌کند، مگر اینکه \fIhighlight\fR نیز نصب شده باشد. با اجرای \f(CW\*(C`bat \-\-list\-themes\*(C'\fR مقادیر ممکن را بیابید. .IP "\s-1PYGMENTIZE_STYLE\s0" 8 .IX Item "PYGMENTIZE_STYLE" تم مورد استفاده برای برجسته‌سازی نحو هنگام نصب بودن \fIpygmentize\fR را مشخص می‌کند، مگر اینکه \fIhighlight\fR نیز نصب شده باشد. مقادیر ممکن را می‌توانید با اجرای دستور زیر بیابید: python \-c 'import pygments.styles; [print(stl) for stl in pygments.styles.\fBget_all_styles()\fR]' .IP "\s-1HIGHLIGHT_STYLE\s0" 8 .IX Item "HIGHLIGHT_STYLE" تم مورد استفاده برای برجسته‌سازی نحو را هنگامی که \fIhighlight\fR نصب باشد، مشخص می‌کند. با اجرای \f(CW\*(C`highlight \-\-list\-themes\*(C'\fR مقادیر ممکن را بیابید. .IP "\s-1HIGHLIGHT_TABWIDTH\s0" 8 .IX Item "HIGHLIGHT_TABWIDTH" تعداد فاصله‌هایی را مشخص می‌کند که برای جایگزینی تب‌ها در فایل‌های پردازش‌شده با \fIhighlight\fR استفاده می‌شود. .IP "\s-1HIGHLIGHT_OPTIONS\s0" 8 .IX Item "HIGHLIGHT_OPTIONS" برنامهٔ \fIhighlight\fR گزینه‌های خط فرمان مشخص‌شده در این متغیر را دریافت خواهد کرد. گزینهٔ \f(CW\*(C`\-\-style=\*(C'\fR مشخص‌شده در اینجا، بر \f(CW\*(C`HIGHLIGHT_STYLE\*(C'\fR اولویت خواهد داشت. به‌طور مشابه، \f(CW\*(C`\-\-replace\-tabs=\*(C'\fR بر \f(CW\*(C`HIGHLIGHT_TABWIDTH\*(C'\fR اولویت دارد. .IP "\s-1OPENSCAD_COLORSCHEME\s0" 8 .IX Item "OPENSCAD_COLORSCHEME" طرح رنگی مورد استفاده توسط \fIopenscad\fR را هنگام پیش‌نمایش مدل‌های سه‌بعدی تعیین می‌کند. برای طرح‌های رنگی، صفحهٔ راهنمای \fIopenscad\fR را مطالعه کنید. پیش‌فرض ranger طرح Tomorrow Night خواهد بود. .IP "\s-1OPENSCAD_IMGSIZE\s0" 8 .IX Item "OPENSCAD_IMGSIZE" وضوح (رزولوشن) داخلی مورد استفادهٔ \fIopenscad\fR را برای رندر مدل‌های سه‌بعدی تعیین می‌کند. تصویر برای قرارگیری در قاب پیش‌نمایش کوچک خواهد شد. در صورت مشخص نشدن، مقدار این وضوح به‌طور پیش‌فرض \*(L"1000,1000\*(R" خواهد بود. .IP "\s-1XDG_CONFIG_HOME\s0" 8 .IX Item "XDG_CONFIG_HOME" دایرکتوری فایل‌های پیکربندی را مشخص می‌کند. پیش‌فرض \fI\f(CI$HOME\fI/.config\fR است. .IP "\s-1PYTHONOPTIMIZE\s0" 8 .IX Item "PYTHONOPTIMIZE" این متغیر سطح بهینه‌سازی python را تعیین می‌کند. .Sp استفاده از PYTHONOPTIMIZE=1 (مانند python \-O) باعث می‌شود python گزاره‌های assert را نادیده بگیرد. با فدا کردن مقداری از اطلاعات اشکال‌زدایی، کارایی بهتری به دست خواهید آورد. .Sp استفاده از PYTHONOPTIMIZE=2 (مانند python \-OO) علاوه بر آن تمامی docstringها را نیز نادیده می‌گیرد. استفاده از این مقدار، کلید را در دستورها غیرفعال می‌کند. .IP "W3MIMGDISPLAY_PATH" 8 .IX Item "W3MIMGDISPLAY_PATH" با تغییر این متغیر می‌توانید مسیر فایل اجرایی پیش‌نمایش تصاویر را تغییر دهید. به‌طور پیش‌فرض، روی \fI/usr/lib/w3m/w3mimgdisplay\fR تنظیم شده است..SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" مثال‌های گوناگونی دربارهٔ چگونگی گسترش ranger با افزونه‌ها یا ترکیب ranger با دیگر برنامه‌ها وجود دارد. این نمونه‌ها را می‌توان در دایرکتوری \&\fI/usr/share/doc/ranger/examples/\fR یا در \fIdoc/ranger/\fR که همراه با کد منبع ارائه می‌شود، یافت. .SH "مجوز (LICENSE)" .IX Header "LICENSE" \&\s-1GNU\s0 General Public License 3 یا (به انتخاب شما) هر نسخهٔ بعدی. .SH "پیوندها (LINKS)" .IX Header "LINKS" .IP "دانلود: " 4 .IX Item "Download: " .PD 0 .IP "صفحهٔ پروژه: " 4 .IX Item "The project page: " .IP "فهرست پستی: " 4 .IX Item "The mailing list: " .IP "کانال \s-1IRC\s0: کانال #ranger در freenode.net" 4 .IX Item "IRC channel: #ranger on freenode.net" .PD .PP توسعه و نگهداری ranger با سیستم کنترل نسخهٔ git انجام می‌شود. برای دریافت یک نسخهٔ تازه، دستور زیر را اجرا کنید: .PP .Vb 1 \& git clone git@github.com:ranger/ranger.git .Ve .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBrifle\fR\|(1) .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" باگ‌ها را در اینجا گزارش کنید: .PP لطفاً تا حد امکان اطلاعات مرتبط را لحاظ کنید. برای دریافت کامل‌ترین خروجی تشخیصی (عیب‌یابی)، ranger را به این صورت اجرا کنید: \f(CW\*(C`PYTHONOPTIMIZE= ranger \-\-debug\*(C'\fR