.TH YAD 1 "June 2024"  "yad" "User Commands"

.SH "نام (NAME)"
yad \- نمایش کادرهای محاوره‌ای GTK+ از طریق اسکریپت‌های شل یا خط فرمان

.SH "خلاصه دستور (SYNOPSIS)"
.B yad
.RI [ OPTIONS ]

.SH "توضیحات (DESCRIPTION)"
برنامه \fBYAD\fP ابزاری است که کادرهای محاوره‌ای GTK+ را نمایش داده و ورودی کاربر را (در قالب کد بازگشتی یا در خروجی استاندارد) برمی‌گرداند. این قابلیت به شما امکان می‌دهد در انواع اسکریپت‌های شل، اطلاعات را به کاربر نمایش داده یا از او ورودی دریافت کنید.
.PP
برنامه \fBYAD\fP یک انشعاب (fork) از برنامه \fBZenity\fP است.

.SH "گزینه‌ها (OPTIONS)"
این برنامه از نحو معمول خط فرمان گنو (GNU) پیروی می‌کند، به این صورت که گزینه‌های طولانی با دو خط تیره (\(aq\-\(aq) آغاز می‌شوند.

.SS "گزینه‌های کادر محاوره (Dialog options)"
.TP
.B \-\-about
نمایش کادر محاوره‌ای درباره برنامه.
.TP
.B \-\-app
نمایش کادر محاوره‌ای انتخاب برنامه.
.TP
.B \-\-calendar
نمایش کادر محاوره‌ای تقویم.
.TP
.B \-\-color
نمایش کادر محاوره‌ای انتخاب رنگ.
.TP
.B \-\-dnd
نمایش کادر کشیدن و رها کردن (drag-and-drop).
.TP
.B \-\-entry
نمایش کادر محاوره‌ای ورودی متن.
.TP
.B \-\-icons
نمایش جعبه‌ای از آیکون‌های میان‌بر.
.TP
.B \-\-file
نمایش کادر محاوره‌ای انتخاب فایل.
.TP
.B \-\-font
نمایش کادر محاوره‌ای انتخاب قلم (فونت).
.TP
.B \-\-form
نمایش کادر محاوره‌ای فرم.
.TP
.B \-\-html
نمایش کادر محاوره‌ای HTML.
.TP
.B \-\-list
نمایش کادر محاوره‌ای فهرست.
.TP
.B \-\-notebook
نمایش کادر محاوره‌ای چندبرگ (notebook).
.TP
.B \-\-notification
نمایش آیکون اعلان (notification).
.TP
.B \-\-appindicator
نمایش آیکون appindicator.
.TP
.B \-\-popup
نمایش کادر محاوره‌ای پیام بالاپر (popup).
.TP
.B \-\-print
نمایش کادر محاوره‌ای چاپ.
.TP
.B \-\-progress
نمایش کادر محاوره‌ای نشانگر پیشرفت.
.TP
.B \-\-scale
نمایش کادر محاوره‌ای مقیاس (اسلایدر).
.TP
.B \-\-text-info
نمایش کادر محاوره‌ای اطلاعات متنی..SS "گزینه‌های عمومی (General options)"
.TP
.B \-\-title=\fITITLE\fP
تنظیم عنوان کادر محاوره.
.TP
.B \-\-window-icon=\fIICON\fP
تنظیم آیکون پنجره.
.TP
.B \-\-width=\fIWIDTH\fP
تنظیم عرض پنجرهٔ کادر محاوره.
.TP
.B \-\-height=\fIHEIGHT\fP
تنظیم ارتفاع پنجرهٔ کادر محاوره.
.TP
.B \-\-posx=\fINUMBER\fP
تنظیم موقعیت افقی (X) پنجرهٔ کادر محاوره. \fINUMBER\fP می‌تواند منفی باشد.
.TP
.B \-\-posy=\fINUMBER\fP
تنظیم موقعیت عمودی (Y) پنجرهٔ کادر محاوره. \fINUMBER\fP می‌تواند منفی باشد.
.TP
.B \-\-geometry=\fIWIDTHxHEIGHT+X+Y\fP
استفاده از نمادگذاری استاندارد هندسهٔ X Window برای تعیین محل کادر محاوره.
هنگامی که از این گزینه استفاده شود، گزینه‌های \fIwidth\fP، \fIheight\fP، \fIposx\fP، \fIposy\fP، \fImouse\fP و \fIcenter\fP نادیده
گرفته می‌شوند.
.TP
.B \-\-timeout=\fITIMEOUT\fP
تنظیم زمان انقضای کادر محاوره به ثانیه.
.TP
.B \-\-timeout-indicator=\fIPOSITION\fP
نمایش نشانگر زمان انقضا در موقعیت داده‌شده. موقعیت‌ها عبارتند از: \fItop\fP، \fIbottom\fP، \fIleft\fP یا \fIright\fP.
ظاهر نشانگر می‌تواند از طریق شیوه‌نامه‌های CSS کاربر تنظیم شود.
.TP
.B \-\-kill-parent=\fI[SIGNAL]\fP
ارسال SIGNAL به فرایند والد. مقدار پیش‌فرض SIGNAL برابر با SIGTERM است.
SIGNAL می‌تواند با شماره یا نام نمادین آن با پیشوند SIG یا بدون آن مشخص شود.
برای جزئیات بیشتر در مورد سیگنال‌ها signal(7) را ببینید.
.TP
.B \-\-print-xid=\fI[FILENAME]\fP
خروجی دادن شناسهٔ پنجرهٔ X Window کادر yad به فایل مشخص‌شده یا stderr.
.TP
.B \-\-plug=\fIKEY\fP
اجرای کادر محاوره در حالت plug جهت جاگذاری به عنوان یک تب notebook. برای اطلاعات بیشتر بخش \fINOTEBOOK\fP را ببینید.
.TP
.B \-\-tabnum=\fINUMBER\fP
تنظیم شمارهٔ تب برای کادر محاورهٔ متصل‌شده (plugged). برای اطلاعات بیشتر بخش \fINOTEBOOK\fP را ببینید.
.TP
.B \-\-text=\fISTRING\fP
تنظیم متن کادر محاوره.
.TP
.B \-\-text-width=\fINUMBER\fP
تنظیم حداکثر عرض متن کادر محاوره بر حسب نویسه.
.TP
.B \-\-text-align=\fITYPE\fP
تنظیم نوع تراز متن کادر محاوره. \fITYPE\fP می‌تواند \fIleft\fP، \fIright\fP، \fIcenter\fP یا \fIfill\fP باشد.
.TP
.B \-\-image=\fIIMAGE\fP
تنظیم تصویر کادر محاوره که در سمت چپ متن آن نمایش داده می‌شود.
\fIIMAGE\fP می‌تواند نام یک فایل یا نام یک آیکون از تم آیکون فعلی باشد.
.TP
.B \-\-icon-theme=\fITHEME\fP
استفاده از تم آیکون GTK مشخص‌شده به جای مقدار پیش‌فرض.
.TP
.B \-\-keep-icon-size
آیکون‌ها مقیاس‌بندی نشوند. این گزینه بر آیکون‌های خارج از تم آیکون تأثیر می‌گذارد.
.TP
.B \-\-expander=\fI[TEXT]\fP
پنهان کردن ویجت اصلی با یک گسترش‌دهنده (expander). \fITEXT\fP یک آرگومان اختیاری برای برچسب expander است.
.TP
.B \-\-button=\fIBUTTON:ID\fP
افزودن دکمه به کادر محاوره. می‌تواند چندین بار استفاده شود. \fIID\fP یک کد خروج یا یک دستور است.
\fIBUTTON\fP می‌تواند نام یک آیتم استاندارد (stock item) در yad برای دکمه‌های از پیش تعریف‌شده (مانند yad-close یا yad-ok) باشد، یا متنی در قالب
\fILABEL[!ICON[!TOOLTIP]]\fP که در آن `!' جداکنندهٔ بخش‌ها است.
فهرست کامل موارد پیش‌ساخته را می‌توان در بخش \fISTOCK ITEMS\fP یافت.
اگر هیچ دکمه‌ای مشخص نشود، دکمه‌های \fIOK\fP و \fICancel\fP استفاده می‌شوند. برای اطلاعات بیشتر بخش \fBEXIT STATUS\fP را ببینید.
اگر \fIID\fP مقداری غیرعددی داشته باشد، به عنوان یک دستور در نظر گرفته می‌شود و کلیک بر روی چنین دکمه‌ای کادر محاوره را نمی‌بندد.
.TP
.B \-\-no-buttons
دکمه‌ها نمایش داده نشوند.
.TP
.B \-\-buttons-layout=\fITYPE\fP
تنظیم نوع چیدمان دکمه‌ها. انواع ممکن عبارتند از: \fIspread\fP، \fIedge\fP، \fIstart\fP، \fIend\fP یا \fIcenter\fP.
پیش‌فرض \fIend\fP است.
.TP
.B \-\-no-markup
عدم استفاده از نشانه‌گذاری pango در متن کادر محاوره.
.TP
.B \-\-no-escape
در صورت فشرده شدن کلید \fIEscape\fP، کادر محاوره بسته نشود.
.TP
.B \-\-escape-ok
کلید \fIEscape\fP مانند فشردن دکمهٔ \fIOK\fP عمل کند.
.TP
.B \-\-always-print-result
چاپ نتیجه برای هر یک از کدهای بازگشتی. این گزینه در صورتی که زمان انقضا به پایان برسد یا کلید \fIEscape\fP فشرده شود، کار نمی‌کند.
.TP
.B \-\-use-interp=\fI[INTERP]\fP
همهٔ دستورها تحت مفسر مشخص‌شده اجرا شوند. مقدار پیش‌فرض \fIbash -c "%s"\fP است. این گزینه می‌تواند نیاز به نقل‌قول (quoting) را در دستورها کاهش دهد. اگر \fI%s\fP مشخص شده باشد، با دستور جایگزین خواهد شد.
در غیر این صورت، دستور به انتهای خط فرمان افزوده می‌شود.
.TP
.B \-\-uri-handler=\fICMD\fP
استفاده از \fICMD\fP به عنوان گردانندهٔ uri. به طور پیش‌فرض yad از پارامتر \fIopen-command\fP در تنظیمات استفاده می‌کند. مقدار URI جایگزین \fI%s\fP در رشتهٔ دستور می‌شود یا به عنوان آخرین بخش به خط فرمان اضافه می‌گردد.
.TP
.B \-\-f1-action=\fICMD\fP
تنظیم دستوری که هنگام فشردن کلید F1 اجرا می‌شود.
.TP
.B \-\-workdir=\fiPATH\fP
تنظیم دایرکتوری کاری فعلی به \fIPATH\fP.
.TP
.B \-\-borders=\fINUM\fP
تنظیم حاشیه‌های پنجرهٔ کادر محاوره.
.TP
.B \-\-sticky
نمایش پنجره در تمام میزکارهای کاری (desktops).
.TP
.B \-\-fixed
ثابت نگه داشتن عرض و ارتفاع پنجره.
.TP
.B \-\-center
قرار دادن پنجره در مرکز صفحهٔ نمایش.
.TP
.B \-\-mouse
قرار دادن پنجره زیر موقعیت اشاره‌گر موش (ماوس).
.TP
.B \-\-on-top
قرار دادن پنجره روی سایر پنجره‌ها.
.TP
.B \-\-undecorated
بدون تزیین کردن پنجره (حذف عنوان و کادرهای پنجره).
.TP
.B \-\-skip-taskbar
عدم نمایش پنجره در نوار وظیفه (taskbar) و پیجر (pager).
.TP
.B \-\-maximized
اجرای پنجرهٔ کادر محاوره در حالت بیشینه (maximized).
.TP
.B \-\-fullscreen
اجرای کادر محاوره در حالت تمام‌صفحه. این گزینه ممکن است روی همهٔ مدیران پنجره کار نکند.
.TP
.B \-\-window-type=\fITYPE\fP
ایجاد یک پنجره با نوع پنجرهٔ مشخص‌شده. \fITYPE\fP می‌تواند یکی از موارد \fInormal\fP، \fIdialog\fP، \fIutility\fP،
\fIdock\fP، \fIdesktop\fP، \fItooltip\fP، \fInotification\fP یا \fIsplash\fP باشد.
رفتار هر نوع پنجره به مدیر پنجرهٔ شما بستگی دارد. برای جزئیات به مشخصات EWMH مراجعه کنید.

\fIنکته:\fP مدیران پنجرهٔ کاشی‌ساز (tiling window managers) اغلب یک پنجرهٔ "dialog" را شناور (float) اما یک پنجرهٔ "normal" را کاشی‌بندی (tile) می‌کنند.
.TP
.B \-\-no-focus
پنجرهٔ کادر محاوره هرگز فوکوس را دریافت نکند.
.TP
.B \-\-close-on-unfocus
بستن پنجرهٔ کادر محاوره هنگامی که فوکوس را از دست می‌دهد.
.TP
.B \-\-selectable-labels
در صورت تنظیم، کاربر می‌تواند متن کادر محاوره را انتخاب کرده و در کلیپ‌بورد کپی کند.
این گزینه همچنین بر فیلدهای برچسب در کادر محاورهٔ فرم (form) اثر می‌گذارد.
.TP
.B \-\-image-path=\fIPATH\fP
افزودن مسیر مشخص‌شده به فهرست استاندارد دایرکتوری‌ها جهت جستجوی آیکون‌ها. این گزینه می‌تواند چندین بار استفاده شود.
.TP
.B \-\-rest=\fIFILENAME\fP
خواندن آرگومان‌های اضافی از فایل داده‌شده به جای خط فرمان. با هر خط از فایل به عنوان یک آرگومان مستقل رفتار می‌شود.
.TP
.B \-\-response=\fINUMBER\fP
تنظیم کد خروج پیش‌فرض به \fINUMBER\fP به جای \fI0\fP.
.TP
.B \-\-css=\fISTRING\fP
خواندن و تجزیهٔ شیوه‌نامه‌های اضافی CSS در GTK+ از دادهٔ ارائه‌شده. اگر \fISTRING\fP یک نام فایل باشد، محتوای فایل بارگذاری می‌شود. در غیر این صورت با \fISTRING\fP مانند داده‌های CSS برخورد می‌شود.
.TP
.B \-\-gtkrc=\fIFILENAME\fP (منسوخ‌شده)
خواندن و تجزیهٔ شیوه‌نامه‌های اضافی CSS در GTK+ از فایل داده‌شده. این گزینه منسوخ شده است. به جای آن از \fB--css\fP استفاده کنید.
.TP
.B \-\-hscroll-policy=\fITYPE\fP
تنظیم نوع خط‌مشی نوارهای پیمایش افقی. \fITYPE\fP می‌تواند یکی از مقادیر \fIauto\fP، \fIalways\fP یا \fInever\fP باشد. پیش‌فرض \fIauto\fP است.
.TP
.B \-\-vscroll-policy=\fITYPE\fP
تنظیم نوع خط‌مشی نوارهای پیمایش عمودی. \fITYPE\fP می‌تواند یکی از مقادیر \fIauto\fP، \fIalways\fP یا \fInever\fP باشد. پیش‌فرض \fIauto\fP است.
.TP
.B \-\-enable-spell
فعال کردن غلط‌یابی املایی در ویجت‌های textview.
.TP
.B \-\-spell-lang=\fILANGUAGE\fP
تنظیم زبان غلط‌یابی املایی به \fILANGUAGE\fP. به طور پیش‌فرض، زبان از لوکال (locale) فعلی حدس زده می‌شود. برای دریافت فهرست همهٔ زبان‌های ممکن از \fIyad-tools(1)\fP استفاده کنید..TP
.B \-\-bool-fmt=\fITYPE\fP
تنظیم نوع خروجی مقادیر بولی به \fITYPE\fP. انواع ممکن عبارتند از \fIT\fP، \fIt\fP، \fIY\fP، \fIy\fP، \fIO\fP، \fIo\fP و \fI1\fP.
.br
\fIT\fP و \fIt\fP \- برای جفت \fItrue/false\fP با حروف بزرگ/کوچک متناظر.
.br
\fIY\fP و \fIy\fP \- برای جفت \fIyes/no\fP با حروف بزرگ/کوچک متناظر.
.br
\fIO\fP و \fIo\fP \- برای جفت \fIon/off\fP با حروف بزرگ/کوچک متناظر.
.br
\fI1\fP \- برای جفت \fI1/0\fP.
.TP
.B \-\-write-settings
نوشتن تنظیمات yad در یک فایل. بخش \fBSETTINGS\fP را ببینید.

.SS گزینه‌های کادر گفتگوی سفارشی «درباره» (Custom about dialog options)
.TP
.B \-\-pname=\fISTRING\fP
تنظیم نام برنامه.
.TP
.B \-\-image=\fIIMAGE\fP
تنظیم نام آیکون برنامه.
.TP
.B \-\-pversion=\fISTRING\fP
تنظیم رشته نسخه برنامه.
.TP
.B \-\-copyright=\fISTRING\fP
تنظیم رشته حق نشر (کپی‌رایت) برنامه.
.TP
.B \-\-comments=\fISTRING\fP
تنظیم توضیحات تفصیلی برنامه.
.TP
.B \-\-license=\fISTRING\fP
تنظیم پروانه برنامه. مقدار این گزینه می‌تواند یکی از پروانه‌های از پیش تعریف‌شده (\fIGPL2\fP، \fIGPL3\fP، \fILGPL2\fP، \fILGPL3\fP، \fIBSD\fP، \fIMIT\fP یا \fIARTISTIC\fP)، نام فایلی حاوی متن پروانه یا یک رشته دلخواه باشد.
.TP
.B \-\-authors=\fISTRING\fP
تنظیم فهرست نویسندگان برنامه که با کاما از یکدیگر جدا شده‌اند.
.TP
.B \-\-website=\fIURI\fP
تنظیم پیوندی به وب‌سایت برنامه.
.TP
.B \-\-website-label=\fILABEL\fP
تنظیم برچسب پیوند وب‌سایت برنامه.

.SS گزینه‌های انتخاب برنامه (Application selection options)
.TP
.B \-\-enable-fallback
نمایش برنامه‌های جایگزین (fallback).
.TP
.B \-\-enable-other
نمایش سایر برنامه‌ها.
.TP
.B \-\-enable-all
نمایش تمام برنامه‌های موجود.
.TP
.B \-\-extened
نمایش اطلاعات گسترده درباره برنامه انتخاب‌شده. به‌طور پیش‌فرض تنها فایل اجرایی نمایش داده می‌شود. در حالت گسترده، فیلدهای خروجی عبارتند از نام، نام نمایشی، توضیحات، آیکون و فایل اجرایی.
.PP
آرگومان اضافی برای کادر گفتگوی برنامه، یک mime-type است. اگر mime-type مشخص نشود، از \fItext/plain\fP استفاده خواهد شد.

.SS گزینه‌های تقویم (Calendar options)
.TP
.B \-\-day=\fINUMBER\fP
تنظیم روز تقویم.
.TP
.B \-\-month=\fINUMBER\fP
تنظیم ماه تقویم.
.TP
.B \-\-year=\fINUMBER\fP
تنظیم سال تقویم.
.TP
.B \-\-date-format=\fIPATTERN\fP
تنظیم قالب تاریخ بازگردانده‌شده. مقدار پیش‌فرض \(aq%x\(aq است. برای جزئیات بیشتر \fIstrftime(3)\fP را ببینید.
.TP
.B \-\-show-weeks
نمایش شماره هفته‌ها در سمت چپ تقویم.
.TP
.B \-\-details=\fIFILENAME\fP
خواندن توضیحات روزها از \fIFILENAME\fP.
.PP
فایل حاوی جزئیات روزها باید در قالب زیر باشد:
.IP
<date> <description>
.PP
فیلد \fIdate\fP تاریخی در قالب مشخص‌شده با گزینه \fI\-\-date-format\fP است. فیلد \fIdescription\fP رشته‌ای شامل جزئیات تاریخ است که می‌تواند حاوی نشانه‌گذاری Pango باشد.
.TP
.B \-\-select-action=\fICOMMAND\fP
اجرای دستور مشخص‌شده هنگام انتخاب تاریخ. تاریخ انتخاب‌شده در قالب \fIYEAR MONTH DAY\fP به انتهای دستور اضافه می‌شود..SS گزینه‌های انتخاب رنگ
.TP
.B \-\-init\-color=\fICOLOR\fP
تنظیم مقدار رنگ اولیه.
.TP
.B \-\-gtk-palette
نمایش پالت سامانه درون گفتگوی رنگ. برای ساخت‌های GTK+3 این گزینه به جای ویرایشگر رنگ، پالت را نمایش می‌دهد.
.TP
.B \-\-picker
افزودن دکمه انتخابگر رنگ از صفحه (قطره‌چکان).
.TP
.B \-\-alpha
افزودن میزان کدر بودن (opacity) به رشته رنگ خروجی.
.TP
.B \-\-palette=\fI[FILENAME]\fP
نمایش پالت و تنظیم رنگ‌های از پیش تعریف‌شده از نام فایل ارائه‌شده.
به‌طور پیش‌فرض yad از فایل \fI/etc/X11/rgb.txt\fP استفاده می‌کند.
.TP
.B \-\-expand-palette
بازکننده (expander) فهرست رنگ‌های تعریف‌شده توسط کاربر در ابتدا باز خواهد بود.
.TP
.B \-\-mode=\fIMODE\fP
تنظیم حالت رنگ خروجی. مقادیر ممکن \fIhex\fP یا \fIrgb\fP هستند. پیش‌فرض \fIhex\fP است. حالت HEX به صورت \fI#rrggbbaa\fP و حالت RGB به صورت \fIrgba(r, g, b, a)\fP است.
در حالت RGBA، میزان کدر بودن مقداری بین 0.0 تا 1.0 دارد.

.SS گزینه‌های کادر کشیدن و رها کردن (Drag-and-Drop)
.TP
.B \-\-tooltip
استفاده از متن گفتگو به عنوان راهنمای متنی (tooltip) برای کادر کشیدن و رها کردن.
.TP
.B \-\-command=\fICMD\fP
اجرای دستور هنگام دریافت داده. رشته‌های داده به عنوان یک آرگومان به دستور ارسال می‌شوند یا جایگزین اصلاح‌کننده \fI%s\fP در دستور می‌شوند.
به‌طور پیش‌فرض داده‌ها صرفاً روی stdout چاپ می‌شوند.
.TP
.B \-\-exit-on-drop=\fINUMBER\fP
خروج پس از اینکه تعداد رها کردن‌ها به \fINUMBER\fP رسید. مقدار 0 به معنای تعداد نامحدود رها کردن است؛ این حالت پیش‌فرض است.

.SS گزینه‌های ورودی متن
.TP
.B \-\-entry-label=\fISTRING\fP
تنظیم متن برچسب ورودی.
.TP
.B \-\-entry-text=\fISTRING\fP
تنظیم متن اولیه ورودی یا مورد پیش‌فرض در جعبه ترکیبی (combo-box).
.TP
.B \-\-hide-text
پنهان کردن متن ورودی.
.TP
.B \-\-completion
استفاده از تکمیل خودکار به جای جعبه ترکیبی.
.TP
.B \-\-complete=\fITYPE\fP
استفاده از نوع مشخص برای تکمیل گسترده. \fITYPE\fP می‌تواند \fIany\fP برای تطابق با هر یک از کلمات تایپ‌شده، \fIall\fP برای تطابق با تمام کلمات تایپ‌شده یا
\fIregex\fP در حالتی باشد که با متن تایپ‌شده به عنوان یک عبارت باقاعده برخورد می‌شود.
.TP
.B \-\-editable
اجازه اعمال تغییرات در متن جعبه ترکیبی.
.TP
.B \-\-numeric
استفاده از دکمه چرخشی (spin button) به جای ورودی متن. پارامترهای اضافی در خط فرمان (به همان ترتیب) به عنوان مقادیر کمینه و بیشینه،
مقدار گام و دقت اعشار در نظر گرفته می‌شوند. تمام این مقادیر اختیاری هستند. محدوده پیش‌فرض از 0 تا 65535 با گام 1 است.
.TP
.B \-\-float-precision=\fINUMBER\fP
تنظیم دقت اعداد اعشاری ممیز شناور. به‌طور پیش‌فرض دقت سه رقم پس از ممیز است.
.TP
.B \-\-licon=\fIIMAGE\fP
تنظیم یک آیکون در سمت چپ ورودی.
.TP
.B \-\-licon-action=\fICMD\fP
تعیین دستوری که هنگام کلیک روی آیکون سمت چپ اجرا خواهد شد. خروجی دستور به عنوان متن ورودی تنظیم می‌شود.
.TP
.B \-\-ricon=\fIIMAGE\fP
تنظیم یک آیکون در سمت راست ورودی.
.TP
.B \-\-ricon-action=\fICMD\fP
تعیین دستوری که هنگام کلیک روی آیکون سمت راست اجرا خواهد شد. خروجی دستور به عنوان متن ورودی تنظیم می‌شود.
.TP
.B \-\-num-output
ارسال نمایه (index) عنصر فعال به خروجی به جای متن، برای ورودی جعبه ترکیبی.
.PP
هر داده اضافی که در خط فرمان مشخص شود، به عنوان مواردی از ورودی جعبه ترکیبی افزوده می‌شود، به جز در حالت عددی.

اگر آیکون مشخص شده باشد اما عملیاتی برای آن تعیین نشده باشد، کلیک روی آیکون صرفاً ورودی را پاک می‌کند.
فیلدهای عددی آیکون‌ها را نادیده خواهند گرفت..SS گزینه‌های جعبه‌آیکون (Iconbox options)
.TP
.B \-\-read-dir=\fIPATH\fP
خواندن فایل‌های .desktop از دایرکتوری مشخص‌شده.
.TP
.B \-\-monitor
نظارت بر تغییرات دایرکتوری و به‌روزرسانی خودکار محتوای جعبه‌آیکون.
.TP
.B \-\-generic
استفاده از فیلد GenericName به جای Name برای برچسب میانبر.
.TP
.B \-\-sort-by-name
استفاده از فیلد Name به جای نام فایل برای مرتب‌سازی موارد.
.TP
.B \-\-descend
مرتب‌سازی موارد به صورت نزولی. اگر داده‌ها از stdin خوانده شوند، این گزینه بدون \fI\-\-sort-by-name\fP بی‌اثر خواهد بود.
.TP
.B \-\-listen
خواندن داده‌ها از stdin. داده‌ها باید به ترتیبِ \fIName\fP، \fITooltip\fP، \fIIcon\fP، \fICommand\fP و \fIInTerm\fP باشند که با خط جدید جدا شده‌اند. \fIInTerm\fP یک ثابت بولی غیرحساس به بزرگ و کوچکی حروف (\fITRUE\fP یا \fIFALSE\fP) است. ارسال نویسهٔ \fIFormFeed\fP محتوای جعبه‌آیکون را پاک می‌کند.
.TP
.B \-\-item-width
تنظیم عرض موارد.
.TP
.B \-\-icon-size
اجبار به استفاده از اندازهٔ آیکون مشخص‌شده. این گزینه در حالت فشرده (compact) کار نمی‌کند.
.TP
.B \-\-compact
استفاده از حالت فشرده. آیکون و نام هر مورد در یک ردیف تکی قرار می‌گیرد.
.TP
.B \-\-single-click
فعال‌سازی موارد با یک‌بار کلیک ماوس. این گزینه ممکن است در حالت فشرده به درستی کار نکند.
.TP
.B \-\-term
الگو برای ترمینال. به‌طور پیش‌فرض از `xterm \-e %s' استفاده می‌شود که در آن %s با دستور جایگزین خواهد شد.
.PP
اگر هم دایرکتوری و هم stdin مشخص شده باشند، محتوای جعبه‌آیکون از دایرکتوری خوانده خواهد شد.

.SS گزینه‌های انتخاب فایل (File selection options)
.TP
.B \-\-filename=\fIFILENAME\fP
تنظیم نام فایل.
.TP
.B \-\-multiple
امکان انتخاب چند نام فایل در گفتگوی انتخاب فایل.
.TP
.B \-\-directory
فعال‌سازی حالت انتخاب فقط دایرکتوری.
.TP
.B \-\-save
فعال‌سازی حالت ذخیره.
.TP
.B \-\-separator=\fISTRING\fP
تعیین نویسهٔ جداکننده هنگام بازگرداندن چندین نام فایل.
.TP
.B \-\-confirm\-overwrite=\fI[TEXT]\fP
تأیید انتخاب فایل در صورتی که نام فایل از قبل وجود داشته باشد.
آرگومان اختیاری، متنی برای پنجرهٔ گفتگوی تأیید است.
.TP
.B \-\-quoted-output
مقدارهای خروجی به سبک شل درون علامت نقل‌قول قرار می‌گیرند.

.SS گزینه‌های انتخاب قلم (Font selection options)
.TP
.B \-\-fontname=\fIFONTNAME\fP
تنظیم قلم اولیه. \fIFONTNAME\fP رشته‌ای با نمایش قلم در قالب \fI"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]"\fP است.
.TP
.B \-\-preview
تنظیم متن پیش‌نمایش.
.TP
.B \-\-separate-output
جداسازی خروجیِ توضیحات قلم انتخاب‌شده.
.TP
.B \-\-separator=\fISTRING\fP
تنظیم نویسهٔ جداکنندهٔ خروجی. پیش‌فرض `|' است.
.TP
.B \-\-quoted-output
داده‌های خروجی در قالب نقل‌قول‌های شل خواهند بود..SS "گزینه‌های فرم (Form options)"
.TP
.B \-\-field=\fILABEL[!TOOLTIP][:TYPE]\fP
افزودن فیلد به فرم. نوع می‌تواند \fIH\fP، \fIRO\fP، \fINUM\fP، \fICHK\fP، \fICB\fP، \fICBE\fP، \fICE\fP، \fIFL\fP، \fISFL\fP، \fIDIR\fP، \fICDIR\fP، \fIFN\fP، \fIMFL\fP، \fIMDIR\fP، \fIDT\fP، \fISCL\fP، \fISW\fP، \fIAPP\fP، \fIICON\fP، \fICLR\fP، \fIBTN\fP، \fIFBTN\fP، \fILINK\fP، \fILBL\fP یا \fITXT\fP باشد.
.br
\fBH\fP \- نوع فیلد پنهان. تمام نویسه‌ها به عنوان نویسه نامرئی نمایش داده می‌شوند.
.br
\fBRO\fP \- فیلد در حالت فقط‌خواندنی است.
.br
\fBNUM\fP \- فیلد عددی است. قالب مقدار اولیه برای این فیلد \fIVALUE[!RANGE[!STEP![PREC]]]\fP است، که در آن \fIRANGE\fP باید به صورت \fIMIN..MAX\fP باشد. `!' جداکننده پیش‌فرض موارد است. \fIPREC\fP دقت ارقام اعشاری است.
.br
\fBCHK\fP \- فیلد چک‌باکس (جعبه علامت‌زدن). مقدار اولیه یک مقدار ثابت بولی بدون حساسیت به حروف کوچک و بزرگ (\fITRUE\fP یا \fIFALSE\fP) است.
.br
\fBCB\fP \- فیلد جعبه کشویی (combo-box). مقدار اولیه فهرستی به صورت \fIVAL1!VAL2!...\fP است. جداکننده همانند فیلد \fINUM\fP است. مقداری که با `^' شروع شود، به عنوان مقدار پیش‌فرض جعبه کشویی در نظر گرفته می‌شود.
.br
\fBCBE\fP \- فیلد جعبه کشویی قابل ویرایش. مقدار اولیه همانند جعبه کشویی است.
.br
\fBCE\fP \- فیلد ورودی با تکمیل خودکار (completion). مقدار اولیه همانند جعبه کشویی است.
.br
\fBFL\fP \- دکمه انتخاب فایل.
.br
\fBSFL\fP \- فیلد برای ایجاد فایل.
.br
\fBDIR\fP \- دکمه انتخاب دایرکتوری.
.br
\fBCDIR\fP \- فیلد برای ایجاد پوشه.
.br
\fBFN\fP \- دکمه انتخاب قلم (فونت). مقدار اولیه همانند کادر محاوره‌ای قلم است.
.br
\fBMFL\fP \- انتخاب چندین فایل. مقدار این فیلد فهرستی از فایل‌ها است که با \fIitem-separator\fP جدا شده‌اند.
.br
\fBMDIR\fP \- انتخاب چندین پوشه. مقدار این فیلد فهرستی از پوشه‌ها است که با \fIitem-separator\fP جدا شده‌اند.
.br
\fBDT\fP \- فیلد تاریخ.
.br
\fBSCL\fP \- فیلد مقیاس (scale). مقدار این فیلد در محدوده 0..100 است.
.br
\fBSW\fP \- فیلد سوئیچ (کلید تبدیل). مقدار اولیه یک مقدار ثابت بولی بدون حساسیت به حروف کوچک و بزرگ (\fITRUE\fP یا \fIFALSE\fP) است.
.br
\fBAPP\fP \- دکمه انتخاب برنامه کاربردی. مقدار ورودی برای این فیلد mime-type است. مقدار خروجی \- فایل اجرایی برنامه انتخاب‌شده.
.br
\fBICON\fP \- فیلد آیکون. مانند فیلد ورودی معمول است اما دو آیکون دارد. آیکون سمت چپ، آیکون فعلی را نمایش می‌دهد و آیکون سمت راست قابل کلیک است و \fIyad-con-browser\fP را برای انتخاب آیکون فراخوانی می‌کند.
.br
\fBCLR\fP \- دکمه انتخاب رنگ. مقادیر خروجی برای این فیلد به همان شیوه کادر محاوره‌ای رنگ تولید می‌شوند.
.br
\fBBTN\fP \- فیلد دکمه. برچسب می‌تواند به شکل متنی با ساختار \fILABEL[!ICON[!TOOLTIP]]\fP باشد که در آن `!' جداکننده موارد است. \fILABEL\fP متن برچسب دکمه یا stock id مربوط به yad است. \fIICON\fP آیکون دکمه است (stock id یا نام فایل). \fITOOLTIP\fP متنی اختیاری برای رشته راهنمای بازشو (tooltip) است. مقدار اولیه، دستوری است که هنگام کلیک روی دکمه اجرا می‌شود. نمادهای ویژه \fI%N\fP در دستور با مقدار فیلد \fIN\fP جایگزین می‌شوند. اگر دستور با \fI@\fP شروع شود، خروجی دستور پردازش شده و خطوطی که با عدد و دونقطه شروع می‌شوند به عنوان مقادیر جدید فیلدها در نظر گرفته خواهند شد.
سبک نقل‌قول برای مقادیر هنگام استفاده از \fIsh -c\fP عبارت است از \- نقل‌قول تکی در اطراف دستور و نقل‌قول دوتایی در اطراف آرگومان \-c. دستور ویژه \fIquit\fP کادر محاوره‌ای را به روش معمول می‌بندد.
.br
\fBFBTN\fP \- مشابه فیلد دکمه، اما با برجستگی کامل (full relief) دکمه.
.br
\fBLINK\fP \- فیلد دکمه پیوند.
.br
\fBLBL\fP \- برچسب متنی. اگر نام فیلد خالی باشد، یک خط جداکننده افقی نمایش داده خواهد شد.
.br
\fBTXT\fP \- ورودی متنی چندخطی. این فیلد همیشه تمام عرض فرم را اشغال می‌کند.

بدون نوع، فیلد یک ورودی متنی ساده خواهد بود.
.TP
.B \-\-align=\fITYPE\fP
تنظیم تراز برچسب‌های فیلد. انواع ممکن عبارتند از \fIleft\fP، \fIcenter\fP یا \fIright\fP. پیش‌فرض left است.
.TP
.B \-\-columns=\fINUMBER\fP
تنظیم تعداد ستون‌ها در فرم. فیلدها از بالا به پایین قرار خواهند گرفت.
.TP
.B \-\-separator=\fISTRING\fP
تنظیم نویسه جداکننده خروجی. پیش‌فرض `|' است.
.TP
.B \-\-focus-field=\fINUMBER\fP
تنظیم فیلد دارای تمرکز (فوکوس).
.TP
.B \-\-cycle-read
خواندن چرخشی داده‌های stdin. ارسال نویسه FormFeed فرم را پاک می‌کند. این نماد می‌تواند با \fIecho \-e '\\f'\fP ارسال شود.
.TP
.B \-\-align-buttons
تراز کردن برچسب‌ها در فیلدهای دکمه با توجه به تنظیمات \fI\-\-align\fP.
.TP
.B \-\-item-separator=\fISTRING\fP
تنظیم نویسه جداکننده برای مقادیر جعبه کشویی یا مقیاس. پیش‌فرض `!' است.
.TP
.B \-\-date-format=\fIPATTERN\fP
تنظیم قالب برای فیلدهای تاریخ (مشابه کادر محاوره‌ای تقویم).
.TP
.B \-\-float-precision=\fINUMBER\fP
تنظیم دقت اعداد ممیز شناور. به صورت پیش‌فرض، دقت سه رقم بعد از ممیز است.
.TP
.B \-\-complete=\fITYPE\fP
استفاده از نوع مشخص برای تکمیل خودکار پیشرفته. \fITYPE\fP می‌تواند \fIany\fP برای مطابقت با هر یک از کلمات تایپ‌شده، \fIall\fP برای مطابقت با تمام کلمات تایپ‌شده یا \fIregex\fP باشد که در آن متن تایپ‌شده به عنوان یک عبارت منظم در نظر گرفته می‌شود.
.TP
.B \-\-scroll
پیمایش‌پذیر کردن فرم (قابلیت اسکرول).
.TP
.B \-\-homogeneous
یکسان کردن اندازه ارتفاع فیلدهای فرم و پهنای ستون‌ها.
.TP
.B \-\-changed-action=\fICMD\fP
اجرای \fICMD\fP در هنگام تغییر مقدار فیلدهای \fICHK\fP، \fICB\fP یا \fISW\fP. دستور با دو آرگومان اجرا می‌شود \- شماره فیلد تغییریافته و مقدار فعلی آن.
خروجی دستور به همان صورت فیلدهای \fIBTN\fP با پیشوند \fI@\fP پردازش می‌شود. \fBتوجه\fP \- این گزینه ممکن است سرعت کادر محاوره‌ای شما را کاهش دهد.
.TP
.B \-\-quoted-output
مقادیر خروجی درون نقل‌قول‌هایی به سبک پوسته (shell-style quotes) خواهند بود.
.TP
.B \-\-output-by-row
خروجی دادن مقادیر فیلدها به صورت سطر به سطر در صورتی که چندین ستون مشخص شده باشد.
.TP
.B \-\-num-output
خروجی دادن اندیس عنصر فعال به جای متن برای فیلدهای جعبه کشویی (combo-box).
.PP
داده‌های اضافی در خط فرمان به عنوان مقادیر پیش‌فرض برای فیلدهای فرم تفسیر می‌شوند. مقدار ویژه \fI@disabled@\fP فیلد متناظر را غیرفعال می‌کند. اگر هیچ آرگومان اضافی در خط فرمان مشخص نشده باشد، داده‌ها از stdin، یک مقدار در هر خط خوانده می‌شوند. خواندن چرخشی به این معناست که برای \fIN\fP فیلد، مقدار \fIN+1\fP جایگزین فیلد اول خواهد شد. مقادیر خالی هنگام خواندن از stdin نادیده گرفته می‌شوند..SS گزینه‌های HTML (HTML options)
.TP
.B \-\-uri=\fIURI\fP
مکان مشخص‌شده را باز می‌کند. \fIURI\fP می‌تواند نام یک فایل یا یک نشانی اینترنتی باشد. اگر \fIURI\fP یک فایل موجود نباشد و پروتکل مشخص نشده باشد، پیشوند \fIhttp://\fP به \fIURI\fP افزوده خواهد شد.
.TP
.B \-\-browser
حالت مرورگر را فعال می‌کند. در این حالت، تمام پیوندهای کلیک‌شده در ویجت html باز می‌شوند و دستور \fIOpen\fP به منوی زمینه‌ای اضافه خواهد شد.
.TP
.B \-\-print-uri
پیوندهای کلیک‌شده را در خروجی استاندارد چاپ می‌کند. به‌طور پیش‌فرض، پیوندهای کلیک‌شده با \fIxdg-open\fP باز می‌شوند.
.TP
.B \-\-mime=\fIMIME\fP
نوع mime داده‌های ارسال‌شده به ورودی استاندارد را روی \fIMIME\fP تنظیم می‌کند. پیش‌فرض \fItext/html\fP است.
.TP
.B \-\-encoding=\fIENCODING\fP
کدگذاری داده‌های ارسال‌شده به ورودی استاندارد را روی \fIENCODING\fP تنظیم می‌کند. پیش‌فرض \fIUTF-8\fP است.
.TP
.B \-\-uri-handler=\fICMD\fP
گرداننده خارجی برای uri کلیک‌شده تعیین می‌کند. \fI%s\fP با uri فعال‌شده جایگزین خواهد شد. کد بازگشتی \fICMD\fP برای ادامه کار باید \fI0\fP، برای نادیده گرفتن uri برابر با \fI1\fP و برای بارگیری uri برابر با \fI2\fP باشد. این گزینه فقط در حالت مرورگر کار می‌کند. دو متغیر محیطی در گرداننده در دسترس است \- \fIYAD_HTML_BUTTON\fP با مقدار کلید ماوس فشرده‌شده و \fIYAD_HTML_STATE\fP با مقدار ماسک بیتیِ وضعیت کلیدهای تبدیل (modifier keys).
.TP
.B \-\-user-agent=\fISTRING\fP
رشته عامل کاربر (user agent) را تنظیم می‌کند. پیش‌فرض \fIYAD-Webkit (@VERSION@)\fP است.
.TP
.B \-\-user-style=\fISTRING\fP
شیوه‌نامه‌های سفارشی کاربر را از فایل یا داده‌های دلخواه بارگیری می‌کند. \fISTRING\fP می‌تواند مسیری به یک فایل محلی حاوی کد CSS یا خود کد CSS باشد.
.TP
.B \-\-disable-search
نوار جستجو را غیرفعال می‌کند.
.TP
.B \-\-file-op
عملیات فایل را فعال می‌کند. این گزینه آیتم open را به منوی بازشو اضافه می‌کند.
.TP
.B \-\-wk-prop=\fIPROP\fP
تنظیمات اضافی WebKit را اعمال می‌کند. این گزینه می‌تواند چندین بار استفاده شود. تنظیم \fIPROP\fP باید در قالب "setting-name value" باشد. اولین نویسه از مقدار باید شناسه نوع باشد: \fIb\fP برای مقادیر بولی، \fIi\fP برای اعداد صحیح و \fIs\fP برای رشته‌ها. پس از آن خود مقادیر به دنبال یک دو‌نقطه می‌آیند. فهرستی از تنظیمات ممکن در این صفحه قابل مشاهده است \- https://webkitgtk.org/reference/webkit2gtk/stable/WebKitSettings.html
.PP
هنگامی که کادر محاوره‌ای در حالت مرورگر کار می‌کند، داده‌های اضافی در خط فرمان به‌عنوان \fIURI\fP تفسیر می‌شوند.

.SS گزینه‌های فهرست (List options)
.TP
.B \-\-column=\fISTRING[:TYPE]\fP
سربرگ ستون را تعیین می‌کند. انواع عبارتند از: \fITEXT\fP، \fINUM\fP، \fISZ\fP، \fIFLT\fP، \fICHK\fP، \fIRD\fP، \fIBAR\fP، \fIIMG\fP، \fIHD\fP یا \fITIP\fP.
نوع \fITEXT\fP پیش‌فرض است. از \fINUM\fP برای اعداد صحیح و از \fIFLT\fP برای مقادیر اعشاری مضاعف استفاده کنید. \fITIP\fP برای تعریف ستون راهنمای ابزار (tooltip) به‌کار می‌رود.
نوع ستون اندازه \fISZ\fP دقیقاً مانند ستون \fINUM\fP عمل می‌کند اما به جای اعداد، اندازه‌ها را با فرمت خوانا برای انسان نمایش می‌دهد.
ستون‌های \fICHK\fP (جعبه‌های علامت‌زدن) و \fIRD\fP (دکمه رادیویی) ستون‌های بولی هستند.
\fIBAR\fP یک ستون نوار پیشرفت است. مقدار باید بین \fI0\fP و \fI100\fP باشد. اگر مقدار خارج از این بازه باشد، به نزدیک‌ترین مقدار مجاز برش می‌خورد.
نوع \fIHD\fP نشان‌دهنده یک ستون پنهان است. چنین ستون‌هایی در فهرست نمایش داده نمی‌شوند، بلکه فقط در خروجی ظاهر می‌شوند.
\fIIMG\fP می‌تواند مسیری به یک تصویر یا نام نماد از تم نماد فعلی GTK+ باشد.
اندازه نمادها می‌تواند در فایل پیکربندی gtk در موقعیت GTK_ICON_SIZE_MENU از gtk-icon-sizes تنظیم شود. تصاویری که با نام نماد مشخص شده‌اند به \fIGTK_ICON_SIZE_MENU\fP مقیاس‌بندی می‌شوند، مگر اینکه گزینه \-\-force-icon-size تنظیم شده باشد. فیلد تصویر به عنوان یک مقدار خالی چاپ می‌شود.

نام‌های ستون ویژه \fI@fore@\fP، \fI@back@\fP و \fI@font@\fP ویژگی‌های سطرهای مربوطه را تنظیم می‌کنند.
مقادیر این ستون‌ها در نتایج نمایش داده نمی‌شوند.

عنوان ستون می‌تواند در قالب \fIname!tooltip\fP مشخص شود و از نشانه‌گذاری پنگو (Pango markup) می‌توان در بخش‌های \fIname\fP و \fItooltip\fP استفاده کرد.
.TP
.B \-\-tree
حالت درختی را فعال می‌کند. در این حالت داده‌های اضافی به شکل \fIROW_ID[:PARENT_ID]\fP باید قبل از هر سطر به yad ارسال شود. برای جزئیات بخش \fBمثال‌ها (EXAMPLES)\fP را ببینید.
.TP
.B \-\-checklist
از جعبه‌های علامت‌زدن برای ستون اول استفاده می‌کند. سطرهای تیک‌خورده را به جای سطرهای انتخاب‌شده خروجی می‌دهد. انتخاب چندگانه را غیرفعال می‌کند.
.TP
.B \-\-radiolist
مشابه \fI\-\-checklist\fP است اما با یک دکمه رادیویی برای ستون اول.
.TP
.B \-\-separator=\fISTRING\fP
نویسه‌های جداکننده خروجی را تنظیم می‌کند.
.TP
.B \-\-multiple
امکان انتخاب همزمان چندین سطر را فراهم می‌کند.
.TP
.B \-\-editable
امکان تغییر متن را فراهم می‌کند.
.TP
.B \-\-editable-cols=\fILIST\fP
فهرست ستون‌های قابل ویرایش را تنظیم می‌کند. \fILIST\fP باید رشته‌ای از اعداد باشد که با کاما از هم جدا شده‌اند.
.TP
.B \-\-no-headers
سربرگ‌های ستون را نشان نمی‌دهد.
.TP
.B \-\-no-click
مرتب‌سازی محتوای ستون با کلیک روی سربرگ آن را غیرفعال می‌کند.
.TP
.B \-\-no-rules-hint
سطرهای زوج و فرد را با رنگ‌های متفاوت رسم نمی‌کند. این گزینه به تم gtk فعلی شما بستگی دارد و ممکن است عمل نکند.
.TP
.B \-\-grid-lines=\fITYPE\fP
خطوط شبکه از نوع \fITYPE\fP را در کادر محاوره‌ای فهرست رسم می‌کند. \fITYPE\fP می‌تواند یکی از موارد \fIhor[izontal]\fP، \fIvert[ical]\fP یا \fIboth\fP باشد.
.TP
.B \-\-no-selection
قابلیت انتخاب را در فهرست غیرفعال می‌کند.
.TP
.B \-\-print-all
تمام داده‌های فهرست را چاپ می‌کند.
.TP
.B \-\-print-column=\fINUMBER\fP
مشخص می‌کند کدام ستون در خروجی استاندارد چاپ شود. \fI0\fP می‌تواند برای چاپ تمام ستون‌ها استفاده شود (این حالت پیش‌فرض است).
.TP
.B \-\-hide\-column=\fINUMBER\fP
ستون مشخص‌شده را پنهان می‌کند.
.TP
.B \-\-expand\-column=\fINUMBER\fP
ستون را به‌طور پیش‌فرض گسترش‌پذیر می‌کند. \fI0\fP همه ستون‌ها را گسترش‌پذیر تنظیم می‌کند.
.TP
.B \-\-search\-column=\fINUMBER\fP
ستون جستجوی سریع را تعیین می‌کند. \fI0\fP به معنای غیرفعال کردن جستجو است. به‌طور پیش‌فرض جستجو روی ستون اول انجام می‌شود.
.TP
.B \-\-tooltip\-column=\fINUMBER\fP
ستون حاوی راهنمای ابزار بازشو را مشخص می‌کند.
.TP
.B \-\-sep\-column=\fINUMBER\fP
ستون جداکننده سطر را مشخص می‌کند. اگر مقدار خانه از این ستون برابر با مقدار جداکننده سطر مشخص‌شده باشد، چنین سطری به عنوان جداکننده رسم خواهد شد. مقدار جداکننده سطر باید تعیین شده باشد.
.TP
.B \-\-sep\-value=\fITEXT\fP
مقدار \fITEXT\fP را به عنوان مقدار جداکننده سطر تعیین می‌کند. این قابلیت وابستگی زیادی به تم GTK+ فعلی شما دارد و ممکن است به درستی کار نکند.
.TP
.B \-\-limit=\fINUMBER\fP
تعداد سطرهای کادر محاوره‌ای فهرست را تعیین می‌کند. تنها آخرین \fINUMBER\fP سطر نمایش داده خواهند شد. این گزینه تنها زمانی اعمال می‌شود که داده‌ها از stdin خوانده شوند.
.TP
.B \-\-wrap-width=\fINUMBER\fP
پهنای ستون پیش از پیچش خطوط را روی \fINUMBER\fP تنظیم می‌کند.
.TP
.B \-\-wrap-cols=\fILIST\fP
فهرست ستون‌های دارای پیچش خط را تنظیم می‌کند. \fILIST\fP باید رشته‌ای از اعداد جداشده با کاما باشد.
.TP
.B \-\-ellipsize=\fITYPE\fP
حالت کوتاه‌سازی متن با سه‌نقطه (ellipsize) را برای ستون‌های متنی تعیین می‌کند. \fITYPE\fP می‌تواند \fINONE\fP، \fISTART\fP، \fIMIDDLE\fP یا \fIEND\fP باشد.
.TP
.B \-\-ellipsize-cols=\fILIST\fP
فهرست ستون‌های دارای کوتاه‌سازی را تنظیم می‌کند. \fILIST\fP باید رشته‌ای از اعداد جداشده با کاما باشد.
.TP
.B \-\-dclick-action=\fICMD\fP
دستور \fICMD\fP را به عنوان دستور دوبار کلیک تعیین می‌کند. وقتی کاربر روی سطری دوبار کلیک کند، \fICMD\fP با مقادیر همه ستون‌ها به عنوان آرگومان اجرا خواهد شد. به‌طور پیش‌فرض، دوبار کلیک سطر را انتخاب کرده و برای فهرست‌های ساده مانند دکمه \fIOK\fP عمل می‌کند، اگر \fI\-\-checklist\fP مشخص شده باشد جعبه علامت را تیک می‌زند و هنگامی که فهرست با گزینه \fI\-\-multiple\fP اجرا شده باشد کاری انجام نمی‌دهد.
وقتی دوبار کلیک تعیین شده باشد، کلید \fIEnter\fP به عنوان دوبار کلیک و کلید ترکیبی \fICtrl+Enter\fP به عنوان دکمه \fIOK\fP عمل می‌کند.
\fICMD\fP می‌تواند شامل نویسه ویژه '%s' برای تعیین جایگاه آرگومان‌ها باشد. به‌طور پیش‌فرض آرگومان‌ها به انتهای \fICMD\fP الحاق خواهند شد.
اگر \fICMD\fP با \fI@\fP شروع شود، خروجی آن جایگزین مقادیر سطر فعلی خواهد شد.
این گزینه با \fI--editable\fP کار نمی‌کند.
.TP
.B \-\-select-action=\fICMD\fP
دستور \fICMD\fP را به عنوان عملیاتی که هنگام تغییر انتخاب رخ می‌دهد تعیین می‌کند. \fICMD\fP با مقادیر همه ستون‌ها به عنوان آرگومان اجرا خواهد شد.
\fICMD\fP می‌تواند شامل نویسه ویژه '%s' برای تعیین جایگاه آرگومان‌ها باشد. به‌طور پیش‌فرض آرگومان‌ها به انتهای \fICMD\fP الحاق خواهند شد.
این گزینه با \fI--multiple\fP کار نمی‌کند.
.TP
.B \-\-row-action=\fICMD\fP
دستور \fICMD\fP را به عنوان عملیاتی که هنگام افزودن، ویرایش یا حذف سطر اجرا می‌شود تعیین می‌کند. نخستین آرگومان دستور، نام عملیات است (\fIadd\fP، \fIedit\fP یا \fIdel\fP).
بقیه خط فرمان داده‌های سطر انتخاب‌شده هستند. خروجی این دستور مقادیر سطر جدید را تعیین می‌کند.
.TP
.B \-\-tree-expanded
تمام گره‌های درخت را در هنگام راه‌اندازی باز (گسترده) می‌کند.
.TP
.B \-\-regex-search
از عبارت‌های منظم در جستجو برای فیلدهای متنی استفاده می‌کند.
.TP
.B \-\-listen
به داده‌ها از ورودی استاندارد (stdin) گوش می‌دهد، حتی اگر مقادیر خط فرمان مشخص شده باشند.
.TP
.B \-\-quoted-output
مقادیر خروجی به سبک شل داخل علامت نقل‌قول قرار می‌گیرند.
.TP
.B \-\-float-precision=\fINUMBER\fP
دقت اعداد ممیز شناور را تعیین می‌کند. به‌طور پیش‌فرض دقت سه رقم اعشار پس از ممیز است.
.TP
.B \-\-add-on-top
رکوردهای جدید را در بالای فهرست اضافه می‌کند.
.TP
.B \-\-tail | \-\-auto-scroll
پیمایش خودکار به انتهای فهرست هنگام اضافه شدن یک سطر جدید.
.TP
.B \-\-iec-format
از واحدهای استاندارد IEC (بر پایه ۱۰۲۴) برای مقادیر اندازه استفاده می‌کند. با این گزینه مقادیر دارای پسوندهای KiB، MiB و GiB خواهند بود.
.TP
.B \-\-simple-tips
از نشانه‌گذاری در راهنمای ابزار استفاده نمی‌کند، حتی اگر متن دارای نشانه‌گذاری معتبر باشد.
.TP
.B \-\-header-tips
از نام سربرگ به عنوان متن پشتیبان راهنمای ابزار استفاده می‌کند.
.TP
.B \-\-column-align=\fISTRING\fP
تراز محتوای ستون‌ها را تنظیم می‌کند. \fISTRING\fP باید شامل آرایه‌ای از حروف \fIl\fP، \fIr\fP یا \fIc\fP برای تراز چپ، راست یا وسط باشد.
.TP
.B \-\-header-align=\fISTRING\fP
تراز سربرگ‌های ستون را تنظیم می‌کند. \fISTRING\fP مشابه با \fB\-\-column-align\fP است..PP
ارسال نویسهٔ FormFeed به فهرست، آن را پاک می‌کند. این نماد می‌تواند با \fIecho \-e '\\f'\fP ارسال شود.

.SS گزینه‌های Notebook (Notebook options)
.TP
.B \-\-key=\fIKEY\fP
تنظیم کلید فرزندان.
.TP
.B \-\-tab=\fITEXT\fP
افزودن زبانه با برچسب مشخص‌شده به notebook. مقدار \fITEXT\fP می‌تواند در قالب \fILABEL[!ICON[!TOOLTIP]]\fP باشد که در آن «!» جداکنندهٔ موارد است.
برای حالت stack، مقدار \fITEXT\fP برای برچسب همان‌گونه که هست استفاده می‌شود.
.TP
.B \-\-tab-pos=\fITYPE\fP
تنظیم موقعیت زبانه‌ها. مقدار می‌تواند \fItop\fP، \fIbottom\fP، \fIleft\fP یا \fIright\fP باشد. پیش‌فرض \fItop\fP است.
برای حالت stack فقط موقعیت‌های \fItop\fP یا \fIbottom\fP در دسترس هستند.
.TP
.B \-\-tab-borders=\fINUMBER\fP
تنظیم پهنای کادر دور ویجت در زبانه‌ها.
.TP
.B \-\-active-tab=\fINUMBER\fP
تنظیم زبانهٔ فعال.
.TP
.B \-\-expand
گسترش دادن همهٔ زبانه‌ها به تمام پهنای پنجرهٔ گفتگو.
.TP
.B \-\-stack
استفاده از حالت پشته (GtkStack به‌جای GtkNotebook).
.PP
برای اطلاعات بیشتر دربارهٔ گفتگوی notebook، بخش \fBNOTEBOOK and PANED\fP را ببینید.

.SS گزینه‌های اعلان (Notification options)
.TP
.B \-\-command=\fICMD\fP
تنظیم دستوری که هنگام کلیک روی آیکون اجرا می‌شود. اگر \fI\-\-listen\fP مشخص نشده باشد، کنش پیش‌فرض \fIquit\fP است.
.TP
.B \-\-listen
گوش دادن به دستورها در stdin. بخش \fBNOTIFICATION\fP را ببینید.
.TP
.B \-\-menu=\fISTRING\fP
تنظیم منوی اولیه برای راست‌کلیک.
.TP
.B \-\-separator=\fISTRING\fP
تنظیم نویسهٔ جداکننده برای مقادیر منو. پیش‌فرض \fI|\fP است.
.TP
.B \-\-item-separator=\fISTRING\fP
تنظیم نویسهٔ جداکننده برای موارد منو. پیش‌فرض \fI!\fP است.
.TP
.B \-\-no-middle
غیرفعال‌سازی خروج با کلیک وسط.
.TP
.B \-\-hidden
عدم نمایش آیکون هنگام راه‌اندازی.
.TP
.B \-\-icon-size=\fISIZE\fP
تنظیم اندازهٔ آیکون اعلان به \fISIZE\fP. این گزینه برای آیکون‌های تم‌دار کار نمی‌کند.
.PP
برای اطلاعات بیشتر دربارهٔ جداکننده‌ها، بخش \fBNOTIFICATION\fP را ببینید.

.SS گزینه‌های Appindicator (Appindicator options)
.TP
.B \-\-listen
گوش دادن به دستورها در stdin. بخش \fBNOTIFICATION\fP را ببینید.
.TP
.B \-\-menu=\fISTRING\fP
تنظیم منوی اولیه برای راست‌کلیک.
.TP
.B \-\-separator=\fISTRING\fP
تنظیم نویسهٔ جداکننده برای مقادیر منو. پیش‌فرض \fI|\fP است.
.TP
.B \-\-item-separator=\fISTRING\fP
تنظیم نویسهٔ جداکننده برای موارد منو. پیش‌فرض \fI!\fP است.
.TP
.B \-\-hidden
عدم نمایش آیکون هنگام راه‌اندازی.

.SS گزینه‌های Paned (Paned options)
.TP
.B \-\-key=\fIKEY\fP
تنظیم کلید فرزندان.
.TP
.B \-\-orient=\fITYPE\fP
تنظیم جهت‌گیری قاب‌ها درون پنجرهٔ گفتگو. مقدار \fITYPE\fP می‌تواند \fIhor[izontal]\fP یا \fIvert[ical]\fP باشد.
.TP
.B \-\-splitter=\fIPOS\fP
تنظیم موقعیت اولیهٔ جداکننده.
.TP
.B \-\-focused=\fIPANE\fP
تنظیم قاب برای تمرکز (focus) اولیه. مقدار \fIPANE\fP باید ۱ یا ۲ باشد. پیش‌فرض ۱ است.
.PP
برای اطلاعات بیشتر دربارهٔ گفتگوی paned، بخش \fBNOTEBOOK and PANED\fP را ببینید..SS "گزینه‌های تصویر (Picture options)"
.TP
.B \-\-size=\fIVALUE\fP
اندازه اولیه تصویر را تعیین می‌کند. مقادیر موجود عبارتند از \fIfit\fP برای جا دادن تصویر در پنجره یا \fIorig\fP برای نمایش تصویر در اندازه اصلی.
.TP
.B \-\-inc=\fINUMBER\fP
مقدار گام افزایش برای مقیاس‌بندی تصویر را تنظیم می‌کند.
.TP
.B \-\-filename=\fIFILENAME\fP
نام فایل تصویر را تنظیم می‌کند. اگر نام فایلی مشخص نشود، داده‌های اضافی (extra data) به کار گرفته خواهند شد. در این حالت می‌توان چندین نام فایل را مشخص کرد.
.TP
.B \-\-file-op
عملیات فایل را فعال می‌کند. این گزینه مورد منوی باز کردن را به منوی بازشو اضافه می‌کند.
.TP
.B \-\-image-changed=\fICMD\fP
دستوری را مشخص می‌کند که پس از تغییر تصویر اجرا می‌شود. آرگومان دستور، نام فایل تصویر فعلی است. آرگومان می‌تواند با الگوی «\fI%s\fP» مشخص شود، وگرنه آخرین بخش دستور خواهد بود.
.PP
برخی از عملیات روی تصویر مانند ناوبری، مقیاس‌بندی یا چرخش، از طریق منوی بازشو (popup menu) در دسترس هستند. این اقدامات را تنها می‌توان روی تصاویر ایستا (static images) انجام داد.

.SS "گزینه‌های بازشو (Popup options)"
.TP
.B \-\-transparent=\fIPERCENT\fP
پنجره بازشو را شفاف می‌کند.
.TP
.B \-\-timeout=\fITIMEOUT\fP
زمان پایان پیش‌فرض (timeout) را تغییر می‌دهد. به طور پیش‌فرض زمان پایان ۳۰۰ ثانیه است.
.TP
.B \-\-keep
پنجره بازشو را به طور خودکار نمی‌بندد. به طور پیش‌فرض پنجره پس از \fITIMEOUT\fP ثانیه بسته خواهد شد.
.TP
\-\-align=\fITYPE\fP
تراز عنوان و متن پنجره بازشو را مشخص می‌کند. \fITYPE\fP می‌تواند یکی از مقادیر \fIleft\fP، \fIcenter\fP یا \fIright\fP باشد.

.SS "گزینه‌های چاپ (Print options)"
.TP
.B \-\-type=\fITYPE\fP
نوع فایل مبدا را تنظیم می‌کند. \fITYPE\fP می‌تواند \fITEXT\fP برای فایل‌های متنی، \fIIMAGE\fP برای فایل‌های تصویری یا \fIRAW\fP برای فایل‌هایی در قالب postscript یا pdf باشد.
.TP
.B \-\-filename=\fIFILENAME\fP
نام یا مسیر فایل مبدا را تنظیم می‌کند.
.TP
.B \-\-headers
سرصفحه‌هایی شامل نام فایل و شماره صفحه را به بالای صفحه اضافه می‌کند. این گزینه برای نوع \fIRAW\fP کار نمی‌کند.
.TP
.B \-\-add-preview
دکمه \fIPreview\fP را به گفتگوی چاپ اضافه می‌کند. این گزینه برای نوع \fIRAW\fP کار نمی‌کند.
.TP
.B \-\-fontname=\fIFONTNAME\fP
قلم را برای چاپ متن تنظیم می‌کند. \fIFONTNAME\fP رشته‌ای با ساختار نمایشی قلم به شکل \fI"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]"\fP است. این گزینه فقط برای نوع \fITEXT\fP کار می‌کند.

.SS "گزینه‌های نوار پیشرفت (Progress options)"
.PP
هنگامی که گزینه \-\-progress استفاده می‌شود، yad خطوط داده‌های پیشرفت را از stdin می‌خواند.
زمانی که خطوط با \fI#\fP آغاز شوند، متن پس از \fI#\fP در برچسب نوار پیشرفت نمایش داده می‌شود.
مقادیر عددی به عنوان درصد برای نوار پیشرفت در نظر گرفته می‌شوند.
.TP
.B \-\-bar=\fILABEL[:TYPE]\fP
یک نوار پیشرفت اضافه می‌کند. \fILABEL\fP برچسب متنی برای نوار پیشرفت است. \fITYPE\fP نوع نوار پیشرفت می‌باشد.
انواع آن عبارتند از: \fINORM\fP برای نوار پیشرفت عادی، \fIRTL\fP برای نوار پیشرفت معکوس، \fIPULSE\fP برای نوار پیشرفت ضربانی و \fICPULSE\fP برای نوار پیشرفت ضربانی پیوسته.
اگر هیچ نواری مشخص نشود، گفتگوی پیشرفت در حالت \fIsingle-bar\fP کار خواهد کرد.
.TP
.B \-\-vertical
جهت‌گیری نوارهای پیشرفت را عمودی قرار می‌دهد.
.TP
.B \-\-align=\fITYPE\fP
تراز برچسب‌های نوار را تنظیم می‌کند. انواع ممکن \fIleft\fP، \fIcenter\fP یا \fIright\fP هستند. پیش‌فرض left است.
.TP
.B \-\-progress-text=\fITEXT\fP
برچسب نوار پیشرفت را به \fITEXT\fP تغییر می‌دهد. این گزینه تنها در حالت \fIsingle-bar\fP کار می‌کند.
.TP
.B \-\-hide-text
متن را در نوارهای پیشرفت پنهان می‌کند.
.TP
.B \-\-rtl
جهت نوار پیشرفت را از راست به چپ تنظیم می‌کند. این گزینه تنها در حالت \fIsingle-bar\fP کار می‌کند.
.TP
.B \-\-auto\-close
هنگامی که پیشرفت به ۱۰۰٪ رسید، گفتگو را می‌بندد.
.TP
.B \-\-auto\-kill
اگر دکمه لغو فشرده شود، فرایند والد را متوقف می‌کند (kill).
.TP
.B \-\-pulsate
نوار پیشرفت را ضربانی می‌کند. این گزینه تنها در حالت \fIsingle-bar\fP کار می‌کند.
.TP
.B \-\-continuous
نوار پیشرفت را با ضربان پیوسته فعال می‌کند. این گزینه تنها در حالت \fIsingle-bar\fP کار می‌کند.
.TP
.B \-\-scroll
چیدمان را قابل پیمایش می‌کند.
.TP
.B \-\-enable-log\fI[=TEXT]\fP
پنجره گزارش (log) را نمایش می‌دهد. این پنجره به جای تنظیم متن پیشرفت مربوطه، تمام خطوط ورودی از stdin را که با \fI#\fP شروع شده‌اند جمع‌آوری می‌کند.
آرگومان اختیاری \fITEXT\fP یک برچسب متنی برای بخش بازشونده (expander) پنجره است.
.TP
.B \-\-log-on-top
پنجره لاگ را در بالای نوارهای پیشرفت قرار می‌دهد.
.TP
.B \-\-log-expanded
پنجره لاگ را از ابتدا به صورت بازشده نمایش می‌دهد.
.TP
.B \-\-log-height
ارتفاع پنجره لاگ را تنظیم می‌کند.
.PP
مقادیر اولیه برای نوارها به صورت آرگومان‌های اضافی تعیین می‌شوند. هر خط حاوی داده‌های پیشرفت که به stdin فرستاده می‌شود، باید با \fIN:\fP آغاز شود که در آن \fIN\fP شماره نوار پیشرفت است. در حالت \fIsingle-bar\fP نیازی به \fIN:\fP نیست..SS "گزینه‌های اطلاعات متنی (Text info options)"
.TP
.B \-\-filename=\fIFILENAME\fP
باز کردن فایل مشخص‌شده.
.TP
.B \-\-editable
امکان تغییر و ویرایش متن.
.TP
.B \-\-wrap
فعال‌سازی شکست خودکار خطوط متن.
.TP
.B \-\-formatted
فعال‌سازی نشانه‌گذاری Pango. این گزینه همراه با گزینهٔ \fI\-\-editable\fP کار نمی‌کند.
.TP
.B \-\-justify=\fITYPE\fP
تنظیم تراز متن. مقدار \fITYPE\fP می‌تواند \fIleft\fP (چپ)، \fIright\fP (راست)، \fIcenter\fP (وسط) یا \fIfill\fP (تراز کامل) باشد.
پیش‌فرض \fIleft\fP است.
.TP
.B \-\-margins=\fINUMBER\fP
تنظیم حاشیه‌های متن روی \fINUMBER\fP.
.TP
.B \-\-tail | \-\-auto-scroll
پیمایش خودکار به انتها هنگام نمایش متن جدید. این گزینه فقط زمانی کار می‌کند که متن از stdin خوانده شود.
.TP
.B \-\-line=\fINUMBER\fP
پرش به خط مشخص‌شده در هنگام راه‌اندازی. این گزینه فقط زمانی کار می‌کند که نام فایل مشخص شده باشد.
.TP
.B \-\-show-cursor
نمایش مکان‌نما در حالت فقط‌خواندنی.
.TP
.B \-\-show-uri
پیوندهای موجود در متن را قابل کلیک می‌کند. پیوندها با دستور \fIxdg-open\fP باز می‌شوند.
.TP
.B \-\-fore=\fICOLOR\fP
تنظیم رنگ پیش‌فرض متن.
.TP
.B \-\-back=\fICOLOR\fP
تنظیم رنگ پیش‌فرض پس‌زمینه.
.TP
.B \-\-uri-color=\fICOLOR\fP
تنظیم رنگ پیوندها. پیش‌فرض \fIblue\fP است.
.TP
.B \-\-listen
شنود داده‌ها از stdin، حتی در صورتی که نام فایل مشخص شده باشد.
.TP
.B \-\-in-place
ذخیرهٔ فایل در هنگام خروج به جای چاپ محتوای آن در stdout. این گزینه فقط در صورتی کار می‌کند که فایل از خط فرمان مشخص شده باشد.
.TP
.B \-\-file-op
فعال‌سازی عملیات فایل. این گزینه موارد باز کردن و ذخیره را به منوی بالاپر (popup) اضافه می‌کند. این گزینه فقط در حالت قابل ویرایش کار می‌کند.
.TP
.B \-\-disable-search
غیرفعال کردن نوار جستجو.
.TP
.B \-\-confirm\-save=\fI[TEXT]\fP
درخواست تأیید برای ذخیرهٔ فایل در صورتی که محتوای آن تغییر کرده باشد. این گزینه فقط زمانی کار می‌کند که \fI\-\-in-place\fP مشخص شده باشد.
آرگومان اختیاری، متنی برای کادر گفتگوی تأیید است.
.TP
گزینه‌های بعدی فقط در صورتی کار می‌کنند که yad همراه با GtkSourceView کامپایل شده باشد.
.TP
.B \-\-lang=\fILANGUAGE\fP
برجسته‌سازی نحو برای \fILANGUAGE\fP مشخص‌شده.
.TP
.B \-\-theme=\fITHEME\fP
تنظیم پوستهٔ مورد استفاده روی \fITHEME\fP. برای دریافت فهرست تمام پوسته‌های در دسترس از \fIyad-tools(1)\fP استفاده کنید.
.TP
.B \-\-mime=\fITYPE\fP
مشخص کردن نوع MIME داده‌های ورودی. این گزینه فقط برای حدس زدن برجسته‌سازی نحو مناسب مورد نیاز است.
.TP
.B \-\-line-num
نمایش شمارهٔ خطوط.
.TP
.B \-\-line-hl
برجسته کردن خط کنونی.
.TP
.B \-\-line-marks
فعال‌سازی حالت نشانه‌گذاری خطوط. دو نوع نشانه وجود دارد؛ نوع اول با کلیک دکمهٔ چپ ماوس و نوع دوم با کلیک دکمهٔ راست ماوس تنظیم می‌شود.
.TP
.B \-\-mark1-color=\fICOLOR\fP
تنظیم رنگ پس‌زمینه برای نشانه‌های نوع اول روی \fICOLOR\fP. پیش‌فرض lightgreen است.
.TP
.B \-\-mark2-color=\fICOLOR\fP
تنظیم رنگ پس‌زمینه برای نشانه‌های نوع دوم روی \fICOLOR\fP. پیش‌فرض pink است.
.TP
.B \-\-right-margin=\fI[POS]\fP
فعال‌سازی نشانگر حاشیهٔ راست. آرگومان اختیاری \fIPOS\fP موقعیت حاشیه بر حسب تعداد نویسه‌ها است. پیش‌فرض 80 است.
.TP
.B \-\-brackets
برجسته کردن قلاب‌ها و پرانتزهای متناظر.
.TP
.B \-\-indent
فعال کردن تورفتگی خودکار. این گزینه همچنین کلید \fITAB\fP را به عنوان کلید تورفتگی تعیین می‌کند.
.TP
.B \-\-smart-he=\fITYPE\fP
تنظیم رفتار کلیدهای \fIHOME\fP و \fIEND\fP. مقدار \fITYPE\fP یکی از مقادیر \fInewer\fP، \fIbefore\fP، \fIafter\fP یا \fIalways\fP است.
.TP
.B \-\-smart-bs
فعال کردن حالت هوشمند برای \fIBackSpace\fP. در صورت فعال بودن این گزینه، کلید BackSpace فاصله‌ها را تا موقعیت پرش‌گر (tab) بعدی پاک می‌کند.
.TP
.B \-\-tab-width
تنظیم گام پرش‌بندی (tabulation).
.TP
.B \-\-indent-width
تنظیم گام تورفتگی.
.TP
.B \-\-spaces
درج فاصله به جای تب.
.PP
اگر گزینهٔ \fIfontname\fP برای گفتگوی متنی مشخص شده باشد، توصیف قلم باید به سبک CSS باشد (نه به سبک Pango).
ارسال نویسهٔ FormFeed به گفتگوی متنی موجب پاک شدن آن می‌شود. این نماد می‌تواند به صورت \fIecho \-e \(aq\ef\(aq\fP ارسال شود.
فشردن \fICtrl+S\fP ورودی جستجو را در گفتگوی متنی به صورت بازشو نمایش می‌دهد..SS گزینه‌های مقیاس (Scale options)
.TP
.B \-\-value=\fIVALUE\fP
تنظیم مقدار اولیه.
.TP
.B \-\-min\-value=\fIVALUE\fP
تنظیم کمینه مقدار.
.TP
.B \-\-max\-value=\fIVALUE\fP
تنظیم بیشینه مقدار.
.TP
.B \-\-step=\fIVALUE\fP
تنظیم اندازه گام.
.TP
.B \-\-enforce-step
تنها اجازه دادن به مقادیری که در مضارب گام هستند.
.TP
.B \-\-page=\fIVALUE\fP
تنظیم اندازه پرش (صفحه‌بندی). به طور پیش‌فرض مقدار پرش برابر با STEP*10 است.
.TP
.B \-\-print\-partial
چاپ مقادیر جزئی و میانی.
.TP
.B \-\-hide\-value
پنهان کردن مقدار.
.TP
.B \-\-vertical
نمایش مقیاس عمودی.
.TP
.B \-\-invert
معکوس کردن جهت مقیاس.
.TP
.B \-\-inc-buttons
نمایش دکمه‌ها در لبه‌های مقیاس برای افزایش یا کاهش مقدار مقیاس.
.TP
.B \-\-mark=\fI[NAME]:VALUE\fP
افزودن یک نشانه به مقیاس. می‌تواند چندین بار استفاده شود. \fINAME\fP آرگومانی اختیاری برای برچسب‌گذاری نشانه است.

.SS گزینه‌های فیلتر فایل (File filters options)
.TP
.B \-\-file-filter=\fINAME | PATTERN1 PATTERN2 ...\fP
افزودن یک فیلتر نام فایل. \fINAME\fP نام نمایشی فیلتر است و \fIPATTERN\fP یک الگوی نام فایل به سبک پوسته است (برای مثال *.txt). این گزینه می‌تواند چندین بار استفاده شود.
.TP
.B \-\-mime-filter=\fINAME | MIME1 MIME2 ...\fP
افزودن یک فیلتر نوع mime. \fINAME\fP نام نمایشی فیلتر است و \fIPATTERN\fP نام یک نوع mime است (برای مثال text/plain). این گزینه می‌تواند چندین بار استفاده شود.
.TP
.B \-\-image-filter=\fI[NAME]\fP
افزودن فیلتر برای تصاویری که توسط کتابخانه gdk-pixbuf پشتیبانی می‌شوند. \fINAME\fP نام اختیاری این فیلتر است.
.TP
این گزینه‌ها برای تمام کادرهای گفتگوی انتخاب فایل yad اعمال می‌شوند.

.SS گزینه‌های پیش‌نمایش فایل (File preview options)
.TP
.B \-\-add-preview
افزودن ویجت پیش‌نمایش. تصاویر پیش‌نمایش مطابق با مشخصات بندانگشتی‌های XDG نگارش 0.8.0 (http://standards.freedesktop.org/thumbnail-spec/latest) از بندانگشتی‌های عادی (پیش‌فرض) یا بزرگ بارگیری می‌شوند، یا توسط yad برای فایل‌های تصویری ساخته شده و به عنوان بندانگشتی‌های عادی یا بزرگ ذخیره می‌شوند.
.TP
.B \-\-large-preview
استفاده از پیش‌نمایش‌های بزرگ به صورت پیش‌فرض. این گزینه می‌تواند از طریق تنظیمات yad به صورت دائمی فعال شود.
.TP
این گزینه‌ها برای تمام کادرهای گفتگوی انتخاب فایل yad اعمال می‌شوند.
.TP
\fBنکته:\fP برنامه YAD مقدار mtime را برای تصاویر بندانگشتی بررسی نمی‌کند و اگر فایل اصلی پس از ایجاد تصویر بندانگشتی تغییر کند، پیش‌نمایش را به‌روزرسانی نخواهد کرد.

.SS گزینه‌های متفرقه (Miscellaneous options)
.TP
.B \-?, \-\-help
نمایش خلاصه گزینه‌ها.
.TP
.B \-\-about
نمایش کادر گفتگوی درباره نرم‌افزار.
.TP
.B \-\-version
نمایش نسخه برنامه.
.PP
همچنین گزینه‌های استاندارد GTK+ نیز پذیرفته می‌شوند..SH "دفترچه و قاب‌بندی (NOTEBOOK and PANED)"
دفترچه (Notebook) یک کادر گفتگوی مرکب است که کادرهای گفتگوی دیگر را در زبانه‌های خود جای می‌دهد.
کادرهای گفتگو با یک کلید یکتا (عدد صحیح) شناسایی می‌شوند و باید در یک حالت اتصالی ویژه (گزینهٔ \-\-plug) اجرا شوند.
مثال زیر یک کادر گفتگوی دفترچه را با دو زبانه اجرا می‌کند؛ زبانهٔ نخست دارای یک متن ساده است و زبانهٔ دوم یک کادر ورودی است.

.nf
#! /bin/sh
.sp
yad \-\-plug=12345 \-\-tabnum=1 \-\-text="first tab with text" &> res1 &
yad \-\-plug=12345 \-\-tabnum=2 \-\-text="second tab" \-\-entry &> res2 &
yad \-\-notebook \-\-key=12345 \-\-tab="Tab 1" \-\-tab="Tab 2"
.fi

نکته: ترتیب نتایج خروجی برای زبانه‌ها نامشخص است!

قاب‌بندی (Paned) به همان شیوهٔ دفترچه عمل می‌کند با یک محدودیت \- تنها اولین و دومین کادر گفتگوی متصل‌شده درون قاب‌ها جای می‌گیرند.

.SH "اعلان (NOTIFICATION)"
امکان ارسال دستورها را به yad در قالب \fBcommand:args\fP فراهم می‌کند.
دستورهای ممکن عبارتند از \fIicon\fP، \fItooltip\fP، \fIvisible\fP، \fIaction\fP، \fImenu\fP و \fIquit\fP.
.TP
.B icon:ICONNAME
تنظیم آیکون اعلان به ICONNAME.
.TP
.B tooltip:STRING
تنظیم متن راهنمای (tooltip) اعلان.
.TP
.B visible:[true|false]
تنظیم وضعیت آیکون اعلان به حالت مرئی یا نامرئی.
.TP
.B action:COMMAND
تعیین دستوری که هنگام کلیک روی آیکون اجرا می‌شود.
دو دستور ویژه وجود دارد \- \fImenu\fP برای نمایش منوی بازشوی تعریف‌شده توسط کاربر و \fIquit\fP برای خروج از برنامه.
.TP
.B menu:STRING
تنظیم منوی بازشو برای آیکون اعلان.
‏STRING باید در قالب \fIname1[!action1[!icon1]]|name2[!action2[!icon2]]...\fP باشد.
نام خالی یک جداکننده به منو اضافه می‌کند.
نویسهٔ جداکننده برای مقادیر (مثلاً \(ga|\(aq) با آرگومان \-\-separator تعیین می‌شود.
نویسهٔ جداکننده برای موارد منو (مثلاً \(ga!\(aq) با آرگومان \-\-item-separator تعیین می‌شود.
.TP
.B quit
خروج از برنامه. کلیک میانی روی آیکون نیز دستور \fIquit\fP را ارسال می‌کند.

.SH "موارد پیش‌ساخته (STOCK ITEMS)"
.TP
این فهرستی از موارد از پیش تعریف‌شدهٔ موجود در \fIyad\fP است.

.TS
tab (@);
l l l.
.B
شناسه@متن برچسب@نام آیکون
_
yad-about@درباره@help-about
yad-add@افزودن@list-add
yad-apply@اعمال@gtk-apply
yad-cancel@انصراف@gtk-cancel
yad-clear@پاک‌سازی@document-clear
yad-close@بستن@window-close
yad-edit@ویرایش@gtk-edit
yad-execute@اجرا@system-run
yad-no@خیر@gtk-no
yad-ok@تأیید@gtk-ok
yad-open@باز کردن@document-open
yad-print@چاپ@document-print
yad-quit@خروج@application-exit
yad-refresh@تازه‌سازی@view-refresh
yad-remove@حذف@list-remove
yad-save@ذخیره@document-save
yad-search@جستجو@system-search
yad-send@ارسال@document-send
yad-settings@تنظیمات@gtk-preferences
yad-yes@بله@gtk-yes
.TE

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.TP
.B YAD_OPTIONS
این متغیر می‌تواند برخی گزینه‌های پیش‌فرض را برای \fIyad\fP نگه دارد. تمام گزینه‌های موجود در این متغیر را می‌توان از خط فرمان بازتعریف کرد.
.TP
.B YAD_SETTINGS_FILE
محل فایل حاوی تنظیمات yad. برای جزئیات به بخش \fBSETTINGS\fP مراجعه کنید.
.TP
.B YAD_PID
این متغیر با مقدار pid کادر گفتگوی فعلی مقداردهی می‌شود و در تمام فرزندان کادر گفتگو در دسترس است.
.TP
.B YAD_XID
این متغیر با مقدار شناسهٔ پنجرهٔ اکس (X Window ID) کادر گفتگوی فعلی مقداردهی می‌شود و در تمام فرزندان کادر گفتگو در دسترس است. این متغیر در کادرهای گفتگوی چاپ و اعلان، و همچنین در کادرهایی که به عنوان فرزند دفترچه یا قاب عمل می‌کنند، مقداردهی نمی‌شود..SH "سیگنال‌های تعریف‌شده توسط کاربر (USER DEFINED SIGNALS)"
.TP
.B SIGUSR1
بستن کادر محاوره با کد خروج 0.
.TP
.B SIGUSR2
بستن کادر محاوره با کد خروج 1.

.SH "وضعیت خروج (EXIT STATUS)"
.TP
.B 0
کاربر دکمه‌ی \fIOK\fP را فشرده است
.TP
.B 1
کاربر دکمه‌ی \fICancel\fP را فشرده است
.TP
.B 70
کادر محاوره به دلیل پایان مهلت زمانی بسته شده است.
.TP
.B 252
کادر محاوره با فشردن \fIEsc\fP یا با استفاده از عملکردهای پنجره برای بستن کادر محاوره بسته شده است
.TP
کدهای خروج برای دکمه‌های مشخص‌شده توسط کاربر باید در خط فرمان تعیین شوند. کد خروج زوج به معنای چاپ نتیجه است؛ کد فرد فقط کد خروج را بازمی‌گرداند.

.SH "نام‌های ابزارک‌ها (WIDGETS NAMES)"
.TP
ظاهر و رفتار کادرهای محاوره‌ی yad می‌تواند از طریق فایل gtkrc سفارشی‌سازی شود. در ادامه نام ابزارک‌های yad آمده است:

.TS
tab (@);
l l l.
.B
نام ابزارک@نوع ابزارک@توضیحات
_
yad-dialog-window@GtkDialog@پنجره کادر محاوره
yad-dialog-image@GtkImage@تصویر کادر محاوره
yad-dialog-label@GtkLabel@متن کادر محاوره
yad-app-widget@GtkAppChooserWidget@ابزارک انتخاب برنامه
yad-calendar-widget@GtkCalendar@ابزارک تقویم
yad-color-widget@GtkColorChooser@ابزارک انتخاب رنگ
yad-color-palette@GtkTreeView@فهرست رنگ‌های از پیش‌تعریف‌شده
yad-entry-label@GtkLabel@برچسب ورودی
yad-entry-widget@GtkEntry@ابزارک ورودی
yad-entry-spin@GtkSpinButton@ابزارک ورودی برای مقادیر عددی
yad-entry-combo@GtkComboBox@ابزارک ورودی با کمبو
yad-entry-edit-combo@GtkComboBoxEntry@ابزارک ورودی با کمبوی قابل ویرایش
yad-file-widget@GtkFileChooser@ابزارک انتخاب فایل
yad-font-widget@GtkFontChooser@ابزارک انتخاب قلم
yad-form-flabel@GtkLabel@برچسب فیلد در فرم
yad-form-button@GtkButton@فیلد دکمه در فرم
yad-form-entry@GtkEntrfy@فیلد ورودی در فرم
yad-form-spin@GtkSpinButton@فیلد ورودی عددی در فرم
yad-form-check@GtkCheckButton@فیلد چک‌باکس در فرم
yad-form-combo@GtkComboBox@فیلد کمبو در فرم
yad-form-edit-combo@GtkComboBoxEntry@فیلد کمبوی قابل ویرایش در فرم
yad-form-link@GtkLinkButton@فیلد پیوند در فرم
yad-form-file@GtkFileChooserButton@فیلد فایل یا دایرکتوری در فرم
yad-form-font@GtkFontChooserButton@فیلد قلم در فرم
yad-form-app@GtkAppChooserButton@فیلد برنامه در فرم
yad-form-switch@GtkSwitch@فیلد کلید در فرم
yad-form-color@GtkColorChooserButton@فیلد رنگ در فرم
yad-form-label@GtkLabel@فیلد برچسب در فرم
yad-form-scale@GtkScale@ابزارک مقیاس در فرم
yad-form-separator@GtkSeparator@جداکننده در فرم
yad-form-text@GtkTextView@فیلد متنی چندخطی در فرم
yad-icons-full@GtkIconView@ابزارک آیکون‌ها برای حالت عادی
yad-icons-compact@GtkTreeView@ابزارک آیکون‌ها برای حالت فشرده
yad-list-widget@GtkTreeView@ابزارک فهرست
yad-notebook-widget@GtkNotebook@ابزارک دفترچه
yad-paned-widget@GtkPaned@ابزارک قاب افقی یا عمودی
yad-progress-widget@GtkProgressBar@ابزارک نوار پیشرفت
yad-scale-widget@GtkScale@ابزارک مقیاس
yad-stack-widget@GtkStack@ابزارک پشته
yad-stack-switcher-widget@GtkStackSwitcher@ابزارک تعویض‌کننده پشته
yad-text-widget@GtkTextView@ابزارک اطلاعات متنی
yad-timeout-indicator@GtkProgreeBar@نشانگر مهلت زمانی
.TE

.SH "تنظیمات (SETTINGS)"
برنامه YAD برخی از مقادیر پیش‌فرض را از فایل تنظیمات می‌خواند. این فایل می‌تواند با آرگومان \fI--write-settings\fP ایجاد شود. نحو این فایل یک سبک ساده ini است. مکان پیش‌فرض \fI$XDG_CONFIG_HOME/yad/settings.conf\fP است و می‌تواند با متغیر محیطی \fIYAD_SETTINGS_FILE\fP بازتعریف شود..SH "مثال‌ها (EXAMPLES)"
نمایش یک انتخاب‌گر فایل با عنوان \fISelect a file to remove\fP. فایل انتخاب‌شده در خروجی استاندارد بازگردانده می‌شود.
.IP
yad  \-\-title="Select a file to remove" \-\-file-selection
.PP
نمایش یک کادر گفتگوی ورود متن با عنوان \fISelect Host\fP و متن \fISelect the host you would like to flood-ping\fP. متن واردشده در خروجی استاندارد بازگردانده می‌شود.
.IP
yad  \-\-title "Select Host" \-\-entry \-\-text "Select the host you would like to flood-ping"
.PP
نمایش یک کادر گفتگو با پرسش \fIMicrosoft Windows has been found! Would you like to remove it?\fP. در صورت انتخاب \fIYES\fP کد بازگشتی 0 (در شل معادل درست/true) و در صورت انتخاب \fINO\fP مقدار 1 (نادرست/false) خواهد بود.
.IP
yad  \-\-image "dialog-question" \-\-title "Alert" \-\-button=gtk-yes:0 \-\-button=gtk-no:1 \-\-text "Microsoft Windows has been found! Would you like to remove it?"
.PP
نمایش نتایج جستجو در یک کادر گفتگوی فهرستی با عنوان \fISearch Results\fP و متن \fIFinding all header files...\fP.
.IP
find . \-name '*.h' | yad \-\-list \-\-title "Search Results" \-\-text "Finding all header files.." \-\-column "Files"
.PP
نمایش یک آیکون در ناحیه اعلان
.IP
yad \-\-notification \-\-image=update.png \-\-text "System update necessary!" \-\-command "xterm \-e apt-get upgrade"
.PP
نمایش یک فهرست خرید هفتگی در یک کادر گفتگوی چک‌لیست با مقادیر از پیش انتخاب‌شده \fIApples\fP و \fIOranges\fP
.IP
yad \-\-list \-\-checklist \-\-column "Buy" \-\-column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste
.PP
نمایش یک کادر گفتگوی نوار پیشرفت هنگام جستجو برای تمام فایل‌های postscript در دایرکتوری خانگی شما
.IP
find $HOME \-name '*.ps' | yad \-\-progress \-\-pulsate
.PP
نمایش کادری شامل تمام برنامه‌های کاربردی دسکتاپ نصب‌شده
.IP
yad \-\-icons \-\-read-dir=/usr/share/applications
.PP
نمایش فهرست در حالت درختی
.IP
yad --list --tree --column "Items" f Fruits 1:f Apple 2:f Lemon v Vegetables 3:v Popato 4:v Onion

.SH "توسعه (DEVELOPMENT)"
برخی قابلیت‌های ویژه توسعه‌دهندگان به همراه YAD ارائه شده است.
.TP
\fIYAD icon browser\fP یک ابزار گرافیکی برای کاوش آیکون‌ها در تم آیکون GTK+ فعلی یا مشخص‌شده توسط کاربر است. اجرای آن به این صورت است:
.IP
yad-icon-browser [theme]
.PP
هنگام استفاده از autoconf می‌توانید از ماکروی ویژه m4 به نام \fIAM_PATH_YAD\fP برای جستجوی yad و بررسی نسخه آن استفاده کنید. نحوه استفاده از این ماکرو به این صورت است:
.IP
AM_PATH_YAD([MINIMUM-VERSION],\\
[ACTION-IF-FOUND],\\
[ACTION-IF-NOT-FOUND])
.PP

.SH "نویسندگان (AUTHORS)"
\fBYad\fP توسط Victor Ananjevsky <ananasik@gmail.com> نوشته شده است. آیکون Yad توسط Bogdan Lisovich ساخته شده است.

.SH "همچنین ببینید (SEE ALSO)"
\fBgdialog\fP(1), \fBdialog\fP(1), \fBzenity\fP(1), \fByad-tools\fP(1)