'\" t
.\"     Title: notify-send
.\"    Author: Andre Filipe de Assuncao e Brito <decko@noisemakers.org>
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net>
.\"      Date: November 2005
.\"    Manual: User Commands
.\"    Source: libnotify
.\"  Language: Persian
.\"
.TH "NOTIFY\-SEND" "1" "" "libnotify" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
notify-send \- ابزاری برای ارسال اعلان‌های میزکار
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnotify\-send\fR\ 'u
\fBnotify\-send\fR [\fIOPTIONS\fR] {\fIsummary\fR} [\fIbody\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
با استفاده از
\fBnotify\-send\fR
می‌توانید از طریق خط فرمان و به واسطه یک دیمن اعلان (notification daemon)، اعلان‌های میزکار را برای کاربر ارسال کنید\&. این اعلان‌ها می‌توانند برای باخبر کردن کاربر از یک رویداد یا نمایش اطلاعات، بدون ایجاد مزاحمت در کار او، استفاده شوند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-?\fR, \fB\-\-help\fR
.RS 4
نمایش راهنما و خروج\&.
.RE
.PP
\fB\-a\fR, \fB\-\-app\-name\fR=\fIAPP_NAME\fR
.RS 4
نام برنامه را برای اعلان مشخص می‌کند\&.
.RE
.PP
\fB\-A\fR, \fB\-\-action\fR=[\fINAME\fR=]\fIText\&.\&.\&.\fR
.RS 4
عملیات‌هایی را برای نمایش به کاربر مشخص می‌کند\&. این گزینه مستلزم
\fB\-\-wait\fR
برای منتظر ماندن جهت دریافت ورودی کاربر است\&. می‌تواند چندین بار تکرار شود\&. مقدار
\fINAME\fR
عملیات در
stdout
نوشته می‌شود\&. اگر
\fINAME\fR
مشخص نشده باشد، از نمایه عددی گزینه استفاده خواهد شد (شروع از
1)\&.
.RE
.PP
\fB\-\-selected\-action\-fd\fR=\fIFILE_DESCRIPTOR\fR
.RS 4
توصیف‌کننده فایلی (file descriptor) که عملیات انتخاب‌شده توسط کاربر در آن نوشته می‌شود\&.
.RE
.PP
\fB\-\-activation\-token\-fd\fR=\fIFILE_DESCRIPTOR\fR
.RS 4
توصیف‌کننده فایلی که توکن فعال‌سازی عملیات در آن نوشته می‌شود\&. دیمن باید از آن پشتیبانی کند\&.
.RE
.PP
\fB\-u\fR, \fB\-\-urgency\fR=\fILEVEL\fR
.RS 4
سطح اضطرار را مشخص می‌کند (low،
normal،
critical)\&.
.RE
.PP
\fB\-t\fR, \fB\-\-expire\-time\fR=\fITIME\fR
.RS 4
مدت‌زمان (به میلی‌ثانیه) نمایش اعلان بر روی صفحه نمایش\&.
.sp
همه پیاده‌سازی‌ها از این پارامتر استفاده نمی‌کنند\&. GNOME Shell و Notify OSD همیشه آن را نادیده می‌گیرند، در حالی که Plasma آن را برای اعلان‌هایی با سطح اضطرار critical نادیده می‌گیرد\&.
.RE
.PP
\fB\-i\fR, \fB\-\-icon\fR=\fIICON\fR
.RS 4
نام فایل یک آیکون یا یک آیکون استاندارد را برای نمایش مشخص می‌کند\&.
.RE
.PP
\fB\-n\fR, \fB\-\-app\-icon\fR=\fIICON\fR
.RS 4
نام فایل آیکون برنامه یا نام آیکون برنامه را مشخص می‌کند\&. سرور ممکن است آن را نمایش دهد یا ندهد\&.
.RE
.PP
\fB\-c\fR, \fB\-\-category\fR=\fITYPE\fR[,\fITYPE\fR\&...]
.RS 4
دسته‌بندی اعلان را مشخص می‌کند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-hint\fR=\fITYPE\fR:\fINAME\fR:\fIVALUE\fR
.RS 4
داده‌های اضافی اولیه‌ای را برای ارسال مشخص می‌کند\&. انواع معتبر عبارتند از:
BOOLEAN،
INT،
DOUBLE،
STRING،
BYTE
و
VARIANT\&.
.RE
.PP
\fB\-p\fR, \fB\-\-print\-id\fR
.RS 4
شناسه (ID) اعلان را چاپ می‌کند\&.
.RE
.PP
\fB\-\-id\-fd=\fR\fB\fIFILE_DESCRIPTOR\fR\fR
.RS 4
توصیف‌کننده فایلی که شناسه اعلان در آن نوشته می‌شود\&.
.RE
.PP
\fB\-r\fR, \fB\-\-replace\-id\fR=\fIREPLACE_ID\fR
.RS 4
شناسه اعلانی که باید جایگزین شود\&.
.RE
.PP
\fB\-w\fR, \fB\-\-wait\fR
.RS 4
پیش از خروج، تا زمان بسته شدن اعلان منتظر می‌ماند\&. اگر
\fBexpire\-time\fR
تنظیم شده باشد، به عنوان حداکثر زمان انتظار استفاده خواهد شد\&.
.RE
.PP
\fB\-e\fR, \fB\-\-transient\fR
.RS 4
یک اعلان گذرا (transient) را نشان می‌دهد\&. اعلان‌های گذرا قابلیت ماندگاری کارساز (server persistence) را در صورت وجود دور می‌زنند؛ بنابراین تا زمانی که کاربر آن را تأیید کند، ذخیره نخواهند شد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
مشخصات اعلان‌های میزکار (Desktop Notification Spec) در
\m[blue]\fBhttps://specifications\&.freedesktop\&.org/notification\-spec\fR\m[]\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBAndre Filipe de Assuncao e Brito\fR <\&decko@noisemakers\&.org\&>
.RS 4
نویسنده اصلی
.RE
.PP
\fBPaul van Tilburg\fR <\&paulvt@debian\&.org\&>
.RS 4
نویسنده اصلی
.RE
.PP
\fBRiccardo Setti\fR <\&giskard@debian\&.org\&>
.RS 4
نویسنده اصلی
.RE