I3-INPUT(1)                        i3 Manual                       I3-INPUT(1)

نام (NAME)
       i3-input - دریافت تعاملی دستور برای مدیر پنجره i3

خلاصه دستور (SYNOPSIS)
       i3-input [-s <socket>] [-F <format>] [-l <limit>] [-P <prompt>] [-f
       <font>] [-v]

توضیحات (DESCRIPTION)
       دستور i3-input ابزاری برای دریافت دستورها (یا بخش‌هایی از یک دستور)
       نوشته‌شده توسط کاربر و ارسال آن(ها) به i3 است. این ابزار برای نمونه برای
       دستور mark/goto کاربردی است.

       می‌توانید با فشردن کلید Escape، برنامه i3-input را بدون ارسال هیچ دستوری
       ببندید.

گزینه‌ها (OPTIONS)
       -s <socket>
           مسیر سوکت IPC مدیر پنجره i3 را مشخص می‌کند (نیازی به استفاده معمول
           از این گزینه نیست، زیرا i3-input خودش مسیر را پیدا خواهد کرد).

       -F <format>
           هر بار تکرار عبارت "%s" در رشته <format> با ورودی کاربر جایگزین شده
           و نتیجه به عنوان دستور به i3 ارسال می‌شود. مقدار پیش‌فرض "%s" است.

       -l <limit>
           حداکثر طول مجاز ورودی کاربر را به <limit> نویسه (کاراکتر) محدود
           می‌کند. هنگامی که طول ورودی کاربر به این مقدار برسد، i3-input به طور
           خودکار دستور را ارسال و اجرا می‌کند.

       -P <prompt>
           رشته اعلان <prompt> را در جلوی کادر متنی ورودی کاربر نمایش می‌دهد.
           رشته اعلان جزو ورودی یا دستور ارسالی کاربر محسوب نمی‌شود.

       -f <font>
           از فونت اصلی هسته X11 مشخص‌شده استفاده می‌کند (برای انتخاب فونت
           می‌توانید از xfontsel استفاده کنید).

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

مثال‌ها (EXAMPLES)
       علامت‌گذاری یک کانتینر با یک نویسه منفرد:

           i3-input -F 'mark %s' -l 1 -P 'Mark: '

       پرش و رفتن به کانتینر علامت‌گذاری‌شده با مثال بالا:

           i3-input -F '[con_mark="%s"] focus' -l 1 -P 'Go to: '

محیط (ENVIRONMENT)
   I3SOCK
       برنامه i3-input منابع مختلف مسیر سوکت را به ترتیب اولویت زیر بررسی و
       مدیریت می‌کند:

       •   متغیر محیطی I3SOCK

       •   در صورت مشخص شدن پارامتر -s، مقدار متغیر I3SOCK نادیده گرفته و
           جایگزین می‌شود

       •   اگر هیچ‌کدام در دسترس نباشند، i3-input مسیر سوکت را از ویژگی X11
           می‌خواند که روش توصیه‌شده است

       •   اگر همه موارد با شکست مواجه شوند، i3-input مسیر /tmp/i3-ipc.sock را
           امتحان می‌کند

       مسیر سوکت برای اتصال به i3 و صدور واقعی دستور ضروری است.

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

نویسندگان (AUTHORS)
       Michael Stapelberg و مشارکت‌کنندگان

i3 4.25.1                         02/06/2026                       I3-INPUT(1)