فهرست سریع فصل‌ها
مبتدیفصل 3 از 20⏱ حدود 9 دقیقه

🖥️شروع کار با Yazi و شبیه‌ساز تعاملی

سه ستون، هدر، نوار وضعیت، منوی راهنما و wrapper معروف y.

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

آناتومی صفحه

HEADER — کاربر@هاست، مسیر فعلی، نوار تب‌ها
PARENT
پوشه‌ی والد
CURRENT
محتویات پوشه‌ی فعلی + مکان‌نما
PREVIEW
پیش‌نمایش فایل یا پوشه‌ی زیر مکان‌نما
STATUS BAR — حالت، مجوزها، حجم، شماره‌ی ردیف، پیشرفت وظایف
  • هدر: بالا سمت چپ مسیر جاری رو نشون می‌ده (پوشه‌ی فعلی پررنگ‌تره). سمت راستش هم شماره‌ی تب‌های بازه.
  • ستون والد: بهت می‌گه الان کجای درخت پوشه‌ها ایستادی. خیلی کمک می‌کنه که گم نشی.
  • ستون فعلی: قلب ماجرا. مکان‌نمای هایلایت‌شده اینجاست و هر عملیاتی روی همین فایل «hovered» انجام می‌شه (مگه اینکه چیزی انتخاب کرده باشی).
  • ستون پیش‌نمایش: اگه روی پوشه باشی، محتویاتش رو نشون می‌ده؛ اگه روی متن باشی، با هایلایت سینتکس؛ عکس، ویدیو و PDF هم واقعاً رندر می‌شن.
  • نوار وضعیت: سمت چپ حالت فعلی (NORMAL / SELECT / UNSET)، مجوزهای فایل و مالکش؛ سمت راست حجم و موقعیت مکان‌نما و درصد پیشرفت وظایف پس‌زمینه.

اولین کلیدهایی که باید بلد باشی

کلیدکاربرد
F1باز کردن منوی راهنما — لیست زنده‌ی همه‌ی کلیدهاکلید ~ هم همین کار رو می‌کنه
qخروج از یازی
Qخروج بدون تغییر دادن مسیر شل (وقتی wrapper نصب داری)
Ctrl⇒cبستن تب فعلی (اگه آخرین تب باشه، خروج)
Escلغو کردن هر چیزی: فیلتر، جست‌وجو، انتخاب، حالت ویژوال
💡F1 بهترین رفیقته
منوی راهنمای یازی از روی کانفیگ واقعی خودت ساخته می‌شه. یعنی اگه کلیدی رو عوض کردی، توی F1 هم عوض شده می‌بینی. توی منوی راهنما می‌تونی تایپ کنی تا فیلتر بشه.

Wrapper معروف y — این رو حتماً نصب کن

یه مشکل کلاسیک: توی یازی می‌ری داخل یه پوشه‌ی عمیق، بعد q می‌زنی و… می‌بینی شل هنوز توی همون پوشه‌ی قبلیه. چرا؟ چون یه پروسه‌ی بچه نمی‌تونه دایرکتوری پدرش رو عوض کنه. راه‌حل رسمی یازی یه تابع شله:

~/.bashrc
bash

function y() {
	local tmp cwd; tmp="$(mktemp -t "yazi-cwd.XXXXXX")"
	command yazi "$@" --cwd-file="$tmp"
	IFS= read -r -d '' cwd < "$tmp"
	[ "$cwd" != "$PWD" ] && [ -d "$cwd" ] && builtin cd -- "$cwd" || builtin true
	command rm -f -- "$tmp"
}

این تیکه رو ته ~/.bashrc بچسبون (فدورا پیش‌فرض bash داره)، بعد source ~/.bashrc بزن. از این به بعد به‌جای yazi بنویس y. حالا q یعنی «خروج و همون‌جا بمون» و Q یعنی «خروج، ولی مسیر شل رو دست نزن».

اگه zsh یا fish کاربری

~/.config/fish/functions/y.fish
fish

function y
	set tmp (mktemp -t "yazi-cwd.XXXXXX")
	command yazi $argv --cwd-file="$tmp"
	if read -z cwd < "$tmp"; and [ "$cwd" != "$PWD" ]; and test -d "$cwd"
		builtin cd -- "$cwd"
	end
	command rm -f -- "$tmp"
end

برای zsh دقیقاً همون تابع bash کار می‌کنه؛ فقط بذارش توی ~/.zshrc.

ساختار پوشه‌های یازی روی سیستمت

مسیرها
bash

~/.config/yazi/          # کانفیگ‌ها: yazi.toml, keymap.toml, theme.toml, init.lua
~/.config/yazi/plugins/  # پلاگین‌های Lua
~/.config/yazi/flavors/  # تم‌های آماده
~/.local/state/yazi/     # لاگ‌ها و وضعیت
/var/tmp/ یا /tmp/       # کش پیش‌نمایش‌ها

الان احتمالاً هیچ‌کدوم از این‌ها وجود ندارن، چون یازی بدون کانفیگ هم با مقادیر پیش‌فرض کار می‌کنه. توی فصل پیکربندی می‌سازیمشون.

حالا خودت امتحان کن

این شبیه‌ساز، چند رفتار پایه‌ی یازی رو داخل مرورگر تمرین میده؛ خود برنامه‌ی Yazi نیست. روش کلیک کن و کلیدها رو بزن — بدون ترس، هیچ فایل واقعی‌ای پاک نمی‌شه!

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

kaveh@fedora : /home/kavehتمرین Yazi
Documents/
Downloads/
Pictures/
Projects/
todo.txt
duck.jpg
wallpaper.png
NORMAL3/5

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

j / kپایین و بالاl / hورود و خروجSpaceانتخابg ⇒ gاول لیستGآخر لیستg ⇒ hخانه.فایل مخفیy / x / pکپی، برش، چسباندنdحذف تمرینیaساخت فایلqخروج از کنترل صفحه‌کلید

منبع برای بررسی جزئیات و تغییرات نسخه‌ها: شروع کار و wrapper شل.

آموزش کار با Yazi برای توزیع‌های مختلف لینوکس کاربرد داره؛ مثال‌های نصب و تنظیم محیط با اولویت کاربری نوشته شدن که فدورا رو با تنظیمات پیش‌فرض نصب کرده. دستور نصب بسته‌ها و ابزارهای جانبی در توزیع‌های دیگه ممکنه متفاوت باشه.