.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "ijq" "1" "2026\-07\-23"
.PP
.SH "نام (NAME)"
.PP
ijq \- ابزار تعاملی jq
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBijq\fR [\fB\-cnsrjaRMCSV\fR] [\fB\-f\fR \fIfile\fR] [\fIfilter\fR] [\fIfiles .\&.\&.\&\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
\fBijq\fR یک جایگزین تقریباً مستقیم برای \fBjq\fR است که به شما امکان می‌دهد نتایج فیلتر خود را هم‌زمان با ساخت آن، به‌صورت تعاملی مشاهده کنید.\&
.PP
\fBijq\fR شامل دو قاب و یک فیلد ورودی است: قاب سمت چپ، داده‌های ورودیِ اصلی و تغییرنیافته است و قاب سمت راست خروجی فیلترشده را نمایش می‌دهد.\& پس از پایان کار، برای خروج کلید Return را فشار دهید.\& خروجی فیلترشده در خروجی استاندارد و خود فیلتر در خطای استاندارد نوشته خواهد شد.\&
.PP
\fBijq\fR تاریخچه‌ای از فیلترهای استفاده‌شده را نگه‌داری می‌کند، مگر اینکه از طریق \fBhistory\-file\fR در فایل پیکربندی غیرفعال شده باشد.\& برای مرور تاریخچهٔ دردسترس، تمام متن درون فیلد فیلتر را پاک کنید.\&
.PP
اگر \fIfiles\fR مشخص نشود، \fBijq\fR داده‌ها را از ورودی استاندارد می‌خواند.\&
.PP
یک منوی تعاملی با عمل \fBtoggle\-menu\fR دردسترس است (پیش‌فرض: \fBCtrl\-/\fR، \fBCtrl\-?\&\fR یا \fBCtrl\-_\fR).\&
.PP
تمام گزینه‌ها با همتایان خود در \fBjq\fR یکسان هستند.\& این گزینه‌ها عبارتند از:
.PP
\fB\-c\fR
.RS 4
استفاده از خروجی فشرده به جای خروجی قالب‌بندی‌شده و خوانا (pretty\-printed).\&
.PP
.RE
\fB\-n\fR
.RS 4
هیچ ورودی‌ای خوانده نشود.\& برای استفاده از \fBijq\fR به عنوان یک ماشین‌حساب یا ساخت داده‌های JSON از ابتدا مفید است.\&
.PP
.RE
\fB\-s\fR
.RS 4
خواندن تمام ورودی در یک آرایهٔ واحد و اعمال فیلتر مشخص‌شده روی آن.\&
.PP
.RE
\fB\-r\fR
.RS 4
اگر خروجی فیلتر یک رشته باشد، به جای قالب‌بندی به عنوان یک رشتهٔ JSON دارای نقل‌قول، مستقیماً در خروجی استاندارد نوشته می‌شود.\& برای استفاده از \fBijq\fR در یک خط لوله (pipeline) با برنامه‌های دیگری که انتظار ورودی رشته‌ای عادی دارند مفید است.\&
.PP
.RE
\fB\-j\fR
.RS 4
مستلزم \fB\-r\fR است و خروجی را بدون خط جدید پایانی پس از هر نتیجه چاپ می‌کند.\&
.PP
.RE
\fB\-a\fR
.RS 4
چاپ رشته‌ها تنها با استفاده از نویسه‌های ASCII و دنباله‌های گریز.\&
.PP
.RE
\fB\-R\fR
.RS 4
ورودی به عنوان JSON تجزیه نشود؛ در عوض هر خط از ورودی به عنوان یک رشته به فیلتر منتقل شود.\& در صورت ترکیب با \fB\-s\fR، تمام ورودی به عنوان یک رشتهٔ طولانی واحد به فیلتر ارسال می‌شود.\&
.PP
.RE
\fB\-M\fR
.RS 4
غیرفعال کردن خروجی رنگی.\&
.PP
.RE
\fB\-C\fR
.RS 4
اجبار به استفاده از خروجی رنگی.\&
.PP
.RE
\fB\-S\fR
.RS 4
چاپ فیلدهای هر شیء به ترتیب مرتب‌شده.\&
.PP
.RE
\fB\-f\fR \fIfile\fR
.RS 4
خواندن فیلتر از \fIfile\fR.\& هنگام استفاده از این گزینه، تمام آرگومان‌های مکانی (در صورت وجود) به عنوان فایل‌های ورودی تفسیر می‌شوند.\&
.PP
.RE
.SH "فایل پیکربندی (CONFIG FILE)"
.PP
\fBijq\fR پیکربندی را از \fI$XDG_CONFIG_HOME/ijq/config\fR می‌خواند.\& اگر
\fI$XDG_CONFIG_HOME\fR مقداردهی نشده باشد، مسیر جایگزین
\fI\(ti/.\&config/ijq/config\fR خواهد بود.\&
.PP
قالب این فایل \fBscfg\fR است.\& تمام تنظیمات اختیاری هستند.\& اگر تنظیمی هم در فایل پیکربندی و هم در خط فرمان وجود داشته باشد، مقدار خط فرمان اولویت دارد.\&
.PP
\fBhistory\-file\fR \fIfile\fR
.RS 4
مسیر فایل تاریخچه.\& اگر روی '\&'\& تنظیم شود، تاریخچه غیرفعال می‌شود.\&
.PP
.RE
\fBjq\-bin\fR \fIfile\fR
.RS 4
نام یا مسیر فایل اجرایی برنامهٔ \fBjq\fR برای استفاده.\&
.PP
.RE
\fBhide\-input\-pane\fR \fIbool\fR
.RS 4
اگر روی true باشد، برنامه با پنهان بودن قاب نمایش ورودی (چپ) شروع به کار می‌کند.\&
.PP
.RE
\fBcopy\-filter\-to\-clipboard\-on\-exit\fR \fIbool\fR
.RS 4
اگر روی true باشد، هنگام خروج با عمل \fBsubmit\-filter\fR (پیش‌فرض: \fBReturn\fR)، فیلتر فعلی در کلیپ‌بورد کپی می‌شود.\& فیلتر پیش از نوشته شدن خروجی در stdout کپی می‌شود، بنابراین حتی اگر نوشتن خروجی پس از آن با شکست مواجه شود، کپی انجام شده است.\& خروج با \fBCtrl\-C\fR هرگز داده‌ای در کلیپ‌بورد نمی‌نویسد.\&
.PP
.RE
\fBkeymaps\fR
.RS 4
بخشی شامل کلیدهای میانبر.\& هر مدخلی که تعیین نشود، مقدار پیش‌فرض داخلی خود را حفظ می‌کند.\&
.PP
کلیدهای میانبر به صورت نام کلیدها (\fBCtrl+N\fR، \fBShift+Up\fR، \fBReturn\fR) یا نویسه‌های تکی (\fBu\fR، \fBG\fR) نوشته می‌شوند.\& هم \fI+\fR و هم \fI\-\fR می‌توانند میان کلیدهای تبدیلگر و نام کلیدها استفاده شوند؛ مانند \fBCtrl+N\fR و \fBCtrl\-N\fR.\&
.PP
هنگامی که فیلد ورودی فیلتر دارای تمرکز است، نویسه‌های چاپی همواره به عنوان ورودی متن تلقی می‌شوند.\& برای تخصیص یک دستور سراسری هنگام ویرایش فیلتر، از یک کلید غیرقابل‌چاپ یا ترکیبی از کلیدهای تبدیلگر استفاده کنید.\&
.PP
مدخل‌های دردسترس عبارتند از: \fBsubmit\-filter\fR، \fBmove\-down\fR، \fBmove\-up\fR،
\fBpage\-down\fR، \fBpage\-up\fR، \fBscroll\-to\-top\fR، \fBscroll\-to\-bottom\fR،
\fBhalf\-page\-up\fR، \fBhalf\-page\-down\fR، \fBline\-start\fR، \fBline\-end\fR،
\fBcursor\-right\fR، \fBcursor\-left\fR، \fBfocus\-input\-pane\fR، \fBfocus\-output\-pane\fR،
\fBfocus\-filter\-input\fR، \fBnext\-focus\fR، \fBprevious\-focus\fR،
\fBtoggle\-input\-pane\fR، \fBsave\-filter\-history\fR، \fBnext\-autocomplete\fR،
\fBprevious\-autocomplete\fR، \fBtoggle\-menu\fR، \fBcopy\-filter\-to\-clipboard\fR،
\fBcopy\-output\-to\-clipboard\fR.\&
.PP
.RE
.SH "کلیدهای میانبر (KEY BINDINGS)"
.PP
این‌ها کلیدهای میانبر پیش‌فرض هستند.\& می‌توان آن‌ها را در بخش \fBkeymaps\fR فایل پیکربندی بازتعریف کرد.\&
.PP
\fBShift + Up\fR, \fBShift + Left\fR
.RS 4
تمرکز روی قاب نمایش ورودی (چپ) (\fBfocus\-input\-pane\fR).\&
.PP
.RE
\fBShift + Right\fR
.RS 4
تمرکز روی قاب نمایش خروجی (راست) (\fBfocus\-output\-pane\fR).\&
.PP
.RE
\fBShift + Down\fR
.RS 4
تمرکز روی فیلد ورودی متنی (فیلتر) (\fBfocus\-filter\-input\fR).\&
.PP
.RE
\fBTab\fR
.RS 4
هنگامی که فیلد ورودی متن (فیلتر) دارای تمرکز است، فعال‌سازی تکمیل خودکار یا جابه‌جایی در فهرست تکمیل خودکار (\fBnext\-autocomplete\fR).\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، جابه‌جایی میان نماهای مختلف (\fBnext\-focus\fR).\&
.PP
.RE
\fBShift\-Tab\fR
.RS 4
مانند \fBTab\fR، اما در جهت مخالف حرکت می‌کند (\fBprevious\-autocomplete\fR، \fBprevious\-focus\fR).\&
.PP
.RE
\fBCtrl\-A\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، انتقال نشانگر به ابتدای ورودی.\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، تنظیم آفست ستون روی 0 (\fBline\-start\fR).\&
.PP
.RE
\fBCtrl\-E\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، انتقال نشانگر به انتهای ورودی.\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، تنظیم آفست ستون برای مشاهدهٔ طولانی‌ترین خط مرئی (\fBline\-end\fR).\&
.PP
.RE
\fBCtrl\-F\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، انتقال نشانگر به اندازهٔ یک نویسه به جلو (\fBcursor\-right\fR).\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش یک صفحه به پایین (\fBpage\-down\fR).\&
.PP
.RE
\fBCtrl\-B\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، انتقال نشانگر به اندازهٔ یک نویسه به عقب (\fBcursor\-left\fR).\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش یک صفحه به بالا (\fBpage\-up\fR).\&
.PP
.RE
\fBCtrl\-D\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، حذف نویسهٔ زیر نشانگر.\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش نیم‌صفحه به پایین (\fBhalf\-page\-down\fR).\&
.PP
.RE
\fBCtrl\-U\fR
.RS 4
هنگامی که فیلد ورودی متن دارای تمرکز است، حذف تمام متن از نشانگر تا ابتدای فیلد.\& هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش نیم‌صفحه به بالا (\fBhalf\-page\-up\fR).\&
.PP
.RE
\fBCtrl\-O\fR
.RS 4
تغییر وضعیت نمایانیِ قاب نمایش ورودی (چپ) (\fBtoggle\-input\-pane\fR).\&
.PP
.RE
\fBCtrl\-S\fR
.RS 4
ذخیرهٔ فیلتر فعلی در تاریخچه و نمایش پنجرهٔ بازشوی تأیید (\fBsave\-filter\-history\fR).\&
.PP
.RE
\fBCtrl\-/\fR, \fBCtrl\-?\&\fR, \fBCtrl\-_\fR
.RS 4
باز یا بسته کردن منوی شناور (\fBtoggle\-menu\fR).\&
.PP
.RE
\fBSpace\fR
.RS 4
هنگامی که منوی ریشهٔ شناور باز است، فعال‌سازی مدخل انتخاب‌شدهٔ منو.\& هنگامی که زیرنمای Configure باز است، تغییر وضعیت گزینهٔ انتخاب‌شده.\&
.PP
.RE
\fBEnter\fR, \fBReturn\fR
.RS 4
هنگامی که زیرنمای Configure باز است، تغییر وضعیت گزینهٔ انتخاب‌شده.\& هنگامی که زیرنمای Manage history باز است، اعمال مدخل تاریخچهٔ انتخاب‌شده روی فیلتر و بستن منوی شناور (\fBsubmit\-filter\fR).\&
.PP
.RE
\fBx\fR
.RS 4
هنگامی که زیرنمای Manage history باز است، حذف مدخل تاریخچهٔ انتخاب‌شده پس از دریافت تأیید.\&
.PP
.RE
\fB/\fR
.RS 4
هنگامی که زیرنمای Manage history باز است، باز کردن یک ورودی فیلتر برای مدخل‌های تاریخچه.\&
.PP
.RE
\fBEsc\fR, \fBCtrl\-C\fR, \fBq\fR
.RS 4
هنگامی که منوی شناور باز است، بازگشت به منوی ریشه یا بستن منوی شناور.\&
.PP
.RE
\fBu\fR, \fBd\fR, \fBf\fR, \fBb\fR
.RS 4
هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش نیم‌صفحه یا یک صفحه به بالا/پایین.\&
.PP
.RE
\fBg\fR
.RS 4
هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش به بالاترین نقطه (\fBscroll\-to\-top\fR).\&
.PP
.RE
\fBG\fR
.RS 4
هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، پیمایش به پایین‌ترین نقطه (\fBscroll\-to\-bottom\fR).\&
.PP
.RE
\fBLeft\fR, \fBDown\fR, \fBUp\fR, \fBRight\fR
\fBh\fR, \fBj\fR, \fBk\fR, \fBl\fR
.RS 4
هنگامی که یکی از قاب‌های نمایش دارای تمرکز است، حرکت دادن نما به چپ/پایین/بالا/راست.\&
.PP
.RE
\fBReturn\fR
.RS 4
بستن \fBijq\fR.\& نوشتن محتویات قاب خروجی در stdout و فیلتر ورودی فعلی در stderr.\& فیلتر ورودی فعلی در فایل تاریخچه نیز ذخیره می‌شود.\&
.PP
.RE
\fBCtrl\-C\fR
.RS 4
هنگامی که منوی شناور باز است، بستن منوی شناور.\& هنگامی که ورودی فیلتر دارای تمرکز و غیرخالی است، پاک کردن ورودی فیلتر.\& در غیر این صورت، خروج فوری از \fBijq\fR بدون نوشتن هیچ داده‌ای در stdout یا stderr.\&
.PP
.RE
.SH "پیش‌نمایش (DEMO)"
.PP
برای مشاهدهٔ یک پیش‌نمایش به https://asciinema.\&org/a/496932 مراجعه کنید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
jq(1)
.PP
.SH "نویسندگان (AUTHORS)"
.PP
Gregory Anders <greg@gpanders.\&com>