.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "kitten-notify" 1 "Jul 30, 2026" "0.48.2" "kitty"
.SH "نام (NAME)"
kitten-notify \- ارسال اعلان‌های دسکتاپ از درون ترمینال kitty
.SH "نمای کلی (OVERVIEW)"
.sp
نمایش اعلان‌های بالاپران (پاپ‌آپ) سیستم.
.sp
اضافه‌شده در نسخه 0.36.0: کیتن notify

.sp
کیتن \fBnotify\fP می‌تواند برای نمایش اعلان‌های بالاپران سیستمی از درون شل استفاده شود. این قابلیت حتی از طریق SSH نیز کار می‌کند. استفاده از آن بسیار ساده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten notify \(dqGood morning\(dq Hello world, it is a nice day!
.EE
.UNINDENT
.UNINDENT
.sp
برای افزودن آیکون:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten notify \-\-icon\-path /path/to/some/image.png \(dqGood morning\(dq Hello world, it is a nice day!
kitten notify \-\-icon firefox \(dqGood morning\(dq Hello world, it is a nice day!
.EE
.UNINDENT
.UNINDENT
.sp
برای آگاهی از فعال شدن یا کلیک روی اعلان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten notify \-\-wait\-for\-completion \(dqGood morning\(dq Hello world, it is a nice day!
.EE
.UNINDENT
.UNINDENT
.sp
سپس کیتن منتظر می‌ماند تا اعلان بسته شود یا کاربر روی آن کلیک کند.
در صورت فعال شدن، مقدار \fB0\fP در \fBSTDOUT\fP چاپ می‌شود. می‌توانید کلیدهای
\fBEsc\fP یا \fBCtrl\fP+\fBc\fP را برای لغو و بستن اعلان فشار دهید.
.sp
برای افزودن دکمه‌ها به اعلان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten notify \-\-wait\-for\-completion \-\-button One \-\-button Two \(dqGood morning\(dq Hello world, it is a nice day!
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
درباره پروتکل کدهای گریز (escape code) اعلان‌های دسکتاپ بیشتر بیاموزید.
.UNINDENT
.UNINDENT
.SH "کد منبع notify (Source code for notify)"
.sp
کد منبع این کیتن در گیت‌هاب در دسترس است: <https://github.com/kovidgoyal/kitty/tree/master/kittens/notify>\&.
.SH "رابط خط فرمان (Command line interface)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten notify [options] TITLE [BODY ...]
.EE
.UNINDENT
.UNINDENT
.sp
ارسال اعلان به کاربر که از طریق سرویس اعلان‌های محیط رومیزی نمایش داده می‌شود. از طریق SSH نیز کار می‌کند.
.sp
برای به‌روزرسانی یک اعلان موجود، شناسه اعلان را با گزینه \-\-identifier مشخص کنید. مقدار آن باید همان شناسه‌ای باشد که برای اعلانی که قصد به‌روزرسانی‌اش را دارید تعیین کرده بودید.
.sp
اگر عنوانی مشخص نشود و یک شناسه با گزینه \-\-identifier تعیین شده باشد، به جای ایجاد اعلان جدید، اعلان موجود دارای شناسه مشخص‌شده بسته می‌شود.
.SS "گزینه‌ها (Options)"
.INDENT 0.0
.TP
.B \-\-icon <ICON>, \-n <ICON>
نام آیکون مورد استفاده برای اعلان. آیکونی با این نام در رایانه اجراکننده شبیه‌ساز ترمینال جستجو خواهد شد. می‌تواند چندین بار مشخص شود و نخستین نام یافت‌شده استفاده می‌شود. نام‌های استاندارد: error, file\-manager, help, info, question, system\-monitor, text\-editor, warn, warning
.UNINDENT
.INDENT 0.0
.TP
.B \-\-icon\-path <ICON_PATH>, \-p <ICON_PATH>
مسیر یک فایل تصویری در قالب‌های PNG/JPEG/GIF برای استفاده به عنوان آیکون. اگر هم نام و هم مسیر مشخص شده باشند، ابتدا نام جستجو می‌شود و در صورت نیافتن، از مسیر استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-app\-name <APP_NAME>, \-a <APP_NAME>
نام برنامه برای اعلان.
پیش‌فرض: \fBkitten\-notify\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-button <BUTTON>, \-b <BUTTON>
افزودن دکمه‌ای با متن مشخص‌شده به اعلان. برای افزودن چندین دکمه می‌تواند چندین بار تکرار شود. اگر از \-\-wait\-till\-closed استفاده شود، در صورت کلیک کاربر روی یک دکمه، کیتن شماره آن دکمه را در STDOUT چاپ می‌کند؛ 1 برای نخستین دکمه، 2 برای دومین دکمه و به همین ترتیب.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-urgency <URGENCY>, \-u <URGENCY>
میزان فوریت اعلان.
پیش‌فرض: \fBnormal\fP
انتخاب‌ها: \fBcritical\fP, \fBlow\fP, \fBnormal\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-expire\-after <EXPIRE_AFTER>, \-e <EXPIRE_AFTER>
مدت زمانی که اعلان روی صفحه نمایش داده می‌شود. حالت پیش‌فرض استفاده از سیاست سرویس اعلان‌های سیستم‌عامل است. مقدار \fBnever\fP به این معنی است که اعلان هرگز منقضی نمی‌شود، اگرچه بسته به سیاست‌های سرویس اعلان سیستم‌عامل ممکن است کار کند یا نکند. زمان در قالب NUMBER[SUFFIX] مشخص می‌شود که در آن SUFFIX می‌تواند \fBs\fP برای ثانیه، \fBm\fP برای دقیقه، \fBh\fP برای ساعت یا \fBd\fP برای روز باشد. مقادیر غیرصحیح مجاز هستند. در صورت عدم تعیین، ثانیه فرض می‌شود. بسته شدن خودکار اعلان پس از سپری شدن زمان مشخص‌شده تضمین شده است. اعلان ممکن است پیش از آن توسط اقدام کاربر یا سیاست سیستم‌عامل بسته شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sound\-name <SOUND_NAME>, \-s <SOUND_NAME>
نام صدایی که همراه با اعلان پخش می‌شود. \fBsystem\fP به معنای اجازه دادن به سیستم اعلان برای استفاده از هر صدای دلخواه است. \fBsilent\fP از پخش هرگونه صدایی جلوگیری می‌کند. هر مقدار دیگری به سیستم اعلان دسکتاپ ارسال می‌شود که ممکن است آن را اعمال کند یا نکند.
پیش‌فرض: \fBsystem\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-type <TYPE>, \-t <TYPE>
نوع اعلان. می‌تواند هر رشته‌ای باشد و توسط کاربران برای ایجاد قوانین فیلتر اعلان‌ها استفاده می‌شود؛ بنابراین عبارتی متناسب با هدف اعلان انتخاب کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-identifier <IDENTIFIER>, \-i <IDENTIFIER>
شناسه این اعلان. اگر اعلانی با همین شناسه در حال حاضر نمایش داده شده باشد، جایگزین/به‌روزرسانی می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-print\-identifier [=no], \-P [=no]
چاپ شناسه اعلان در STDOUT. هنگام عدم تعیین شناسه دلخواه با گزینه \-\-identifier مفید است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-wait\-for\-completion [=no], \-\-wait\-till\-closed [=no], \-w [=no]
انتظار تا بسته شدن اعلان. اگر کاربر اعلان را فعال کند (روی آن کلیک کند)، پیش از خروج مقدار \(dq0\(dq در STDOUT چاپ می‌شود. اگر دکمه‌ای روی اعلان فشرده شود، شماره متناظر با آن دکمه در STDOUT چاپ خواهد شد. برای بستن دستی اعلان کلیدهای Esc یا Ctrl+C را فشار دهید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-only\-print\-escape\-code [=no]
تنها چاپ کد گریز (escape code) در STDOUT. در صورتی که از این کیتن به عنوان بخشی از یک برنامه بزرگ‌تر استفاده می‌کنید کاربردی است. اگر این گزینه مشخص شود، از گزینه \-\-wait\-till\-closed برای تولید کد گریز استفاده خواهد شد، اما انتظار واقعی انجام نخواهد گرفت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-icon\-cache\-id <ICON_CACHE_ID>, \-g <ICON_CACHE_ID>
شناسه مورد استفاده هنگام کش کردن آیکون‌ها در شبیه‌ساز ترمینال. استفاده از شناسه بدین معناست که داده‌های آیکون تنها یک‌بار با استفاده از \-\-icon\-path ارسال می‌شوند. فراخوانی‌های بعدی دست‌کم تا زمان راه‌اندازی مجدد ترمینال از داده‌های کش‌شده آیکون استفاده خواهند کرد. این قابلیت هنگام استفاده از این کیتن در یک برنامه بزرگ‌تر همراه با \-\-only\-print\-escape\-code بسیار کاربردی است.
.UNINDENT
.SH "نویسنده (AUTHOR)"
Kovid Goyal
.SH "حق نشر (COPYRIGHT)"
2026, Kovid Goyal
.\" End of generated man page.