.\" Generated by scdoc 1.11.3
.\" 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 "fyi" "1" "2024-09-05"
.PP
.SH "نام (NAME)"
fyi \- ارسال اعلان‌های میزکار
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fBfyi\fR [\fIOPTION\fR].\&.\&.\& \fITITLE\fR [\fIMESSAGE\fR]
.br
\fBfyi --close\fR=\fIID\fR
.br
\fBfyi --server-info\fR
.br
\fBfyi --server-capabilities\fR
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
\fBfyi\fR یک ابزار خط فرمانی برای ارسال اعلان‌های میزکار به کاربر از طریق یک دیمن اعلان پیاده‌سازی‌کنندهٔ اعلان‌های میزکار XDG است.\&
.PP
این ابزار شبیه به ابزار شناخته‌شدهٔ \fBnotify-send\fR(1) است.\& در واقع، بیشتر گزینه‌ها یکسان هستند.\&
.PP
هنگامی که بدون هیچ گزینه‌ای استفاده شود، \fBfyi\fR اعلان را ارسال کرده و بدون چاپ هیچ چیزی در خروجی استاندارد (stdout)، بلافاصله خارج می‌شود.\&
.PP
از \fB--print-id\fR استفاده کنید تا \fBfyi\fR شناسهٔ اعلان تخصیص‌یافته توسط دیمن را در خروجی استاندارد و در قالب زیر چاپ کند:
.PP
.RS 4
\fBid=\fR\fIID\fR
.PP
.RE
برای دیدن دلیل بسته شدن اعلان، از \fB--print-reason\fR استفاده کنید.\& دلیل در خروجی استاندارد و در قالب زیر چاپ می‌شود:
.PP
.RS 4
\fBreason=\fR\fIREASON\fR
.PP
.RE
\fBfyi\fR همچنین می‌تواند با استفاده از گزینهٔ \fB--wait\fR تا زمان بسته شدن اعلان متوقف (block) بماند.\& ارسال سیگنال SIGINT به فرایند \fBfyi\fR اعلان را به صورت اجباری خواهد بست.\&
.PP
\fBfyi\fR همچنین در صورتی که اعلان دارای کنش‌هایی (actions) باشد متوقف خواهد ماند.\& هنگامی که کنشی برانگیخته شود، \fBfyi\fR نام آن کنش را در خروجی استاندارد و در قالب زیر چاپ می‌کند:
.PP
.RS 4
\fBaction=\fR\fINAME\fR
.PP
.RE
برخی از دیمن‌های اعلان می‌توانند یک «توکن فعال‌سازی» (activation token) ارسال کنند.\& این کار معمولاً زمانی انجام می‌شود که کاربر روی اعلان کلیک کند یا کنش پیش‌فرض را به اجرا درآورد.\& این توکن می‌تواند برای فوکوس کردن (فعال‌سازی) یک پنجره استفاده شود.\& برای مشاهدهٔ توکن، از \fB--print-token\fR استفاده کنید.\& توکن در خروجی استاندارد و در قالب زیر چاپ می‌شود:
.PP
.RS 4
\fBxdgtoken=\fR\fITOKEN\fR
.PP
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-a\fR,\fB--app-name\fR=\fINAME\fR
.RS 4
نام برنامه.\& دیمن‌های اعلان یا آن را به عنوان متن نمایش می‌دهند، یا برای انتخاب آیکونی جهت نمایش از آن استفاده می‌کنند (مگر اینکه از \fB--icon\fR استفاده شده باشد).\& پیش‌فرض: \fIfyi\fR
.PP
.RE
\fB-i\fR,\fB--icon\fR=\fIICON\fR
.RS 4
آیکون برای نمایش، یا به صورت نام نمادین آیکون (مانند \fIfirefox\fR) یا یک نام فایل.\& پیش‌فرض: \fInone\fR
.PP
.RE
\fB-u\fR,\fB--urgency\fR=\fBlow|normal|critical\fR
.RS 4
میزان فوریت اعلان.\& میان‌بری برای \fB--hint=byte:urgency:0|1|2\fR.\& پیش‌فرض: \fInormal\fR.\&
.PP
.RE
\fB-c\fR,\fB--category\fR=\fICATEGORY\fR
.RS 4
دسته‌بندی اعلان.\& میان‌بری برای \fB--hint=string:category:CATEGORY\fR.\& پیش‌فرض: \fInone\fR.\&
.PP
.RE
\fB-A\fR,\fB--action\fR=\fINAME\fR:\fILABEL\fR
.RS 4
کنشی را برای نمایش تعریف می‌کند (برای نمونه به صورت یک دکمه یا در یک فهرست، بسته به دیمن اعلان).\& \fILABEL\fR متنی است که دیمن اعلان برای کاربر نمایش خواهد داد.\& هنگامی که کاربر کنشی را اجرا کند، \fBfyi\fR مقدار \fINAME\fR متناظر را در قالب زیر چاپ خواهد کرد:
.PP
.RS 4
\fBaction=\fR\fINAME\fR
.PP
.RE
این گزینه می‌تواند چندین بار مشخص شود تا چندین کنش تعریف گردند.\&
.PP
استفاده از این گزینه مستلزم \fB--wait\fR است.\&
.PP
.RE
\fB-H\fR,\fB--hint\fR=\fITYPE\fR:\fINAME\fR:\fIVALUE\fR
.RS 4
یک هینت (hint) سفارشی تعریف می‌کند.\& نحوهٔ تفسیر این هینت‌ها به دیمن اعلان بستگی دارد.\& یک کاربرد رایج، نمایش نوعی نوار پیشرفت است؛ بیشتر دیمن‌های اعلان \fBint:value:<percent>\fR را می‌شناسند.\&
.PP
هینت رایج دیگر \fBstring:x-canonical-private-synchronous:<name>\fR است.\& بسیاری از دیمن‌های اعلان هر اعلان موجود با همان \fIname\fR را جایگزین خواهند کرد.\& این شبیه به \fB--replaces\fR است، با این تفاوت که به شناسهٔ اعلان نیازی ندارید.\&
.PP
\fBfyi\fR انواع زیر را می‌شناسد:
.PP
.PD 0
.IP \(bu 4
boolean
.IP \(bu 4
byte
.IP \(bu 4
int
.IP \(bu 4
double
.IP \(bu 4
string
.PD
.PP
.RE
\fB-r\fR,\fB--replaces\fR=\fIID\fR
.RS 4
اگر اعلانی با شناسهٔ مشخص‌شده از قبل وجود داشته باشد، آن را جایگزین می‌کند.\& در غیر این صورت، یک اعلان جدید ایجاد می‌کند.\&
.PP
.RE
\fB-t\fR,\fB--expire-time\fR=\fITIME\fR
.RS 4
اعلان پس از \fITIME\fR میلی‌ثانیه به طور خودکار بسته خواهد شد.\&
.PP
.RE
\fB--transient\fR
.RS 4
قابلیت ماندگاری کارگزار را (در صورت وجود) دور می‌زند.\& میان‌بری برای \fB--hint=boolean:transient=true\fR.\&
.PP
.RE
\fB-C\fR,\fB--close\fR=\fIID\fR
.RS 4
اگر اعلانی با شناسهٔ مشخص‌شده از قبل وجود داشته باشد، آن را می‌بندد.\&
.PP
.RE
\fB-p\fR,\fB--print-id\fR
.RS 4
شناسهٔ اعلان تخصیص‌یافته توسط دیمن را در قالب \fBid=\fR\fIID\fR چاپ می‌کند.\&
.PP
.RE
\fB-R\fR,\fB--print-reason\fR
.RS 4
دلیل بسته شدن اعلان را در قالب زیر چاپ می‌کند:
.PP
.PD 0
.IP \(bu 4
\fBreason=expired\fR
.IP \(bu 4
\fBreason=dismissed\fR
.IP \(bu 4
\fBreason=force-closed\fR
.IP \(bu 4
\fBreason=unknown\fR
.PD
.PP
استفاده از این گزینه مستلزم \fB--wait\fR است.\&
.PP
.RE
\fB-T\fR,\fB--print-token\fR
.RS 4
توکن فعال‌سازی را (در صورت وجود) در قالب زیر چاپ می‌کند:
.PP
.RS 4
\fBxdgtoken=\fR\fITOKEN\fR
.PP
.RE
برخی از دیمن‌های اعلان هنگام رد کردن اعلان یک توکن فعال‌سازی ارسال می‌کنند؛ چه زمانی که روی اعلان کلیک شود، یا کنش پیش‌فرض فراخوانی گردد.\& دیمن‌های دیگر صرف‌نظر از اینکه کدام کنش فراخوانی شده است آن را ارسال می‌کنند.\& برخی تنها زمانی که کنشی فراخوانی شود آن را می‌فرستند، در حالی که برخی دیگر هنگام رد شدن اعلان، صرف‌نظر از چگونگی آن، توکن را ارسال می‌کنند.\&
.PP
این توکن می‌تواند برای فوکوس کردن (فعال‌سازی، بالا آوردن) یک پنجره به کار رود.\& این توکن مستقیماً توسط \fBfyi\fR قابل استفاده نیست، اما برنامه‌هایی که از \fBfyi\fR به عنوان ابزار کمکی برای نمایش اعلان‌ها بهره می‌برند می‌توانند از آن استفاده کنند.\&
.PP
استفاده از این گزینه مستلزم \fB--wait\fR است.\&
.PP
.RE
\fB-w\fR,\fB--wait\fR
.RS 4
پیش از خروج، منتظر بسته شدن اعلان می‌ماند.\& اگر کاربر کنشی را فعال کرده باشد، نام آن کنش چاپ خواهد شد (به \fB-A\fR,\fB--action\fR مراجعه کنید).\&
.PP
در صورت استفاده از هر یک از گزینه‌های زیر، این گزینه به طور ضمنی فعال می‌شود:
.PP
.PD 0
.IP \(bu 4
\fB-A\fR,\fB--action\fR
.IP \(bu 4
\fB-R\fR,\fB--print-reason\fR
.IP \(bu 4
\fB-T\fR,\fB--print-token\fR
.PD
.PP
.RE
\fB--image-data\fR=\fIFILE\fR
.RS 4
هینت \fBimage-data\fR را در اعلان با داده‌های خام پیکسل از \fIFILE\fR تنظیم می‌کند.\& فرض می‌شود داده‌ها از نوع داده‌های خام RGBA هستند.\& همچنین باید اندازهٔ تصویر را مشخص کنید؛ به \fB--image-size\fR مراجعه نمایید.\&
.PP
.RE
\fB--image-size=WIDTHxHEIGHT\fR
.RS 4
ابعاد تصویری که توسط \fB--image-data\fR بارگذاری می‌شود.\&
.PP
.RE
\fB--server-info\fR
.RS 4
نام و نگارش دیمن اعلان را نمایش می‌دهد.\&
.PP
.RE
\fB--server-capabilities\fR
.RS 4
قابلیت‌های دیمن اعلان را نمایش می‌دهد.\&
.PP
.RE
\fB-v\fR,\fB--version\fR
.RS 4
شمارهٔ نگارش را نمایش داده و خارج می‌شود.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
.PD 0
.IP \(bu 4
\fBnotify-send\fR(1)
.IP \(bu 4
\fBgdbus\fR(1)