.TH "Z" "1" "January 2013" "z" "دستورهای کاربر"
.SH "نام (NAME)"
z \- پرش سریع میان پوشه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
z [\-chlrtx] [regex1 regex2 ... regexn]
.SH "در دسترس بودن (AVAILABILITY)"
bash, zsh
.SH "توضیحات (DESCRIPTION)"
پوشه‌های پرکاربرد شما را بر اساس «frecency» (ترکیب فراوانی و تازگی دسترسی) ردیابی می‌کند.
.P
پس از یک مرحله یادگیری کوتاه،
.B z
شما را به مناسب‌ترین پوشه از نظر «frecency» که با تمام عبارات باقاعده (regex) داده‌شده در خط فرمان به ترتیب مطابقت دارد، منتقل می‌کند.
.P
برای نمونه،
.B z foo bar
با
.B /foo/bar
تطبیق می‌یابد اما با
.B /bar/foo
مطابقت نخواهد داشت.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c\fR
محدود کردن تطبیق‌ها به زیرپوشه‌های پوشه جاری
.TP
\fB\-e\fR
چاپ بهترین تطبیق در خروجی بدون اجرای cd
.TP
\fB\-h\fR
نمایش پیام راهنمای کوتاه
.TP
\fB\-l\fR
تنها فهرست کردن موارد
.TP
\fB\-r\fR
تطبیق تنها بر اساس رتبه (rank)
.TP
\fB\-t\fR
تطبیق تنها بر اساس زمان دسترسی اخیر
.TP
\fB\-x\fR
حذف پوشه جاری از فایل داده
.SH "مثال‌ها (EXAMPLES)"
.TP 14
\fBz foo\fR
انتقال به پرکاربردترین پوشه منطبق با foo
.TP 14
\fBz foo bar\fR
انتقال به مناسب‌ترین پوشه منطبق با foo و سپس bar
.TP 14
\fBz \-r foo\fR
انتقال به بالاترین رتبه پوشه منطبق با foo
.TP 14
\fBz \-t foo\fR
انتقال به تازه‌ترین پوشه مورد دسترسی منطبق با foo
.TP 14
\fBz \-l foo\fR
فهرست کردن تمام پوشه‌های منطبق با foo (بر اساس frecency)
.SH "نکات (NOTES)"
.SS "نصب (Installation)"
دستوری مانند این را در
.B $HOME/.bashrc
یا
.B $HOME/.zshrc
خود قرار دهید:
.RS
.P
\fB. /usr/share/z/z.sh\fR
.RE
.P
مدتی با دستور
.B cd
میان پوشه‌ها جابه‌جا شوید تا پایگاه‌داده ساخته شود.
.P
اکنون آماده استفاده است!
.P
به‌صورت اختیاری:
.RS
تنظیم \fB$_Z_CMD\fR برای تغییر نام دستور (پیش‌فرض \fBz\fR).
.RE
.RS
تنظیم \fB$_Z_DATA\fR برای تغییر فایل داده (پیش‌فرض \fB$HOME/.z\fR).
.RE
.RS
تنظیم مقدار کمتر برای \fB$_Z_MAX_SCORE\fR جهت کهنه‌شدن و حذف سریع‌تر ورودی‌ها (پیش‌فرض \fB9000\fR).
.RE
.RS
تنظیم \fB$_Z_NO_RESOLVE_SYMLINKS\fR برای جلوگیری از حل پیوندهای نمادین.
.RE
.RS
تنظیم \fB$_Z_NO_PROMPT_COMMAND\fR برای مدیریت دستی \fBPROMPT_COMMAND/precmd\fR توسط خودتان.
.RE
.RS
تنظیم \fB$_Z_EXCLUDE_DIRS\fR به آرایه‌ای از درخت‌های دایرکتوری جهت استثنا کردن از ردیابی.
.RE
.RS
تنظیم \fB$_Z_OWNER\fR برای مجاز ساختن استفاده در حالت 'sudo -s'.
.RE
.RS
(این تنظیمات باید پیش از خط اضافه شده در بالا، درون .bashrc/.zshrc قرار گیرند.)
.RE
.RS
نصب صفحه راهنمای ارائه‌شده (\fBz.1\fR) در محلی درون \fB$MANPATH\fR شما، مانند
\fB/usr/local/man/man1\fR.
.RE
.SS "کهنه‌شدن ورودی‌ها (Aging)"
رتبه پوشه‌های نگهداری‌شده توسط
.B z
بر اساس یک فرمول ساده دچار کهنگی و کاهش تدریجی می‌شود. رتبه هر ورودی با هر بار دسترسی افزایش می‌یابد. هنگامی که مجموع رتبه‌ها از ۹۰۰۰ بیشتر شود، تمام رتبه‌ها در ۰٫۹۹ ضرب می‌شوند. ورودی‌های دارای رتبه کمتر از ۱ فراموش می‌شوند.
.SS "معیار فریسنسی (Frecency)"
واژه Frecency ترکیبی از دو کلمه 'recent' (تازگی) و 'frequency' (تکرار و فراوانی) است. این معیار، رتبه‌ای وزندار است که به میزان تکرار و تازگی رخداد یک رویداد بستگی دارد. تا آنجا که مشخص است، موزیلا (Mozilla) این اصطلاح را ابداع کرده است.
.P
از دید
.BR z ,
پوشه‌ای که رتبه پایینی دارد اما اخیراً مورد دسترسی قرار گرفته، به‌سرعت رتبه بالاتری نسبت به پوشه‌ای که مدت‌ها پیش به دفعات زیاد استفاده شده به دست خواهد آورد.
.P
معیار Frecency در زمان اجرا تعیین می‌شود.
.SS "پیشوند مشترک (Common)"
هنگامی که چندین پوشه با تمام عبارت‌های جستجو تطابق داشته باشند و همگی دارای پیشوند مشترک باشند،
.B z
بدون توجه به اولویت، به کوتاه‌ترین پوشه منطبق تغییر مسیر می‌دهد. این رفتار مدت‌هاست که وجود داشته (هرچند مستند نشده بود)، اما احتمالاً باید قابل پیکربندی باشد یا مورد بازنگری قرار گیرد.
.SS "تکمیل با کلید تب (Tab Completion)"
دستور
.B z
از تکمیل خودکار با کلید Tab پشتیبانی می‌کند. پس از وارد کردن هر تعداد آرگومان، با فشردن کلید TAB می‌توانید نام پوشه‌هایی را که با هر آرگومان مطابقت دارند تکمیل کنید. به دلیل محدودیت‌های پیاده‌سازی تکمیل خودکار، تنها آخرین آرگومان در شل تکمیل خواهد شد.
.P
درون برنامه،
.B z
زمانی تشخیص می‌دهد که شما درخواست تکمیل خودکار داده‌اید که آخرین آرگومان ارسال‌شده، یک مسیر مطلق به یک پوشه موجود باشد. این امر ممکن است در صورتی که آخرین آرگومان ورودی
.B z
با
.B /
شروع شود، رفتاری غیرمنتظره ایجاد کند.
.SH "متغیرهای محیطی (ENVIRONMENT)"
تابع
.B _z()
تعریف شده است.
.P
محتوای متغیر
.B $_Z_CMD
به
.B _z 2>&1
نام مستعار (alias) داده شده است. در صورت تنظیم نشدن،
.B $_Z_CMD
به‌طور پیش‌فرض برابر با
.B z
خواهد بود.
.P
متغیر محیطی
.B $_Z_DATA
می‌تواند برای کنترل مکان فایل داده استفاده شود. اگر تعریف نشده باشد، مکان پیش‌فرض آن
.B $HOME/.z
است.
.P
متغیر محیطی
.B $_Z_NO_RESOLVE_SYMLINKS
می‌تواند برای جلوگیری از حل پیوندهای نمادین تنظیم شود. در صورت عدم تنظیم، پیوندهای نمادین هنگام اضافه شدن به فایل داده حل خواهند شد.
.P
در bash، دستور
.B z
فرمانی را به متغیر محیطی
.B PROMPT_COMMAND
اضافه می‌کند تا پایگاه‌داده خود را نگهداری کند. در zsh،
.B z
تابع
.B _z_precmd
را به آرایه
.B precmd_functions
می‌افزاید.
.P
متغیر محیطی
.B $_Z_NO_PROMPT_COMMAND
می‌تواند در صورتی که بخواهید خودتان
.B PROMPT_COMMAND
یا
.B precmd
را مدیریت کنید، تنظیم شود.
.P
متغیر محیطی
.B $_Z_EXCLUDE_DIRS
می‌تواند به آرایه‌ای از درخت‌های دایرکتوری تنظیم شود تا از ردیابی مستثنی گردند.
.B $HOME
همیشه مستثنی است. پوشه‌ها باید مسیرهای کامل و بدون اسلش پایانی باشند.
.P
متغیر محیطی
.B $_Z_OWNER
می‌تواند روی نام کاربری شما تنظیم شود تا استفاده از
.B z
را هنگامی که محیط sudo متغیر
.B $HOME
شما را حفظ می‌کند، امکان‌پذیر سازد.
.SH "فایل‌ها (FILES)"
داده‌ها در
.B $HOME/.z
ذخیره می‌شوند. این مسیر می‌تواند با تنظیم متغیر محیطی
.B $_Z_DATA
تغییر یابد. هنگام مقداردهی اولیه، اگر این مسیر یک پوشه باشد،
.B z
خطا ایجاد کرده و به‌درستی کار نخواهد کرد.
.P
یک صفحه راهنما (\fBz.1\fR) ارائه شده است.
.SH "همچنین ببینید (SEE ALSO)"
regex(7), pushd, popd, autojump, cdargs
.P
لطفاً گزارش باگ‌ها را در نشانی https://github.com/rupa/z ثبت کنید