'\" t .\" Title: i3 .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 02/06/2026 .\" Manual: i3 Manual .\" Source: i3 4.25.1 .\" Language: English .\" .TH "I3" "1" "02/06/2026" "i3 4\&.25\&.1" "i3 Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" i3 \- مدیر پنجره کاشی‌کار بهبودیافته .SH "خلاصه دستور (SYNOPSIS)" .sp i3 [\-a] [\-c configfile] [\-C] [\-d all] [\-v] [\-V] .SH "گزینه‌ها (OPTIONS)" .PP \-a .RS 4 غیرفعال‌سازی شروع خودکار (autostart)\&. .RE .PP \-c .RS 4 یک مسیر جایگزین برای فایل پیکربندی مشخص می‌کند\&. .RE .PP \-C .RS 4 بررسی صحت و اعتبار فایل پیکربندی و سپس خروج\&. .RE .PP \-d all .RS 4 فعال‌سازی ثبت گزارش اشکال‌زدایی (debug logging)\&. پارامتر \fIall\fR به دلایل تاریخی وجود دارد\&. .RE .PP \-v .RS 4 نمایش شماره نسخه (و تاریخ آخرین کامیت)\&. .RE .PP \-V .RS 4 ارائه خروجی با جزئیات کامل (حالت پرگو)\&. .RE .PP \-\-force\-xinerama .RS 4 استفاده از Xinerama به جای RandR\&. از این گزینه تنها در صورتی باید استفاده شود که مجبور به استفاده از درایور قدیمی متن‌بسته nVidia (قدیمی‌تر از 302\&.17) هستید که از RandR پشتیبانی نمی‌کند\&. .RE .PP \-\-get\-socketpath .RS 4 مسیر سوکت IPC برنامه i3 را از X11 دریافت کرده، آن را چاپ می‌کند و خارج می‌شود\&. .RE .PP \-\-shmlog\-size .RS 4 اندازه گزارش حافظه اشتراکی (SHM log) برنامه i3 را به بایت محدود می‌کند\&. تنظیم این مقدار روی 0، ثبت گزارش در SHM را کاملاً غیرفعال می‌کند\&. مقدار پیش‌فرض 0 بایت است\&. .RE .PP \-\-replace .RS 4 جایگزین کردن مدیر پنجره در حال اجرای فعلی\&. .RE .SH "توضیحات (DESCRIPTION)" .SS "مقدمه (INTRODUCTION)" .sp پروژه i3 از آنجا شکل گرفت که wmii، مدیر پنجره محبوب ما در آن زمان، برخی قابلیت‌های مدنظرمان را نداشت (برای نمونه، پیاده‌سازی اصولی و درست چندمانیتوره)، باگ‌هایی داشت، برای مدت زمان نسبتاً طولانی پیشرفتی نکرده بود و توسعه و هک آن اصلاً آسان نبود (کامنت‌ها و مستندات کد منبع کاملاً ناکافی بود)\&. با این حال، ما معتقدیم توسعه‌دهندگان و مشارکت‌کنندگان wmii کار فوق‌العاده‌ای انجام داده بودند\&. از آن‌ها برای الهام بخشیدن به ما در ساخت i3 سپاسگزاریم\&. .sp لطفاً توجه داشته باشید که i3 در وهله نخست برای کاربران پیشرفته و توسعه‌دهندگان هدف‌گذاری شده است\&. .SS "نکته مهم برای کاربران درایور باینری nVidia" .sp اگر از درایور باینری گرافیک nVidia (که به عنوان \fIblob\fR نیز شناخته می‌شود) قبل از نسخه 302\&.17 استفاده می‌کنید، لازم است هنگام راه‌اندازی i3 از فلگ \-\-force\-xinerama (در فایل ~/\&.xsession خود) به شکل زیر استفاده کنید: .sp .if n \{\ .RS 4 .\} .nf exec i3 \-\-force\-xinerama \-V >>~/\&.i3/i3log 2>&1 .fi .if n \{\ .RE .\} .sp همچنین برای توضیحات کامل، به docs/multi\-monitor مراجعه کنید\&. .SS "اصطلاحات (TERMINOLOGY)" .PP درخت (Tree) .RS 4 مدیر پنجره i3 چیدمان شما را در یک ساختار داده درختی نگهداری می‌کند\&. .RE .PP پنجره (Window) .RS 4 یک پنجره X11، مانند پنجره مرورگر Firefox یا شبیه‌ساز ترمینال\&. .RE .PP پنجره شناور (Floating Window) .RS 4 پنجره‌ای که روی پنجره‌های دیگر «شناور» است\&. این سبک در i3 برای نمایش پنجره‌های X11 با نوع "dialog" استفاده می‌شود، مانند کادرهای گفتگوی "Print" یا "Open File" در بسیاری از برنامه‌های گرافیکی\&. نحوه استفاده از پنجره‌های شناور را می‌توان با دستور for_window دقیق‌تر تنظیم کرد (راهنمای کاربر HTML را ببینید)\&. .RE .PP کانتینر تفکیک‌شده (Split container) .RS 4 یک کانتینر تفکیک‌شده شامل چندین کانتینر تفکیک‌شده یا پنجره دیگر است\&. .sp کانتینرها را می‌توان در چیدمان‌های مختلف استفاده کرد\&. حالت پیش‌فرض "default" نامیده می‌شود و اندازه هر کلاینت را به طور یکسان تغییر می‌دهد تا جا شود\&. .RE .PP فضای کاری (Workspace) .RS 4 فضای کاری مجموعه‌ای از کانتینرها است\&. سایر مدیرهای پنجره به آن «میزکارهای مجازی (Virtual Desktops)» می‌گویند\&. .sp در i3، هر فضای کاری به یک صفحه نمایش مجازی خاص اختصاص داده می‌شود\&. به طور پیش‌فرض، صفحه ۱ دارای فضای کاری ۱، صفحه ۲ دارای فضای کاری ۲ و به همین ترتیب است\&... با این حال، هنگامی که یک فضای کاری جدید ایجاد می‌کنید (با جابجایی ساده به آن)، صفحه‌ای که در حال حاضر در آن قرار دارید به آن اختصاص می‌یابد\&. .RE .PP خروجی (Output) .RS 4 با استفاده از XRandR، می‌توانید یک صفحه X11 داشته باشید که چندین مانیتور واقعی را پوشش می‌دهد\&. علاوه بر این، می‌توانید آن‌ها را در حالت شبیه‌سازی (کلون) یا با موقعیت‌های مشخص (مانیتور ۱ در سمت چپ مانیتور ۲) تنظیم کنید\&. .sp مدیر پنجره i3 از رابط RandR برای پرس‌وجوی خروجی‌های در دسترس و صفحه‌های متصل به این خروجی‌ها استفاده می‌کند\&. .RE .SH "کلیدهای میانبر (KEYBINDINGS)" .sp در اینجا یک بررسی کوتاه از کلیدهای میانبر پیش‌فرض آورده شده است: .PP Mod1+Enter .RS 4 باز کردن یک پنجره شبیه‌ساز ترمینال جدید\&. .RE .PP Mod1+d .RS 4 باز کردن dmenu برای اجرای هر برنامه‌ای با تایپ کردن (بخشی از) نام آن\&. .RE .PP j/k/l/; .RS 4 کلیدهای جهت‌نما (چپ، پایین، بالا، راست)\&. این کلیدها در ردیف اصلی صفحه‌کلید شما قرار دارند (به برآمدگی روی کلید "j" دقت کنید)\&. به عنوان روش جایگزین، می‌توانید از کلیدهای مکان‌نما (جهت‌نما) نیز استفاده کنید\&. .RE .PP Mod1+ .RS 4 تغییر فوکوس به پنجره در جهت \&. .RE .PP Mod1+Shift+ .RS 4 انتقال پنجره به جهت \&. .RE .PP Mod1+ .RS 4 جابجایی به فضای کاری \&. .RE .PP Mod1+Shift+ .RS 4 انتقال پنجره به فضای کاری \&. .RE .PP Mod1+f .RS 4 تغییر وضعیت به حالت تمام‌صفحه\&. .RE .PP Mod1+s .RS 4 فعال‌سازی چیدمان پشته‌ای (stacking) برای کانتینر جاری\&. .RE .PP Mod1+e .RS 4 فعال‌سازی چیدمان پیش‌فرض برای کانتینر جاری\&. .RE .PP Mod1+w .RS 4 فعال‌سازی چیدمان زبانه‌ای (tabbed) برای کانتینر جاری\&. .RE .PP Mod1+Shift+Space .RS 4 تغییر وضعیت کانتینر جاری بین کاشی‌کاری و شناور\&. .RE .PP Mod1+Space .RS 4 انتخاب نخستین کانتینر کاشی‌کاری‌شده در صورتی که کانتینر جاری شناور باشد، و برعکس\&. .RE .PP Mod1+Shift+q .RS 4 بستن پنجره جاری\&. این معادل «کلیک روی دکمه بستن» است؛ یعنی یک درخواست محترمانه به برنامه برای بستن پنجره ارسال می‌شود\&. برای نمونه، Firefox نشست خود را پس از چنین درخواستی ذخیره خواهد کرد\&. اگر برنامه از این درخواست پشتیبانی نکند، پنجره بسته خواهد شد و آنچه رخ می‌دهد به رفتار برنامه بستگی دارد\&. .RE .PP Mod1+Shift+r .RS 4 راه‌اندازی مجدد درجا برای i3\&. چیدمان پنجره‌های شما حفظ خواهد شد\&. .RE .PP Mod1+Shift+e .RS 4 خروج از i3\&. .RE .SH "فایل‌ها (FILES)" .SS "~/\&.config/i3/config (یا ~/\&.i3/config)" .sp هنگام راه‌اندازی، i3 فایل‌های پیکربندی را به ترتیب زیر جستجو می‌کند: .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} ~/\&.config/i3/config (یا $XDG_CONFIG_HOME/i3/config در صورت تنظیم) .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} ~/\&.i3/config .RE .sp .RS 4 .ie n \{\ \h'-04' 3.\h'+01'\c .\} .el \{\ .sp -1 .IP " 3." 4.2 .\} /etc/xdg/i3/config (یا $XDG_CONFIG_DIRS/i3/config در صورت تنظیم) .RE .sp .RS 4 .ie n \{\ \h'-04' 4.\h'+01'\c .\} .el \{\ .sp -1 .IP " 4." 4.2 .\} /etc/i3/config .RE .sp می‌توانید با استفاده از گزینه \-c یک مسیر دلخواه را مشخص کنید\&. .PP \fBنمونه پیکربندی\fR. .sp .if n \{\ .RS 4 .\} .nf # فایل پیکربندی i3 (نسخه ۴) # فونت برای عنوان پنجره‌ها\&. همچنین توسط نوار (bar) استفاده خواهد شد، مگر اینکه فونت دیگری # در بلوک bar {} در زیر مشخص شده باشد\&. # این فونت به طور گسترده نصب است، گلیف‌های یونیکد زیادی ارائه می‌دهد، از رندر متن # راست‌به‌چپ پشتیبانی می‌کند و قابلیت مقیاس‌پذیری در نمایشگرهای hidpi/retina را دارد (به لطف pango)\&. font pango:DejaVu Sans Mono 8 # قبل از i3 نسخه ۴\&.۸، ما این مورد را به عنوان پیش‌فرض پیشنهاد می‌کردیم: # font \-misc\-fixed\-medium\-r\-normal\-\-13\-120\-75\-75\-C\-70\-iso10646\-1 # فونت بالا بسیار کم‌مصرف در فضا است، یعنی در اندازه‌های کوچک خوب، واضح و # شفاف به نظر می‌رسد\&. با این حال، پوشش گلیف یونیکد آن محدود است، سیستم رندر قدیمی # فونت‌های اصلی X از راست‌به‌چپ پشتیبانی نمی‌کند و از آنجا که یک فونت بیت‌مپ است، # در نمایشگرهای hidpi/retina مقیاس‌پذیر نیست\&. # استفاده از کلید Mod1+ماوس برای کشیدن پنجره‌های شناور به موقعیت دلخواه floating_modifier Mod1 # شروع یک ترمینال bindsym Mod1+Return exec /usr/bin/urxvt # بستن پنجره فوکوس‌شده bindsym Mod1+Shift+q kill # اجرای dmenu (راه‌انداز برنامه) bindsym Mod1+d exec /usr/bin/dmenu_run # تغییر فوکوس bindsym Mod1+j focus left bindsym Mod1+k focus down bindsym Mod1+l focus up bindsym Mod1+semicolon focus right # به عنوان روش جایگزین، می‌توانید از کلیدهای جهت‌نما استفاده کنید: bindsym Mod1+Left focus left bindsym Mod1+Down focus down bindsym Mod1+Up focus up bindsym Mod1+Right focus right # جابجایی پنجره فوکوس‌شده bindsym Mod1+Shift+j move left bindsym Mod1+Shift+k move down bindsym Mod1+Shift+l move up bindsym Mod1+Shift+semicolon move right # به عنوان روش جایگزین، می‌توانید از کلیدهای جهت‌نما استفاده کنید: bindsym Mod1+Shift+Left move left bindsym Mod1+Shift+Down move down bindsym Mod1+Shift+Up move up bindsym Mod1+Shift+Right move right # تفکیک در جهت افقی bindsym Mod1+h split h # تفکیک در جهت عمودی bindsym Mod1+v split v # ورود به حالت تمام‌صفحه برای کانتینر فوکوس‌شده bindsym Mod1+f fullscreen toggle # تغییر چیدمان کانتینر (stacked، tabbed، default) bindsym Mod1+s layout stacking bindsym Mod1+w layout tabbed bindsym Mod1+e layout default # تغییر وضعیت بین کاشی‌کاری و شناور bindsym Mod1+Shift+space floating toggle # تغییر فوکوس بین پنجره‌های کاشی‌کاری و شناور bindsym Mod1+space focus mode_toggle # فوکوس روی کانتینر والد bindsym Mod1+a focus parent # فوکوس روی کانتینر فرزند #bindsym Mod1+d focus child # جابجایی به فضای کاری bindsym Mod1+1 workspace 1 bindsym Mod1+2 workspace 2 # \&.\&. # انتقال کانتینر فوکوس‌شده به فضای کاری bindsym Mod1+Shift+1 move workspace 1 bindsym Mod1+Shift+2 move workspace 2 # \&.\&.\&. # بارگذاری مجدد فایل پیکربندی bindsym Mod1+Shift+c reload # راه‌اندازی مجدد درجا برای i3 (چیدمان/نشست شما حفظ می‌شود، برای ارتقای i3 نیز کاربرد دارد) bindsym Mod1+Shift+r restart # خروج از i3 (شما را از نشست X خارج می‌کند) bindsym Mod1+Shift+e exit # نمایش دکمه‌های فضای کاری به همراه خط وضعیت تولیدشده توسط i3status bar { status_command i3status } .fi .if n \{\ .RE .\} .sp .SS "~/\&.xsession" .sp این فایلی است که باید در آن محلی‌سازی‌ها (locales) را پیکربندی کرده و i3 را اجرا کنید\&. این فایل به محض ورود شما توسط مدیر ورود (xdm, slim, gdm, \&...) اجرا می‌شود\&. .PP \fBنمونه xsession\fR. .sp .if n \{\ .RS 4 .\} .nf # غیرفعال کردن خاموش شدن صفحه توسط DPMS xset \-dpms xset s off # غیرفعال کردن بوق هشدار xset \-b # فعال‌سازی بستن اضطراری سرور X با کلیدهای میانبر C-A- setxkbmap \-option terminate:ctrl_alt_bksp # اعمال محلی‌سازی‌های صحیح از ابتدا: # مقدار LC_ALL لغو می‌شود زیرا همه متغیرها را بازنویسی می‌کند # از LANG=de_DE\&.UTF\-8 استفاده می‌شود، به جز موارد زیر: # مقدار LC_MESSAGES=C هرگز خروجی برنامه‌ها را ترجمه نمی‌کند # مقدار LC_TIME=en_DK منجر به خروجی تاریخ/زمان yyyy\-mm\-dd hh:mm می‌شود unset LC_ALL export LANG=de_DE\&.UTF\-8 export LC_MESSAGES=C export LC_TIME=en_DK\&.UTF\-8 # استفاده از XToolkit در برنامه‌های جاوا export AWT_TOOLKIT=XToolkit # تنظیم رنگ پس‌زمینه xsetroot \-solid "#333333" # فعال کردن core dump در صورت بروز مشکل ulimit \-c unlimited # شروع i3 و ثبت گزارش در ~/\&.local/share/i3/log mkdir \-p ~/\&.local/share/i3 echo "Starting at $(date)" >> ~/\&.local/share/i3/log exec /usr/bin/i3 \-V \-d all >> ~/\&.local/share/i3/log .fi .if n \{\ .RE .\} .sp .SH "محیط (ENVIRONMENT)" .SS "I3SOCK" .sp این متغیر مسیر سوکت IPC را رونویسی و جایگزین می‌کند (برای مکان پیش‌فرض به راهنمای کاربر مراجعه کنید)\&. سوکت IPC توسط برنامه‌های خارجی مانند i3\-msg(1)، i3bar(1) یا اسکریپت‌های کاربر استفاده می‌شود\&. .SH "همچنین ببینید (SEE ALSO)" .sp شما باید یک نسخه از راهنمای کاربر (شامل تصاویر و اسکرین‌شات‌ها که به همین دلیل در این صفحه راهنما ادغام نشده است)، راهنمای اشکال‌زدایی و راهنمای توسعه ("how to hack") را داشته باشید\&. .sp همچنین می‌توانید به صورت آنلاین در نشانی \m[blue]\fBhttps://i3wm\&.org\fR\m[] به این مستندات دسترسی پیدا کنید\&. .sp i3\-input(1), i3\-msg(1), i3bar(1), i3\-nagbar(1), i3\-config\-wizard(1), i3\-migrate\-config\-to\-v4(1) .SH "نویسندگان (AUTHORS)" .sp Michael Stapelberg و مشارکت‌کنندگان