'\" t
.\"     Title: i3-input
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/06/2026
.\"    Manual: i3 Manual
.\"    Source: i3 4.25.1
.\"  Language: English
.\"
.TH "I3\-INPUT" "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-input \- دریافت تعاملی دستور برای مدیر پنجره i3
.SH "خلاصه دستور (SYNOPSIS)"
.sp
i3\-input [\-s <socket>] [\-F <format>] [\-l <limit>] [\-P <prompt>] [\-f <font>] [\-v]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
.B i3\-input
ابزاری برای دریافت دستورها (یا بخش‌هایی از یک دستور) نوشته‌شده توسط کاربر و ارسال آن(ها) به i3 است\&. این ابزار برای نمونه برای دستور mark/goto کاربردی است\&.
.sp
می‌توانید با فشردن کلید Escape، برنامه i3\-input را بدون ارسال هیچ دستوری ببندید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-s <socket>
.RS 4
مسیر سوکت IPC مدیر پنجره i3 را مشخص می‌کند (نیازی به استفاده معمول از این گزینه نیست، زیرا i3\-input خودش مسیر را پیدا خواهد کرد)\&.
.RE
.PP
\-F <format>
.RS 4
هر بار تکرار عبارت "%s" در رشته <format> با ورودی کاربر جایگزین شده و نتیجه به عنوان دستور به i3 ارسال می‌شود\&. مقدار پیش‌فرض "%s" است\&.
.RE
.PP
\-l <limit>
.RS 4
حداکثر طول مجاز ورودی کاربر را به <limit> نویسه (کاراکتر) محدود می‌کند\&. هنگامی که طول ورودی کاربر به این مقدار برسد، i3\-input به طور خودکار دستور را ارسال و اجرا می‌کند\&.
.RE
.PP
\-P <prompt>
.RS 4
رشته اعلان <prompt> را در جلوی کادر متنی ورودی کاربر نمایش می‌دهد\&. رشته اعلان جزو ورودی یا دستور ارسالی کاربر محسوب نمی‌شود\&.
.RE
.PP
\-f <font>
.RS 4
از فونت اصلی هسته X11 مشخص‌شده استفاده می‌کند (برای انتخاب فونت می‌توانید از
xfontsel
استفاده کنید)\&.
.RE
.PP
\-v
.RS 4
نمایش نسخه برنامه و خروج\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
علامت‌گذاری یک کانتینر با یک نویسه منفرد:
.sp
.if n \{\
.RS 4
.\}
.nf
i3\-input \-F \*(Aqmark %s\*(Aq \-l 1 \-P \*(AqMark: \*(Aq
.fi
.if n \{\
.RE
.\}
.sp
پرش و رفتن به کانتینر علامت‌گذاری‌شده با مثال بالا:
.sp
.if n \{\
.RS 4
.\}
.nf
i3\-input \-F \*(Aq[con_mark="%s"] focus\*(Aq \-l 1 \-P \*(AqGo to: \*(Aq
.fi
.if n \{\
.RE
.\}
.SH "محیط (ENVIRONMENT)"
.SS "I3SOCK"
.sp
برنامه i3\-input منابع مختلف مسیر سوکت را به ترتیب اولویت زیر بررسی و مدیریت می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
متغیر محیطی I3SOCK
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در صورت مشخص شدن پارامتر \-s، مقدار متغیر I3SOCK نادیده گرفته و جایگزین می‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر هیچ‌کدام در دسترس نباشند، i3\-input مسیر سوکت را از ویژگی X11 می‌خواند که روش توصیه‌شده است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر همه موارد با شکست مواجه شوند، i3\-input مسیر
/tmp/i3\-ipc\&.sock
را امتحان می‌کند
.RE
.sp
مسیر سوکت برای اتصال به i3 و صدور واقعی دستور ضروری است\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
i3(1)
.SH "نویسندگان (AUTHORS)"
.sp
Michael Stapelberg و مشارکت‌کنندگان