.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "dunst 5"
.TH dunst 5 2026-08-10 "1.13.2 (2026-03-18)" "Dunst Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
dunstrc \- فایل پیکربندی dunst
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
پیکربندی در قالب مشابه ini به بخش‌هایی تقسیم شده است. هر بخش با نام آن بخش درون قلاب‌ها (کروشه‌ها) آغاز می‌شود. پس از آن فهرستی از جفت‌های کلید-مقدار قرار دارد که تنظیمات را مشخص می‌کنند. فاصله‌های خالی صرفاً جنبهٔ ظاهری دارند و نتیجه را تغییر نمی‌دهند.
.PP
بخش «global» شامل تنظیمات عمومی است که برای تمام dunst اعمال می‌شوند. باقی تنظیمات را می‌توان از طریق قواعد (rules) مشخص کرد و می‌توانند در هر بخشی قرار گیرند. این قواعد می‌توانند یک اعلان را بر اساس ویژگی‌هایش تغییر دهند. قواعد پالایشی (filtering) و قواعد تغییردهنده (modifying) وجود دارند. قواعد پالایشی مشخص می‌کنند که قاعده بر چه اعلان‌هایی اعمال شود. قواعد تغییردهنده دگرگونی‌های اعمال‌شده بر اعلان‌های منطبق را تعیین می‌کنند. برخی از بخش‌های ویژه دارای پالایه‌های ضمنی هستند که قابل تغییر نیستند. به عنوان مثال، بخش «global» فاقد پالایه است: بر تمام اعلان‌ها اعمال می‌شود.
.PP
برای جزئیات بیشتر به بخش قواعد (RULES) مراجعه کنید.
.PP
بخش «experimental» شامل تنظیمات آزمایشی و ناپایدار است. این گزینه‌ها ممکن است بین انتشارها دچار تغییرات ناسازگار شوند. اگر مشکلی در این قابلیت‌های جدید پیدا کردید، حتماً آن را گزارش دهید.
.SS "بخش سراسری (Global section)"
.IX Subsection "Global section"
.IP "\fBdefault_pause_level\fR (مقادیر: [0\-100], پیش‌فرض: 0)" 4
.IX Item "default_pause_level (values: [0-100], default: 0)"
تعیین سطح مکثی که هنگام راه‌اندازی dunst اعمال می‌شود. اعلان‌ها تنها در صورتی نمایش داده می‌شوند که سطح فوریت (urgency) آن‌ها بالاتر از سطح مکث باشد. برای اطلاعات بیشتر به \fBoverride_pause_level\fR مراجعه کنید.
.IP "\fBmonitor\fR (پیش‌فرض: 0)" 4
.IX Item "monitor (default: 0)"
مشخص می‌کند اعلان‌ها باید در کدام نمایشگر نشان داده شوند، چه با نام و چه با شماره که از 0 آغاز می‌شود. تنظیم \fBfollow\fR را ببینید.
.IP "\fBfollow\fR (مقادیر: [none/mouse/keyboard], پیش‌فرض: none)" 4
.IX Item "follow (values: [none/mouse/keyboard], default: none)"
تعیین می‌کند اعلان‌ها در یک پیکربندی چندنمایشگره در کجا قرار گیرند. تمام مقادیر به جز \fInone\fR تنظیم \fBmonitor\fR را لغو (override) می‌کنند.
.Sp
در ویلند (Wayland) هیچ تفاوتی بین تمرکز ماوس و صفحه‌کلید وجود ندارد. هنگامی که از هر یک از آن‌ها استفاده شود، کامپوزیتور یک خروجی را انتخاب می‌کند. این معمولاً خروجی‌ای خواهد بود که آخرین بار با آن تعامل شده است.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
اعلان‌ها روی نمایشگری که با تنظیم \fBmonitor\fR مشخص شده است قرار خواهند گرفت.
.IP \fBmouse\fR 4
.IX Item "mouse"
اعلان‌ها روی نمایشگری قرار می‌گیرند که ماوس در حال حاضر درون آن است.
.IP \fBkeyboard\fR 4
.IX Item "keyboard"
اعلان‌ها روی نمایشگری قرار می‌گیرند که حاوی پنجره با تمرکز صفحه‌کلید است.
.RE
.RS 4
.RE
.IP "\fBenable_posix_regex\fR (پیش‌فرض: false)" 4
.IX Item "enable_posix_regex (default: false)"
هنگامی که روی true تنظیم شود (توصیه‌شده)، می‌توانید از عبارات باقاعده POSIX برای قواعد پالایش استفاده کنید. از نحو عبارات باقاعده تعمیم‌یافته POSIX استفاده می‌کند:
https://en.m.wikibooks.org/wiki/Regular_Expressions/POSIX\-Extended_Regular_Expressions.
.Sp
اگر روی false تنظیم شود (توصیه نمی‌شود)، dunst از \fBfnmatch\fR\|(3) برای تطبیق رشته‌ها استفاده خواهد کرد. Dunst هیچ پرچمی به fnmatch ارسال نمی‌کند، بنابراین نمی‌توانید از الگوهای گسترش‌یافته بهره ببرید.
.Sp
نحو POSIX قدرتمندتر است و در نهایت به حالت پیش‌فرض تبدیل خواهد شد. تفاوت‌های اصلی بین POSIX و \fBfnmatch\fR\|(3) این است که POSIX به جای «*» از «.*» برای نویسه‌های عمومی (wildcards) استفاده می‌کند و POSIX اجازه تطبیق‌های جزئی بدون نیاز به نویسه عمومی را می‌دهد. این بدان معناست که الگوی "abc" با تمام رشته‌هایی که حاوی "abc" هستند، مانند "abcdef"، مطابقت خواهد داشت.
.IP "\fBgeometry\fR منسوخ‌شده" 4
.IX Item "geometry DEPRECATED"
این تنظیم منسوخ و حذف شده است. به گزینه‌های \fBwidth\fR، \fBheight\fR، \fBorigin\fR، \fBnotification_limit\fR و \fBoffset\fR تقسیم شده است.
برای مهاجرت سریع به نحو جدید، می‌توانید مقادیر عددی را از پیکربندی geometry قدیمی خود به صورت زیر بردارید:
        geometry = <width>x<height>+<offset>
.Sp
در پیکربندی جدید می‌توانید متغیرهای زیر را تنظیم کنید (حتماً علامت‌های منفی را حذف کنید):
.Sp
.Vb 4
\&    width = <width>
\&    height = <height>
\&    offset = <offset>
\&    origin = top\-right # یا top-left، یا هر جهت دلخواه دیگر
.Ve
.IP \fBwidth\fR 4
.IX Item "width"
عرض پنجره اعلان بر حسب پیکسل. می‌تواند یک عدد واحد برای تعیین عرض ثابت باشد یا دو عدد برای حداقل و حداکثر عرض. اعلان در صورت نیاز از حداقل عرض گسترش می‌یابد.
.Sp
مثال‌ها:
.Sp
.Vb 2
\&    width = 300      # عرض ثابت ۳۰۰
\&    width = (0, 300) # عرض بین ۰ و ۳۰۰
.Ve
.Sp
هنگام تنظیم عرضی بزرگتر از صفحه نمایش، dunst عرض را به عرض صفحه محدود می‌کند. بنابراین اگر می‌خواهید اعلان به صورت پویا کل صفحه را بپوشاند، می‌توانید عرض را روی عددی به اندازه کافی بزرگ تنظیم کنید که هیچ‌یک از نمایشگرهای شما از آن فراتر نرود (مثلاً 10000).
.IP \fBheight\fR 4
.IX Item "height"
ارتفاع هر اعلان بر حسب پیکسل. می‌تواند یک عدد واحد برای تعیین ارتفاع ثابت یا دو عدد برای حداقل و حداکثر ارتفاع باشد. اعلان در صورت نیاز از حداقل ارتفاع گسترش می‌یابد.
.Sp
مثال‌ها:
.Sp
.Vb 2
\&    height = 300      # ارتفاع ثابت ۳۰۰
\&    height = (0, 300) # ارتفاع بین ۰ و ۳۰۰
.Ve
.Sp
توجه داشته باشید که برخلاف عرض، اعلان‌های مختلف می‌توانند مقادیر ارتفاع متفاوتی داشته باشند.
.Sp
نسخه v1.11 و قدیمی‌تر dunst از ارتفاع پویا پشتیبانی نمی‌کنند و \fBheight\fR یک مقدار واحد را می‌پذیرد که رفتار آن معادل (0, value) است.
.IP "\fBnotification_limit\fR (پیش‌فرض: 20)" 4
.IX Item "notification_limit (default: 20)"
تعداد اعلان‌هایی که می‌توانند در یک زمان ظاهر شوند. با رسیدن به این حد، هر اعلان اضافی در صف قرار می‌گیرد و هنگامی که اعلان‌های در حال نمایش فعلی منقضی شوند یا به صورت دستی بسته شوند، نمایش داده خواهند شد. مقدار 0 به معنای نامحدود است. اگر \fBindicate_hidden\fR برابر با true باشد، حد مشخص‌شده ۱ واحد کاهش می‌یابد و آخرین اعلان پیامی خواهد بود که اطلاع می‌دهد چند اعلان پنهان در انتظار نمایش هستند. برای اطلاعات بیشتر ورودی \fBindicate_hidden\fR را ببینید.
.IP "\fBorigin\fR (پیش‌فرض: top\-right)" 4
.IX Item "origin (default: top-right)"
مبدأ پنجره اعلان بر روی صفحه نمایش. سپس می‌تواند با offset جابه‌جا شود.
مبدأ می‌تواند یکی از موارد زیر باشد:
.Sp
.Vb 9
\&    top\-left
\&    top\-center
\&    top\-right
\&    bottom\-left
\&    bottom\-center
\&    bottom\-right
\&    left\-center
\&    center
\&    right\-center
.Ve
.IP "\fBoffset\fR (قالب: (horizontal, vertical), پیش‌فرض: (10, 50))" 4
.IX Item "offset (format: (horizontal, vertical), default: (10, 50))"
به ترتیب فاصله (آفست) افقی و عمودی بر حسب پیکسل از گوشه صفحه نمایش مشخص‌شده توسط \fBorigin\fR. آفست منفی منجر به قرار گرفتن اعلان در خارج از صفحه می‌شود.
.Sp
مثال‌ها:
.Sp
.Vb 2
\&    origin = top\-right
\&    offset = (10, 300) # حاشیه ۱۰ پیکسلی از راست و ۳۰۰ پیکسلی از بالا
.Ve
.Sp
نسخه v1.11 و قدیمی‌تر dunst به جای آن از نحو NxN استفاده می‌کنند (آفست X در آفست Y). برای سازگاری با گذشته، این نحو نیز پذیرفته می‌شود.
.Sp
.Vb 1
\&    offset = 10x300
.Ve
.IP "\fBscale\fR (پیش‌فرض: 0) (فقط X11)" 4
.IX Item "scale (default: 0) (X11 only)"
ضریب مقیاس را برای ابعاد جهت تطبیق اعلان‌ها با نمایشگرهای HiDPI مشخص می‌کند. این مقیاس هندسه اعلان و محتویات آن را مقیاس‌بندی می‌کند. استفاده از ضریب مقیاس کسری توصیه نمی‌شود، زیرا ممکن است باعث شود اشیاء یک پیکسل جابه‌جا شوند. سعی کنید از ضریب مقیاس عدد صحیح استفاده کرده و اندازه قلم و سایر اندازه‌ها را در صورت نیاز تنظیم کنید. اگر 0 مشخص شود، ضریب مقیاس به طور خودکار تشخیص داده می‌شود.
.IP "\fBprogress_bar\fR (مقادیر: [true/false], پیش‌فرض: true)" 4
.IX Item "progress_bar (values: [true/false], default: true)"
هنگامی که یک مقدار عدد صحیح به عنوان نشانه (hint) به dunst ارسال می‌شود (به بخش NOTIFY\-SEND مراجعه کنید)، یک نوار پیشرفت در پایین اعلان ترسیم خواهد شد. این رفتار را می‌توان با تنظیم این گزینه روی false غیرفعال کرد.
.IP "\fBprogress_bar_horizontal_alignment\fR (مقادیر: [left/center/right], پیش‌فرض: center)" 4
.IX Item "progress_bar_horizontal_alignment (values: [left/center/right], default: center)"
تراز افقی نوار پیشرفت. نوار پیشرفت همیشه فاصله \fBhorizontal_padding\fR را از لبه اعلان حفظ می‌کند.
.IP "\fBprogress_bar_height\fR (پیش‌فرض: 10)" 4
.IX Item "progress_bar_height (default: 10)"
ارتفاع نوار پیشرفت بر حسب پیکسل. این مقدار شامل کادر نیز می‌شود. اطمینان حاصل کنید که این مقدار بیشتر از دو برابر عرض کادر باشد.
.IP "\fBprogress_bar_min_width\fR (پیش‌فرض: 150)" 4
.IX Item "progress_bar_min_width (default: 150)"
حداقل عرض نوار پیشرفت بر حسب پیکسل. اعلان برای جا گرفتن نوار تغییر اندازه می‌دهد.
.IP "\fBprogress_bar_max_width\fR (پیش‌فرض: 300)" 4
.IX Item "progress_bar_max_width (default: 300)"
حداکثر عرض نوار پیشرفت بر حسب پیکسل. اعلان برای جا گرفتن نوار پیشرفت تغییر اندازه می‌دهد.
.IP "\fBprogress_bar_frame_width\fR (پیش‌فرض: 1)" 4
.IX Item "progress_bar_frame_width (default: 1)"
عرض کادر نوار پیشرفت بر حسب پیکسل. این مقدار باید کوچکتر از نصف ارتفاع نوار پیشرفت باشد.
.IP "\fBprogress_bar_corner_radius\fR (پیش‌فرض: 0)" 4
.IX Item "progress_bar_corner_radius (default: 0)"
شعاع گوشه نوار پیشرفت بر حسب پیکسل. به نوار پیشرفت گوشه‌های گرد می‌دهد. برای غیرفعال کردن روی 0 تنظیم کنید.
.Sp
اگر \fBprogress_bar_corners\fR روی none تنظیم شده باشد، این تنظیم نادیده گرفته خواهد شد.
.IP "\fBprogress_bar_corners\fR (پیش‌فرض: all)" 4
.IX Item "progress_bar_corners (default: all)"
مشخص می‌کند هنگام ترسیم نوار پیشرفت کدام گوشه‌ها گرد شوند. اگر progress_bar_corner_radius روی 0 تنظیم شود، این گزینه نادیده گرفته می‌شود.
.Sp
برای قالب مقدار به تنظیم \fBcorners\fR مراجعه کنید.
.IP "\fBicon_corner_radius\fR (پیش‌فرض: 0)" 4
.IX Item "icon_corner_radius (default: 0)"
شعاع گوشه تصویر آیکون بر حسب پیکسل. به آیکون گوشه‌های گرد می‌دهد. برای غیرفعال کردن روی 0 تنظیم کنید.
.Sp
اگر \fBicon_corners\fR روی none تنظیم شود، این تنظیم نادیده گرفته خواهد شد.
.IP "\fBicon_corners\fR (پیش‌فرض: all)" 4
.IX Item "icon_corners (default: all)"
مشخص می‌کند هنگام ترسیم تصویر آیکون کدام گوشه‌ها گرد شوند. اگر icon_corner_radius روی 0 تنظیم شود، این گزینه نادیده گرفته می‌شود.
.Sp
برای قالب مقدار به تنظیم \fBcorners\fR مراجعه کنید.
.IP "\fBindicate_hidden\fR (مقادیر: [true/false], پیش‌فرض: true)" 4
.IX Item "indicate_hidden (values: [true/false], default: true)"
اگر روی true تنظیم شود، اعلانی که نشان می‌دهد چه تعداد اعلان به دلیل محدودیت اعلان‌ها (به \fBnotification_limit\fR مراجعه کنید) نمایش داده نمی‌شوند، \fBبه جای آخرین جایگاه اعلان\fR نشان داده خواهد شد.
.Sp
بدین معنی که در صورت فعال بودن، تعداد اعلان‌های قابل مشاهده ۱ عدد کمتر از مقدار مشخص‌شده در \fBnotification_limit\fR خواهد بود و آخرین جایگاه به شمارش اعلان‌های پنهان اختصاص می‌یابد.
.IP "\fBtransparency\fR (پیش‌فرض: 0) (فقط X11)" 4
.IX Item "transparency (default: 0) (X11 only)"
محدوده‌ای از ۰ تا ۱۰۰ برای میزان شفافیت پنجره اعلان؛ ۰ کاملاً مات و ۱۰۰ کاملاً نامرئی است.
.Sp
این گزینه روی کل پنجره تأثیر می‌گذارد. برای شفاف کردن تنها بخش‌هایی از یک پنجره، کانال آلفا را در یک رنگ تنظیم کنید، به بخش رنگ‌ها (COLORS) مراجعه کنید.
.Sp
برای شفاف کردن پنجره‌ها در ویلند، بخش شفاف یک رنگ را تنظیم کنید، به COLORS مراجعه کنید.
.Sp
این تنظیم تنها در صورتی کار می‌کند که یک کامپوزیتور در حال اجرا باشد.
.IP "\fBseparator_height\fR (پیش‌فرض: 2)" 4
.IX Item "separator_height (default: 2)"
ارتفاع خط جداکننده بین اعلان‌ها بر حسب پیکسل؛ اگر روی 0 تنظیم شود هیچ خط جداکننده‌ای بین اعلان‌ها وجود نخواهد داشت. اگر \fBgap_size\fR بیشتر از 0 باشد، این تنظیم نادیده گرفته می‌شود.
.IP "\fBpadding\fR (پیش‌فرض: 8)" 4
.IX Item "padding (default: 8)"
فاصله بر حسب پیکسل از محتوا تا جداکننده/کادر پنجره در محور عمودی.
.IP "\fBhorizontal_padding\fR (پیش‌فرض: 8)" 4
.IX Item "horizontal_padding (default: 8)"
فاصله بر حسب پیکسل از محتوا تا کادر پنجره در محور افقی.
.IP "\fBtext_icon_padding\fR (پیش‌فرض: 0)" 4
.IX Item "text_icon_padding (default: 0)"
فاصله بر حسب پیکسل از متن تا آیکون (یا برعکس) در محور افقی.
.Sp
تنظیم این مقدار به عددی غیر صفر، هرگونه فاصله‌گذاری که horizontal_padding بین متن اعلان و آیکون اضافه می‌کرد را بازنویسی می‌کند.
.Sp
بنابراین برای مثال تنظیم:
.Sp
.Vb 2
\&    text_icon_padding=10
\&    horizontal_padding=10
.Ve
.Sp
معادل است با:
.Sp
.Vb 2
\&    text_icon_padding=0
\&    horizontal_padding=10
.Ve
.IP "\fBframe_width\fR (پیش‌فرض: 3)" 4
.IX Item "frame_width (default: 3)"
عرض کادر دور پنجره اعلان را بر حسب پیکسل تعیین می‌کند. برای غیرفعال کردن روی 0 تنظیم کنید.
.IP "\fBgap_size\fR (پیش‌فرض: 0)" 4
.IX Item "gap_size (default: 0)"
اندازه شکاف (فاصله) برای نمایش بین اعلان‌ها.
.Sp
اگر مقدار بیشتر از 0 باشد، \fBseparator_height\fR نادیده گرفته می‌شود و در عوض حاشیه‌ای با اندازه \fBframe_width\fR دور هر اعلان کشیده می‌شود.
.Sp
این تنظیم به یک کامپوزیتور نیاز دارد و هر برنامه‌ای که در میان شکاف‌ها نمایش داده می‌شود در حال حاضر قابل کلیک نیست.
.IP "\fBseparator_color\fR (مقادیر: [auto/foreground/frame/#RRGGBB], پیش‌فرض: frame)" 4
.IX Item "separator_color (values: [auto/foreground/frame/#RRGGBB], default: frame)"
رنگ خط جداکننده بین دو اعلان را تنظیم می‌کند.
.RS 4
.IP \fBauto\fR 4
.IX Item "auto"
دوانست سعی می‌کند به طور خودکار رنگی متناسب با طرح رنگ بقیه اعلان پیدا کند.
.IP \fBforeground\fR 4
.IX Item "foreground"
رنگ برابر با رنگ پیش‌زمینه بالاترین اعلانی که جدا می‌شود تنظیم خواهد شد.
.IP \fBframe\fR 4
.IX Item "frame"
رنگ برابر با رنگ کادر اعلانی با بالاترین فوریت در میان ۲ اعلانی که جدا می‌شوند تنظیم خواهد شد.
.IP "\fBهر مقدار دیگر\fR" 4
.IX Item "anything else"
هر مقدار دیگری به عنوان رنگ تفسیر می‌شود، به بخش COLORS مراجعه کنید.
.RE
.RS 4
.RE
.IP "\fBsort\fR (مقادیر: [true/false/id/urgency_ascending/urgency_descending/update], پیش‌فرض: true)" 4
.IX Item "sort (values: [true/false/id/urgency_ascending/urgency_descending/update], default: true)"
اگر روی true یا urgency_descending تنظیم شود، اعلان‌های با فوریت بالاتر را بالاتر از بقیه نمایش می‌دهد: ابتدا بحرانی (critical)، سپس عادی (normal)، سپس کم‌اهمیت (low).
.Sp
اگر روی false یا id تنظیم شود، اعلان‌ها بر اساس شناسه (id) مرتب می‌شوند.
.Sp
اگر روی urgency_ascending تنظیم شود، اعلان‌ها به ترتیب صعودی فوریت مرتب می‌شوند: ابتدا کم‌اهمیت، سپس عادی، سپس بحرانی.
.Sp
اگر روی update تنظیم شود، اعلان‌ها بر اساس update_time خود مرتب می‌شوند؛ بنابراین تازه‌ترین همیشه در بالا قرار دارد. این بدان معناست که اگر sort را روی update و stack_duplicates را روی true تنظیم کنید، مورد تکراری همیشه در بالا خواهد بود.
.Sp
هنگامی که پنجره اعلان در پایین صفحه باشد، این ترتیب به طور خودکار معکوس می‌شود.
.IP "\fBidle_threshold\fR (پیش‌فرض: 0)" 4
.IX Item "idle_threshold (default: 0)"
اگر کاربر بیش از این مدت بیکار (idle) باشد، زمان انقضای اعلان‌ها به پایان نرسد. برای زمان‌های معتبر به بخش قالب زمان (TIME FORMAT) مراجعه کنید.
.Sp
برای غیرفعال کردن روی 0 تنظیم کنید.
.Sp
یک کلاینت می‌تواند اعلان را به عنوان گذرا (transient) علامت‌گذاری کند تا این تنظیم را دور زده و در هر صورت منقضی شود. از یک قاعده با «set_transient = no» برای غیرفعال کردن این رفتار استفاده کنید.
.Sp
توجه: این قابلیت روی xwayland کار نمی‌کند.
.IP "\fBlayer\fR (مقادیر: [bottom/top/overlay], پیش‌فرض: overlay) (فقط ویلند)" 4
.IX Item "layer (values: [bottom/top/overlay], default: overlay) (Wayland only)"
اعلان‌های dunst را در لایه انتخاب‌شده قرار می‌دهد. استفاده از overlay باعث می‌شود اعلان‌ها بالای پنجره‌های تمام‌صفحه نمایش داده شوند، هرچند بسته به کامپوزیتور شما ممکن است در top نیز رخ دهد.
.Sp
لایه bottom زیر تمام پنجره‌ها و بالای پس‌زمینه قرار دارد.
.IP "\fBforce_xwayland\fR (مقادیر: [true/false], پیش‌فرض: false) (فقط ویلند)" 4
.IX Item "force_xwayland (values: [true/false], default: false) (Wayland only)"
استفاده از خروجی X11 را حتی در کامپوزیتور ویلند اجبار می‌کند. این تنظیم هنگام عدم استفاده از کامپوزیتور ویلند هیچ تأثیری ندارد.
.Sp
اگر dunst بدون پشتیبانی X11 کامپایل شده باشد، این تنظیم نادیده گرفته می‌شود.
.IP "\fBfont\fR (پیش‌فرض: ""Monospace 8"")" 4
.IX Item "font (default: ""Monospace 8"")"
قلم یا مجموعه قلم‌های مورد استفاده را تعیین می‌کند. به صورت اختیاری اندازه را به عنوان یک عدد اعشاری پس از نام قلم و فاصله تنظیم کنید.
گزینه‌های چندگانه قلم را می‌توان با ویرگول از هم جدا کرد.
.Sp
این گزینه به عنوان توصیف قلم Pango تجزیه می‌شود. اطلاعات بیشتر در مورد قالب رشته را می‌توان در اینجا یافت: https://docs.gtk.org/Pango/type_func.FontDescription.from_string.html.
.IP "\fBline_height\fR (پیش‌فرض: 0)" 4
.IX Item "line_height (default: 0)"
میزان فاصله اضافی بین خطوط متن بر حسب پیکسل. برای غیرفعال کردن روی 0 تنظیم کنید.
.IP "\fBformat\fR (پیش‌فرض: ""<b>%s</b>\en%b"")" 4
.IX Item "format (default: ""<b>%s</b>n%b"")"
مشخص می‌کند ویژگی‌های مختلف اعلان چگونه باید روی پنجره اعلان قالب‌بندی شوند.
.Sp
صرف‌نظر از وضعیت تنظیم \fBmarkup\fR، هرگونه برچسب نشانه‌گذاری موجود در قالب تجزیه خواهد شد. توجه داشته باشید که به همین دلیل، اگر یک علامت امپرسند لفظی (&) مورد نیاز باشد، باید به صورت «&amp;» فرار داده (escape) شود.
.Sp
اگر «\en» یا «\et» در هر کجای قالب وجود داشته باشد، به ترتیب با یک خط جدید یا نویسه تب جایگزین می‌شود.
.Sp
اگر هر یک از رشته‌های زیر وجود داشته باشد، با ویژگی اعلان معادل جایگزین می‌شود.
.Sp
برای مرجع کامل نشانه‌گذاری، به <https://docs.gtk.org/Pango/pango_markup.html> مراجعه کنید.
.RS 4
.ie n .IP "\fR\fB%a\fR\fB\fR  نام برنامه (appname)" 4
.el .IP "\fR\f(CB%a\fR\fB\fR  نام برنامه (appname)" 4
.IX Item "%a appname"
.PD 0
.ie n .IP "\fR\fB%s\fR\fB\fR  خلاصه (summary)" 4
.el .IP "\fR\f(CB%s\fR\fB\fR  خلاصه (summary)" 4
.IX Item "%s summary"
.ie n .IP "\fR\fB%b\fR\fB\fR  بدنه (body)" 4
.el .IP "\fR\f(CB%b\fR\fB\fR  بدنه (body)" 4
.IX Item "%b body"
.ie n .IP "\fR\fB%c\fR\fB\fR  دسته‌بندی (category)" 4
.el .IP "\fR\f(CB%c\fR\fB\fR  دسته‌بندی (category)" 4
.IX Item "%c category"
.ie n .IP "\fR\fB%S\fR\fB\fR  برچسب پشته (stack_tag)" 4
.el .IP "\fR\f(CB%S\fR\fB\fR  برچسب پشته (stack_tag)" 4
.IX Item "%S stack_tag"
.ie n .IP "\fR\fB%i\fR\fB\fR  نام آیکون (به همراه مسیر آن)" 4
.el .IP "\fR\f(CB%i\fR\fB\fR  نام آیکون (به همراه مسیر آن)" 4
.IX Item "%i iconname (including its path)"
.ie n .IP "\fR\fB%I\fR\fB\fR  نام آیکون (بدون مسیر آن)" 4
.el .IP "\fR\f(CB%I\fR\fB\fR  نام آیکون (بدون مسیر آن)" 4
.IX Item "%I iconname (without its path)"
.ie n .IP "\fR\fB%p\fR\fB\fR  مقدار پیشرفت ([  0%] تا [100%])" 4
.el .IP "\fR\f(CB%p\fR\fB\fR  مقدار پیشرفت ([  0%] تا [100%])" 4
.IX Item "%p progress value ([ 0%] to [100%])"
.ie n .IP "\fR\fB%n\fR\fB\fR  مقدار پیشرفت بدون نویسه‌های اضافی" 4
.el .IP "\fR\f(CB%n\fR\fB\fR  مقدار پیشرفت بدون نویسه‌های اضافی" 4
.IX Item "%n progress value without any extra characters"
.IP "\fB%%\fR  علامت % لفظی" 4
.IX Item "%% literal %"
.PD
.RE
.RS 4
.Sp
اگر هر یک از این موارد در قالب وجود داشته باشد اما در اعلان مشخص نشده باشد (مثلاً آیکونی تنظیم نشده باشد)، نگه‌دارنده‌ها به سادگی از قالب حذف خواهند شد.
.RE
.IP "\fBvertical_alignment\fR (مقادیر: [top/center/bottom], پیش‌فرض: center)" 4
.IX Item "vertical_alignment (values: [top/center/bottom], default: center)"
مشخص می‌کند متن و آیکون چگونه باید به صورت عمودی درون اعلان تراز شوند.
.IP "\fBshow_age_threshold\fR (پیش‌فرض: 60)" 4
.IX Item "show_age_threshold (default: 60)"
اگر پیام قدیمی‌تر از این مدت باشد، سن پیام را نشان می‌دهد. برای زمان‌های معتبر به بخش TIME FORMAT مراجعه کنید.
.Sp
برای غیرفعال کردن روی \-1 تنظیم کنید.
.IP "\fBignore_newline\fR (مقادیر: [true/false], پیش‌فرض: false)" 4
.IX Item "ignore_newline (values: [true/false], default: false)"
اگر روی true تنظیم شود، نویسه‌های خط جدید در اعلان‌ها را با فاصله خالی جایگزین می‌کند.
.IP "\fBstack_duplicates\fR (مقادیر: [true/false], پیش‌فرض: true)" 4
.IX Item "stack_duplicates (values: [true/false], default: true)"
اگر روی true تنظیم شود، اعلان‌های تکراری به جای نمایش جداگانه روی هم انباشته (stack) می‌شوند.
.Sp
دو اعلان در صورتی تکراری در نظر گرفته می‌شوند که نام برنامه‌ای که آن را ارسال کرده، خلاصه، بدنه، آیکون و فوریت همگی یکسان باشند.
.IP "\fBhide_duplicate_count\fR (مقادیر: [true/false], پیش‌فرض: false)" 4
.IX Item "hide_duplicate_count (values: [true/false], default: false)"
تعداد اعلان‌های تکراری انباشته‌شده را پنهان می‌کند.
.IP "\fBshow_indicators\fR (مقادیر: [true/false], پیش‌فرض: true)" 4
.IX Item "show_indicators (values: [true/false], default: true)"
اگر اعلانی شامل کنش‌ها (actions) و/یا نشانی‌های وب قابل باز شدن باشد، یک نشانگر نمایش داده می‌شود. برای جزئیات بیشتر به بخش ACTIONS در زیر مراجعه کنید.
.IP "\fBicon_path\fR (پیش‌فرض: ""/usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/"")" 4
.IX Item "icon_path (default: ""/usr/share/icons/gnome/16x16/status/:/usr/share/icons/gnome/16x16/devices/"")"
می‌تواند به فهرستی از مسیرهای جداشده با دونقطه برای جستجوی آیکون‌های مورد استفاده در اعلان‌ها تنظیم شود.
.Sp
Dunst خارج از این شاخه‌ها را جستجو نمی‌کند. برای سامانه بازگشتی جستجوی آیکون، به \fBenable_recursive_icon_lookup\fR مراجعه کنید. این سامانه جدید در نهایت جایگزین جستجوی icon_path خواهد شد.
.IP "\fBicon_theme\fR (پیش‌فرض: ""Adwaita"", مثال: ""Adwaita, breeze"")" 4
.IX Item "icon_theme (default: ""Adwaita"", example: ""Adwaita, breeze"")"
فهرست جداشده با ویرگول از نام پوسته‌های مورد استفاده برای جستجوی آیکون‌ها. این باید نام شاخه‌ای باشد که پوسته در آن قرار دارد، نه نام نمایشی و کاربرپسند پوسته. بنابراین برای مثال، پوسته \fBBreeze Dark\fR در \fI/usr/share/icons/breeze\-dark\fR قرار دارد. در این حالت باید پوسته را روی \fBbreeze\-dark\fR تنظیم کنید.
.Sp
اولین پوسته در فهرست مهم‌ترین است. تنها در صورتی که آیکون در آن پوسته یافت نشود، پوسته بعدی امتحان خواهد شد.
.Sp
Dunst پوسته‌ها را در \fBXDG_DATA_HOME/icons\fR و \fR\f(CB$XDG_DATA_DIRS\fR\fB/icons\fR طبق مشخصات پوسته آیکون جستجو می‌کند:
https://specifications.freedesktop.org/icon\-theme\-spec/icon\-theme\-spec\-latest.html.
.Sp
اگر پوسته از پوسته‌های دیگر ارث‌بری کند، از آن‌ها به عنوان پشتیبان استفاده خواهد شد.
.Sp
این تنظیم به صورت پیش‌فرض فعال نیست. برای نحوه فعال‌سازی به \fBenable_recursive_icon_lookup\fR مراجعه کنید.
.IP "\fBenable_recursive_icon_lookup\fR (پیش‌فرض: false)" 4
.IX Item "enable_recursive_icon_lookup (default: false)"
این تنظیم روش جدید جستجوی آیکون را فعال می‌کند. این سامانه جدید در نهایت جایگزین جستجوی قدیمی آیکون خواهد شد.
.Sp
در حال حاضر آیکون‌ها در \fBicon_path\fR جستجو می‌شوند. از آنجا که \fBicon_path\fR بازگشتی نبود، کاربر مجبور بود مسیرهای زیادی را به این فهرست اضافه کند. این فرایند با روش جدید جستجو به شدت ساده شده است. اکنون فقط باید \fBicon_theme\fR را روی نام پوسته مورد نظر خود تنظیم کنید. برای فعال کردن این رفتار جدید، \fBenable_recursive_icon_lookup\fR را در بخش \fI[global]\fR روی true تنظیم کنید. برای جزئیات بیشتر به تنظیمات مربوطه مراجعه کنید.
.IP "\fBsticky_history\fR (مقادیر: [true/false], پیش‌فرض: true)" 4
.IX Item "sticky_history (values: [true/false], default: true)"
اگر روی true تنظیم شود، اعلان‌هایی که از تاریخچه فراخوانی شده‌اند به طور خودکار منقضی نمی‌شوند.
.IP "\fBhistory_length\fR (پیش‌فرض: 20)" 4
.IX Item "history_length (default: 20)"
حداکثر تعداد اعلان‌هایی که در تاریخچه نگه داشته می‌شوند. پس از رسیدن به این حد، با رسیدن اعلان جدید، اعلان‌های قدیمی‌تر حذف خواهند شد. به بخش HISTORY مراجعه کنید.
.IP "\fBdmenu\fR (پیش‌فرض: ""/usr/bin/dmenu \-p dunst"")" 4
.IX Item "dmenu (default: ""/usr/bin/dmenu -p dunst"")"
دستوری که هنگام باز کردن منوی زمینه (context menu) اجرا خواهد شد. باید یک دستور dmenu یا یک منوی سازگار با dmenu باشد.
.IP "\fBbrowser\fR (پیش‌فرض: ""/usr/bin/xdg\-open"")" 4
.IX Item "browser (default: ""/usr/bin/xdg-open"")"
دستوری که هنگام باز کردن یک نشانی وب (URL) اجرا خواهد شد. نشانی وبی که باید باز شود به انتهای مقدار این تنظیم پیوست خواهد شد.
.IP "\fBalways_run_script\fR (مقادیر: [true/false] پیش‌فرض: true]" 4
.IX Item "always_run_script (values: [true/false] default: true]"
همیشه اسکریپت‌های تعریف‌شده در قواعد را اجرا کند، حتی اگر اعلان با \f(CW\*(C`format = ""\*(C'\fR سرکوب شده باشد. به بخش SCRIPTING مراجعه کنید.
.IP "\fBtitle\fR (پیش‌فرض: ""Dunst"") (فقط X11)" 4
.IX Item "title (default: ""Dunst"") (X11 only)"
عنوان (ویژگی \fI_NET_WM_NAME\fR) پنجره‌های اعلان ایجادشده توسط dunst را تعیین می‌کند.
.Sp
برای استفاده معمول نیازی به تغییر این تنظیم نیست.
.IP "\fBclass\fR (پیش‌فرض: ""Dunst"") (فقط X11)" 4
.IX Item "class (default: ""Dunst"") (X11 only)"
کلاس (بخش اول \fIWM_CLASS\fR) پنجره‌های اعلان ایجادشده توسط dunst را تعیین می‌کند.
.Sp
برای استفاده معمول نیازی به تغییر این تنظیم نیست.
.IP "\fBforce_xinerama\fR (مقادیر: [true/false], پیش‌فرض: false) (فقط X11)" 4
.IX Item "force_xinerama (values: [true/false], default: false) (X11 only)"
استفاده از افزونه Xinerama به جای RandR برای پشتیبانی از چند نمایشگر. این تنظیم \fIجهت سازگاری\fR با درایورهای قدیمی‌تر nVidia که از RandR پشتیبانی نمی‌کنند ارائه شده است و استفاده از آن در سامانه‌هایی که از RandR پشتیبانی می‌کنند \fIاکیداً منع می‌شود\fR.
.Sp
با فعال کردن این تنظیم، dunst قادر نخواهد بود اتصال یا قطع اتصال نمایشگر را تشخیص دهد که در صورت تغییر چیدمان صفحه ممکن است حالت follow را با مشکل مواجه کند.
.IP "\fBcorner_radius\fR (پیش‌فرض: 0)" 4
.IX Item "corner_radius (default: 0)"
شعاع گوشه را بر حسب پیکسل تعیین می‌کند. شعاع گوشه 0 منجر به اعلان‌هایی با شکل مستطیلی می‌شود.
.Sp
با فعال کردن این تنظیم، حاشیه بیرونی و کادر شکل داده می‌شوند. اگر چندین اعلان داشته باشید، کل پنجره شکل می‌گیرد نه تک‌تک اعلان‌ها، مگر اینکه شکاف‌ها فعال باشند (به \fBgap_size\fR مراجعه کنید).
.Sp
برای جلوگیری از بریده شدن آیکون یا متن توسط گوشه‌ها، اگر شعاع گوشه از نصف ارتفاع اعلان بیشتر شود، به طور خودکار به نصف ارتفاع اعلان کاهش می‌یابد.
.Sp
اگر \fBcorners\fR روی none تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.
.IP "\fBcorners\fR (مقادیر: [none/all/bottom\-right/bottom\-left/top\-right/top\-left/top/bottom/left/right], پیش‌فرض: all)" 4
.IX Item "corners (values: [none/all/bottom-right/bottom-left/top-right/top-left/top/bottom/left/right], default: all)"
فهرست جداشده با ویرگول از گوشه‌هایی که هنگام ترسیم پنجره باید گرد شوند.
.Sp
اگر شعاع گوشه روی 0 تنظیم شود، این گزینه نادیده گرفته می‌شود.
.IP "\fBmouse_[left/middle/right]_click\fR (مقادیر: [none/do_action/close_current/close_all/context/context_all])" 4
.IX Item "mouse_[left/middle/right]_click (values: [none/do_action/close_current/close_all/context/context_all])"
کنش کلیک ماوس را تعریف می‌کند. ورودی لمسی در ویلند مانند کلیک چپ ماوس عمل می‌کند. فهرستی از مقادیر، جداشده با ویرگول، می‌تواند برای چندین کنش مشخص شود تا به ترتیب اجرا شوند.
.Sp
\&\fBپیش‌فرض‌ها:\fR
.RS 4
.IP \(bu 8
\&\f(CW\*(C`mouse_left_click=close_current\*(C'\fR
.IP \(bu 8
\&\f(CW\*(C`mouse_middle_click=do_action, remove_current\*(C'\fR
.IP \(bu 8
\&\f(CW\*(C`mouse_right_click=close_all\*(C'\fR
.RE
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
هیچ کاری انجام نده.
.IP \fBdo_action\fR 4
.IX Item "do_action"
کنش تعیین‌شده توسط قاعده action_name را فراخوانی می‌کند. اگر چنین کنشی وجود نداشته باشد، منوی زمینه را باز می‌کند.
.IP \fBopen_url\fR 4
.IX Item "open_url"
اگر اعلان دقیقاً یک نشانی وب داشته باشد، آن را باز می‌کند. اگر چندین نشانی وجود داشته باشد، منوی زمینه را باز می‌کند.
.IP \fBclose_current\fR 4
.IX Item "close_current"
اعلان فعلی را می‌بندد.
.IP \fBclose_all\fR 4
.IX Item "close_all"
تمام اعلان‌ها را می‌بندد.
.IP \fBcontext\fR 4
.IX Item "context"
منوی زمینه را برای اعلان باز می‌کند.
.IP \fBcontext_all\fR 4
.IX Item "context_all"
منوی زمینه را برای تمام اعلان‌ها باز می‌کند.
.RE
.RS 4
.RE
.IP "\fBignore_dbusclose\fR (پیش‌فرض: false)" 4
.IX Item "ignore_dbusclose (default: false)"
پیام \fICloseNotification\fR دی‌باس را نادیده می‌گیرد. این برای اعمال مهلت زمانی تعیین‌شده توسط پیکربندی dunst مفید است. بدون این پارامتر، یک برنامه ممکن است اعلان ارسال‌شده را قبل از مهلت زمانی تعریف‌شده توسط کاربر ببندد.
.IP "\fBoverride_pause_level\fR (مقادیر: [0\-100], پیش‌فرض: 0)" 4
.IX Item "override_pause_level (values: [0-100], default: 0)"
یک اعلان هر زمان که \fIoverride_pause_level\fR آن بزرگتر از سطح مکث باشد ظاهر خواهد شد.
تنظیم این مورد به مقادیری غیر از 0 به شما امکان می‌دهد حالت‌های مکث جزئی ایجاد کنید، که در آن اعلان‌های با فوریت بیشتر عبور می‌کنند، اما موارد با فوریت کمتر در حالت مکث باقی می‌مانند.
.Sp
به عنوان مثال، می‌توانید override_pause_level یک اعلان باتری ضعیف را روی 60 تنظیم کنید و سپس سطح مکث dunst را روی 60 بگذارید. این باعث می‌شود dunst فقط اعلان سطح باتری (و سایر اعلان‌های با override_pause_level >= 60) را نشان دهد، در حالی که بقیه را به حالت تعلیق درآورد.
.SS "میانبرهای صفحه‌کلید (فقط X11) (Keyboard shortcuts (X11 only))"
.IX Subsection "Keyboard shortcuts (X11 only)"
میانبرهای صفحه‌کلید در قالب زیر تعریف می‌شوند: "Modifier+key" که در آن کلید تبدیل‌کننده (modifier) یکی از موارد ctrl، mod1، mod2، mod3، mod4 و key هر کلیدی از صفحه‌کلید است.
.PP
توجه داشته باشید که میانبرهای صفحه‌کلید برای سازگاری با سایر تنظیمات به بخش \fBglobal\fR پیکربندی منتقل شده‌اند.
.PP
به عنوان روشی دیگر، می‌توانید میانبرها را درون مدیر پنجره خود تعریف کرده و آن‌ها را به دستورهای \fBdunstctl\fR\|(1) متصل کنید.
.PP
ویلند به برنامه‌ها اجازه گوش دادن به رویدادهای سراسری صفحه‌کلید را نمی‌دهد، بنابراین این قابلیت فقط برای X پیاده‌سازی شده است.
.IP \fBclose\fR 4
.IX Item "close"
میانبر صفحه‌کلید را برای بستن یک اعلان مشخص می‌کند.
.IP \fBclose_all\fR 4
.IX Item "close_all"
میانبر صفحه‌کلید را برای بستن تمام اعلان‌های در حال نمایش مشخص می‌کند.
.IP \fBhistory\fR 4
.IX Item "history"
میانبر صفحه‌کلید را برای فراخوانی مجدد یک اعلان از تاریخچه مشخص می‌کند.
.IP \fBcontext\fR 4
.IX Item "context"
میانبر صفحه‌کلید را که منوی زمینه را باز می‌کند مشخص می‌کند.
.SS "بخش‌های فوریت (Urgency sections)"
.IX Subsection "Urgency sections"
بخش‌های فوریت به روشی مشابه با قواعد کار می‌کنند و می‌توانند برای تعیین ویژگی‌ها برای سطوح مختلف فوریت اعلان‌ها (low، normal، critical) استفاده شوند. در حال حاضر فقط ویژگی‌های background، foreground، highlight، timeout، frame_color و icon قابل تغییر هستند.
.PP
بخش‌های فوریت عبارتند از urgency_low، urgency_normal و urgency_critical به ترتیب برای فوریت‌های کم (low)، عادی (normal) و بحرانی (critical).
.PP
برای مثال‌ها به فایل پیکربندی نمونه مراجعه کنید.
.PP
نسخه‌های قدیمی dunst امکان تغییر رنگ‌های فوریت‌های مختلف را از طریق گزینه‌های خط فرمان فراهم می‌کردند. این مورد مدت‌هاست به نفع قواعد (RULES) حذف شده است، گزارش شماره ۳۲۸ (#328) را ببینید.
.SS "بخش آزمایشی (Experimental section)"
.IX Subsection "Experimental section"
.IP "\fBper_monitor_dpi\fR (پیش‌فرض: false)" 4
.IX Item "per_monitor_dpi (default: false)"
استفاده از DPI متفاوت برای هر نمایشگر.
این تنظیم در حال حاضر فقط برای X11 پیاده‌سازی شده است.
.IP "\fBpause_on_mouse_over\fR (پیش‌فرض: false)" 4
.IX Item "pause_on_mouse_over (default: false)"
مکث در مهلت زمانی اعلان هنگام قرار گرفتن نشانگر ماوس روی آن.
این تنظیم در حال حاضر فقط برای Wayland پیاده‌سازی شده است.
.IP "\fBenable_pcre_regex\fR (پیش‌فرض: false)" 4
.IX Item "enable_pcre_regex (default: false)"
استفاده از عبارات باقاعده PCRE برای قواعد پالایش.
برای اطلاعات بیشتر به https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions مراجعه کنید.
این تنظیم \fBenable_posix_regex\fR را لغو می‌کند.
.SH "دستور DUNSTCTL (DUNSTCTL)"
.IX Header "DUNSTCTL"
اکنون dunst حاوی یک دستور کنترلی خط فرمان است که می‌توان از آن برای تعامل با آن استفاده کرد. این دستور از تمام عملکردهایی که پیش‌تر فقط از طریق میانبرهای صفحه‌کلید انجام می‌شدند پشتیبانی می‌کند و همچنین عملکردهای اضافی فراوانی دارد. برای اطلاعات بیشتر، \fBdunstctl\fR\|(1) را ببینید.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
Dunst تعدادی از اعلان‌ها (مشخص‌شده توسط \fBhistory_length\fR) را در حافظه ذخیره می‌کند. این اعلان‌ها را می‌توان با فراخوانی \fBdunstctl history\fR مجدداً فراخوانی (یعنی دوباره نمایش) داد (به \fBdunstctl\fR\|(1) مراجعه کنید). اینکه آیا این اعلان‌ها مانند زمانی که تازه ارسال شده‌اند منقضی می‌شوند یا خیر، به مقدار تنظیم \fBsticky_history\fR بستگی دارد. کنش‌ها پس از بسته شدن اعلان باطل می‌شوند، بنابراین هنگام بازگرداندن اعلان از تاریخچه نمی‌توانید آن کنش را اجرا کنید.
.PP
اعلان‌های گذشته به ترتیب اولین ورودی-آخرین خروجی (FILO) دوباره نمایش داده می‌شوند، بدین معنی که فشردن کلید تاریخچه برای یک بار، تازه‌ترین اعلانی را که بسته شده یا زمان آن سر آمده بود نمایش خواهد داد.
.SH "ویلند (WAYLAND)"
.IX Header "WAYLAND"
Dunst از نسخه 1.6.0 دارای پشتیبانی از ویلند است. از آنجا که پروتکل Wayland بیشتر بر امنیت تمرکز دارد، برخی مواردی که در X11 امکان‌پذیر است در ویلند ممکن نیست. این تفاوت‌ها در پیکربندی بازتاب یافته‌اند. تغییرات اصلی این است که dunst در ویلند نمی‌تواند از کلیدهای میانبر سراسری استفاده کند؛ در عوض از dunstctl استفاده کنید.
.PP
برخی از ویژگی‌های dunst در ویلند ممکن است نیازمند پشتیبانی کامپوزیتور شما از یک پروتکل خاص باشند. Dunst در صورت عدم پشتیبانی از یک ویژگی اختیاری به شما هشدار می‌دهد و عملکرد مربوطه را غیرفعال می‌کند.
.PP
تشخیص تمام‌صفحه در ویلند با برخی محدودیت‌ها کار می‌کند (به \fBfullscreen\fR مراجعه کنید). اگر می‌خواهید اعلان‌ها روی پنجره‌های تمام‌صفحه ظاهر شوند، \fBlayer = overlay\fR را در گزینه‌های سراسری تنظیم کنید.
.PP
توجه داشته باشید که همین محدودیت‌ها هنگام استفاده از XWayland نیز وجود دارند.
.PP
اگر چیزی در ویلند به درستی کار نمی‌کند، لطفاً یک گزارش باگ ارسال کنید. در این فاصله، می‌توانید امتحان کنید که آیا خروجی X11 روی ویلند کار می‌کند یا خیر. برای این کار از \fBforce_xwayland = true\fR استفاده کنید.
.PP
اگر اعلان‌های dunst شما در همان سمتی از صفحه نمایش قرار دارند که نوار وضعیت (status bar) شما قرار دارد، ممکن است متوجه شوید که اعلان‌ها کمی بالاتر یا پایین‌تر از X11 ظاهر می‌شوند. این به این دلیل است که اعلان نمی‌تواند روی نوار وضعیت شما قرار گیرد. اعلان‌ها نسبت به نوار وضعیت شما قرار می‌گیرند و باعث می‌شوند به اندازه ارتفاع نوار وضعیت شما بالاتر یا پایین‌تر ظاهر شوند. ما کاری در مورد این رفتار نمی‌توانیم انجام دهیم.
.PP
توجه داشته باشید که dunst با استفاده از پروتکل layer shell یک «desktop layer» ایجاد می‌کند و نه یک پنجره معمولی ویلند. این همانطور که در بالا گفته شد محدودیت‌هایی دارد؛ به عنوان مثال نمی‌توانید عنوان/کلاس پنجره را تنظیم کنید.
.SH "قواعد (RULES)"
.IX Header "RULES"
قواعد امکان تغییر مشروط اعلان‌ها را فراهم می‌کنند. آن‌ها می‌توانند در بخشی با هر نامی قرار گیرند، حتی بخش‌های ویژه. بخش‌های ویژه اجازه افزودن پالایه‌ها را نمی‌دهند، زیرا به طور پیش‌فرض دارای پالایه‌های ضمنی هستند.
.IP \*(Aqglobal\*(Aq 4
.IX Item "'global'"
بدون پالایه، با تمام اعلان‌ها مطابقت دارد.
.IP "\*(Aqurgency_low\*(Aq, \*(Aqurgency_normal\*(Aq و \*(Aqurgency_critical\*(Aq" 4
.IX Item "'urgency_low', 'urgency_normal' and 'urgency_critical'"
به ترتیب با فوریت‌های کم، عادی یا بحرانی مطابقت دارند.
.PP
پیکربندی یک قاعده از ۲ بخش تشکیل شده است: تعریف پالایه‌هایی که کنترل می‌کنند چه زمانی یک قاعده باید اعمال شود و سپس اقداماتی که باید هنگام تطبیق قاعده انجام شوند. همچنین می‌توان هیچ پالایه‌ای را مشخص نکرد که در این صورت قاعده با تمام اعلان‌ها مطابقت خواهد داشت.
.PP
قواعد به ترتیب ظاهر شدن اعمال می‌شوند. هشدار: اگر اعلانی توسط یک قاعده تغییر کند، ممکن است بر تطبیق آن توسط قاعده‌ای بعدی تأثیر بگذارد.
.IP \fBfiltering\fR 4
.IX Item "filtering"
با قواعد پالایشی می‌توانید اعلان‌ها را مطابقت دهید تا قواعد را فقط بر روی زیرمجموعه‌ای از اعلان‌ها اعمال کنید.
.Sp
برای قواعد پالایشی که بر اساس رشته‌ها فیلتر می‌کنند، می‌توانید از عبارات باقاعده استفاده کنید. توصیه می‌شود \fBenable_posix_regex\fR را روی true تنظیم کنید. سپس می‌توانید از نحو عبارات باقاعده تعمیم‌یافته POSIX استفاده کنید:
https://en.m.wikibooks.org/wiki/Regular_Expressions/POSIX\-Extended_Regular_Expressions.
در نهایت \fBenable_posix_regex\fR به طور پیش‌فرض فعال خواهد شد.
.Sp
یک قاعده تطبیقی با انتساب یک ویژگی پالایه به مقداری که می‌خواهید مطابقت دهید ایجاد می‌شود. هنگام تطبیق مقادیر از الگوهای انطباق شبیه به پوسته (globbing) پشتیبانی می‌شود.
.Sp
اگر چندین عبارت پالایه وجود داشته باشد، همه آن‌ها باید برای اعمال قاعده مطابقت داشته باشند (AND منطقی).
.Sp
مثالی از قاعده‌ای که فقط بر روی پیام‌های ارسال‌شده توسط notify\-send عمل می‌کند:
.Sp
.Vb 1
\&    appname="notify\-send"
.Ve
.Sp
ویژگی‌های مجاز در زیر فهرست شده‌اند.
.RS 4
.ie n .IP """appname"" (همچنین desktop_entry را ببینید)" 4
.el .IP "\f(CWappname\fR (همچنین desktop_entry را ببینید)" 4
.IX Item "appname (see also desktop_entry)"
نام برنامه همان‌طور که توسط کلاینت گزارش شده است. توجه داشته باشید که این نام بسته به زبان و محیط محلی (locale) مورد استفاده اغلب می‌تواند متفاوت باشد.
.Sp
توصیه می‌شود به جای آن از پالایه \f(CW\*(C`desktop_entry\*(C'\fR استفاده کنید.
.ie n .IP """body""" 4
.el .IP \f(CWbody\fR 4
.IX Item "body"
بدنه اعلان
.ie n .IP """category""" 4
.el .IP \f(CWcategory\fR 4
.IX Item "category"
دسته‌بندی اعلان طبق تعریف مشخصات اعلان. به
https://specifications.freedesktop.org/notification\-spec/latest/categories.html
مراجعه کنید.
.ie n .IP """desktop_entry""" 4
.el .IP \f(CWdesktop_entry\fR 4
.IX Item "desktop_entry"
برنامه‌های مبتنی بر GLib نام desktop\-entry خود را صادر می‌کنند. در مقایسه با appname، مورد desktop\-entry بومی‌سازی (ترجمه) نخواهد شد.
.ie n .IP """icon""" 4
.el .IP \f(CWicon\fR 4
.IX Item "icon"
آیکون اعلان در قالب یک مسیر فایل. در صورتی که آیکونی موجود نباشد یا به جای آن از یک آیکون خام استفاده شود می‌تواند خالی باشد. این تنظیم نباید با تنظیم icon در بخش فوریت اشتباه گرفته شود.
.ie n .IP """match_transient""" 4
.el .IP \f(CWmatch_transient\fR 4
.IX Item "match_transient"
تطبیق در صورتی که اعلان توسط کلاینت یا قاعده دیگری به عنوان گذرا اعلام شده باشد.
.Sp
برای جزئیات بیشتر درباره این ویژگی به \f(CW\*(C`set_transient\*(C'\fR مراجعه کنید.
.ie n .IP """match_dbus_timeout""" 4
.el .IP \f(CWmatch_dbus_timeout\fR 4
.IX Item "match_dbus_timeout"
مهلت زمانی دی‌باس اعلان را که توسط کلاینت یا قاعده دیگری تنظیم شده است مطابقت می‌دهد.
.Sp
برای جزئیات بیشتر به \f(CW\*(C`override_dbus_timeout\*(C'\fR مراجعه کنید.
.ie n .IP """msg_urgency""" 4
.el .IP \f(CWmsg_urgency\fR 4
.IX Item "msg_urgency"
فوریت اعلان را که توسط کلاینت یا قاعده دیگری تنظیم شده است مطابقت می‌دهد.
.Sp
این نام به این دلیل انتخاب شده تا با تلاش برای تغییر فوریت تداخل نداشته باشد.
.ie n .IP """stack_tag""" 4
.el .IP \f(CWstack_tag\fR 4
.IX Item "stack_tag"
برچسب پشته اعلان را که توسط کلاینت یا قاعده دیگری تنظیم شده است مطابقت می‌دهد.
.Sp
برای اطلاعات بیشتر در مورد برچسب‌های پشته به set_stack_tag مراجعه کنید.
.ie n .IP """summary""" 4
.el .IP \f(CWsummary\fR 4
.IX Item "summary"
خلاصه، یا همان «عنوان» اعلان را مطابقت می‌دهد.
.RE
.RS 4
.RE
.IP \fBmodifying\fR 4
.IX Item "modifying"
یک قاعده تغییردهنده، همانند قاعده پالایشی، با انتساب یک مقدار به یک ویژگی اعلان در تعریف قاعده ایجاد می‌شود.
.Sp
ویژگی‌های زیر قابل بازنویسی هستند:
.RS 4
.ie n .IP """background""" 4
.el .IP \f(CWbackground\fR 4
.IX Item "background"
رنگ پس‌زمینه اعلان. برای مقادیر ممکن به بخش COLORS مراجعه کنید.
.ie n .IP """foreground""" 4
.el .IP \f(CWforeground\fR 4
.IX Item "foreground"
رنگ پیش‌زمینه اعلان. برای مقادیر ممکن به بخش COLORS مراجعه کنید.
.ie n .IP """highlight""" 4
.el .IP \f(CWhighlight\fR 4
.IX Item "highlight"
رنگ برجسته‌سازی اعلان. این رنگ برای رنگ‌آمیزی نوار پیشرفت استفاده می‌شود. برای مقادیر ممکن به بخش COLORS مراجعه کنید.
.Sp
همچنین می‌توانید مقادیر رنگ اضافی (به عنوان یک فهرست جداشده با ویرگول) تعیین کنید تا یک گرادیان خطی در تمام طول نوار پیشرفت تعریف شود.
.ie n .IP """format""" 4
.el .IP \f(CWformat\fR 4
.IX Item "format"
معادل تنظیم \f(CW\*(C`format\*(C'\fR است.
.ie n .IP """frame_color""" 4
.el .IP \f(CWframe_color\fR 4
.IX Item "frame_color"
رنگ کادر اعلان. برای مقادیر ممکن به بخش COLORS مراجعه کنید.
.ie n .IP """fullscreen"" (مقادیر: [delay/show/pushback/suppress], پیش‌فرض: show)" 4
.el .IP "\f(CWfullscreen\fR (values: [delay/show/pushback/suppress], default: show)" 4
.IX Item "fullscreen (values: [delay/show/pushback/suppress], default: show)"
این ویژگی مشخص می‌کند در صورت فوکوس بودن یک پنجره تمام‌صفحه، اعلان‌ها چگونه مدیریت شوند. به طور پیش‌فرض روی \fIshow\fR تنظیم شده است بنابراین اعلان‌ها نشان داده می‌شوند.
.Sp
سایر مقادیر ممکن عبارتند از \fIdelay\fR: اعلان‌هایی که قبلاً نشان داده شده‌اند تا زمان بسته شدن یا سرآمدن مهلت به نمایش ادامه می‌دهند اما اعلان‌های جدید متوقف شده و پس از خارج شدن فوکوس از پنجره تمام‌صفحه نمایش داده می‌شوند.
.Sp
یا \fIpushback\fR که معادل delay است با این تفاوت که اعلان‌های موجود قبلی به حالت مکث درآمده و پنهان می‌شوند تا زمانی که فوکوس از پنجره تمام‌صفحه برداشته شود.
.Sp
علاوه بر این مقدار \fIsuppress\fR نیز وجود دارد. اعلان‌های موجود هنگام ورود به حالت تمام‌صفحه بسته می‌شوند و اعلان‌های جدید مستقیماً به تاریخچه می‌روند. این شبیه به pushback بدون نمایش مجدد پس از خروج از حالت تمام‌صفحه است.
.Sp
در Wayland اگر \fBfollow\fR روی mouse یا keyboard تنظیم شده باشد، خروجی که اعلان در آن قرار دارد قابل تشخیص نیست؛ بنابراین dunst در صورت تمام‌صفحه بودن هر یک از خروجی‌ها، تأخیر (delay) یا تعویق (pushback) ایجاد می‌کند. از آنجا که پروتکل تمام‌صفحه نسبتاً جدید است، به نسخه جدیدی از کامپوزیتور نیاز دارید که از آن پشتیبانی کند. در زمان نگارش این متن، به نسخه git نرم‌افزار sway نیاز خواهید داشت.
همچنین به \fBlayer\fR مراجعه کنید تا تغییر دهید آیا اعلان‌ها بالای پنجره‌های تمام‌صفحه در Wayland ظاهر شوند یا خیر.
.ie n .IP """min_icon_size"" (پیش‌فرض: 32)" 4
.el .IP "\f(CWmin_icon_size\fR (default: 32)" 4
.IX Item "min_icon_size (default: 32)"
حداقل اندازه بر حسب پیکسل را برای آیکون‌ها تعیین می‌کند.
اگر آیکون بزرگتر یا مساوی با مقدار مشخص‌شده باشد، تحت تأثیر قرار نخواهد گرفت.
اگر کوچکتر باشد، مقیاس آن افزایش می‌یابد به طوری که محور کوچکتر معادل اندازه مشخص‌شده شود.
.Sp
هنگام استفاده از جستجوی بازگشتی آیکون (به \fBenable_recursive_icon_lookup\fR مراجعه کنید)، تمام آیکون‌های یک پوسته به این اندازه خواهند بود.
.Sp
اگر \fBicon_position\fR روی off تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.
.ie n .IP """max_icon_size"" (پیش‌فرض: 128)" 4
.el .IP "\f(CWmax_icon_size\fR (default: 128)" 4
.IX Item "max_icon_size (default: 128)"
حداکثر اندازه بر حسب پیکسل را برای آیکون‌ها تعیین می‌کند.
اگر آیکون کوچکتر یا مساوی با مقدار مشخص‌شده باشد، تحت تأثیر قرار نخواهد گرفت.
اگر بزرگتر باشد، مقیاس آن کاهش می‌یابد به طوری که محور بزرگتر معادل اندازه مشخص‌شده شود.
.Sp
برای غیرفعال کردن کاهش مقیاس آیکون روی 0 تنظیم کنید.
.Sp
اگر هر دو گزینه \fBmin_icon_size\fR و \fBmax_icon_size\fR فعال باشند، دومی اولویت نهایی را دارد.
.Sp
اگر \fBicon_position\fR روی off تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.
.ie n .IP """new_icon""" 4
.el .IP \f(CWnew_icon\fR 4
.IX Item "new_icon"
آیکون اعلان را به‌روزرسانی می‌کند؛ باید یک مسیر یا نام برای یک تصویر معتبر باشد. این گزینه آیکونی را که با dunstify یا ابزار اعلان دیگری ارسال شده بود بازنویسی می‌کند. بسط آرگومان با استفاده از \fBwordexp\fR\|(3) با غیرفعال بودن جایگزینی دستور انجام می‌شود.
.ie n .IP """icon_position"" (مقادیر: [left/right/top/off], پیش‌فرض: left)" 4
.el .IP "\f(CWicon_position\fR (values: [left/right/top/off], default: left)" 4
.IX Item "icon_position (values: [left/right/top/off], default: left)"
موقعیت آیکون را در پنجره اعلان تعیین می‌کند. تنظیم آن روی off آیکون‌ها را غیرفعال می‌کند.
.ie n .IP """default_icon""" 4
.el .IP \f(CWdefault_icon\fR 4
.IX Item "default_icon"
آیکون پیش‌فرض اعلان را تعیین می‌کند؛ باید یک مسیر یا نام برای یک تصویر معتبر باشد. این گزینه آیکونی را که با dunstify یا ابزار اعلان دیگری ارسال شده بود بازنویسی \fBنمی‌کند\fR. بسط آرگومان با استفاده از \fBwordexp\fR\|(3) با غیرفعال بودن جایگزینی دستور انجام می‌شود.
.ie n .IP """set_stack_tag""" 4
.el .IP \f(CWset_stack_tag\fR 4
.IX Item "set_stack_tag"
برچسب پشته را برای اعلان تنظیم می‌کند؛ اعلان‌هایی با برچسب پشته یکسان (غیرخالی) و appid یکسان جایگزین یکدیگر خواهند شد تا فقط جدیدترین آن‌ها قابل مشاهده باشد. این می‌تواند مثلاً در اعلان‌های میزان صدا یا روشنایی که فقط می‌خواهید یکی از همان نوع قابل مشاهده باشد، مفید باشد.
.Sp
برچسب پشته را می‌توان توسط کلاینت با نشانه‌های \*(Aqsynchronous\*(Aq، \*(Aqprivate\-synchronous\*(Aq، \*(Aqx\-canonical\-private\-synchronous\*(Aq یا \*(Aqx\-dunst\-stack\-tag\*(Aq تنظیم کرد.
.ie n .IP """set_transient""" 4
.el .IP \f(CWset_transient\fR 4
.IX Item "set_transient"
تعیین می‌کند که آیا اعلان گذرا در نظر گرفته شود یا خیر.
اعلان‌های گذرا تنظیم idle_threshold را دور خواهند زد.
.Sp
به طور پیش‌فرض اعلان‌ها گذرا در نظر گرفته _نمی‌شوند_، اما کلاینت‌ها می‌توانند با مشخص کردن نشانه \*(Aqtransient\*(Aq هنگام ارسال اعلان‌ها، مقدار این گزینه را تعیین کنند.
.ie n .IP """set_category""" 4
.el .IP \f(CWset_category\fR 4
.IX Item "set_category"
دسته‌بندی اعلان را تنظیم می‌کند.
برای فهرستی از دسته‌بندی‌های استاندارد به
https://specifications.freedesktop.org/notification\-spec/latest/categories.html
مراجعه کنید.
.ie n .IP """timeout""" 4
.el .IP \f(CWtimeout\fR 4
.IX Item "timeout"
معادل تنظیم \f(CW\*(C`timeout\*(C'\fR در بخش‌های فوریت است.
.ie n .IP """override_dbus_timeout""" 4
.el .IP \f(CWoverride_dbus_timeout\fR 4
.IX Item "override_dbus_timeout"
مهلت زمانی مشخص‌شده در دی‌باس را بازنویسی می‌کند.
این گزینه بر \f(CW\*(C`timeout\*(C'\fR تقدم دارد.
.ie n .IP """urgency""" 4
.el .IP \f(CWurgency\fR 4
.IX Item "urgency"
فوریت اعلان را تنظیم می‌کند.
.Sp
\&\fBنکته مهم\fR: این گزینه در حال حاضر ویژگی‌های بخش‌های *_urgency را دوباره اعمال نمی‌کند. فوریت تغییر‌یافته فقط در قواعدی که بعداً تعریف شده‌اند قابل مشاهده خواهد بود. برای تطبیق آن از \f(CW\*(C`msg_urgency\*(C'\fR استفاده کنید.
.ie n .IP """override_pause_level""" 4
.el .IP \f(CWoverride_pause_level\fR 4
.IX Item "override_pause_level"
به \fBoverride_pause_level\fR مراجعه کنید.
.ie n .IP """skip_display""" 4
.el .IP \f(CWskip_display\fR 4
.IX Item "skip_display"
تنظیم این گزینه روی true از نمایش اولیه اعلان جلوگیری می‌کند، اما برای مشاهده بعدی در تاریخچه ذخیره خواهد شد.
.ie n .IP """history_ignore""" 4
.el .IP \f(CWhistory_ignore\fR 4
.IX Item "history_ignore"
تنظیم این گزینه روی true اعلان را در ابتدا نمایش می‌دهد، اما از فراخوانی مجدد آن از طریق تاریخچه جلوگیری می‌کند.
.ie n .IP """action_name"" (پیش‌فرض: ""default"")" 4
.el .IP "\f(CWaction_name\fR (default: ""default"")" 4
.IX Item "action_name (default: ""default"")"
نام کنشی را که باید در do_action فراخوانی شود تنظیم می‌کند. در صورت عدم تعیین، کنش تنظیم‌شده به عنوان کنش پیش‌فرض یا تنها کنش موجود فراخوانی خواهد شد.
.ie n .IP """word_wrap"" (مقادیر: [true/false], پیش‌فرض: true)" 4
.el .IP "\f(CWword_wrap\fR (values: [true/false], default: true)" 4
.IX Item "word_wrap (values: [true/false], default: true)"
مشخص می‌کند در صورتی که خطوط طولانی‌تر از حداکثر عرض اعلان شوند، آیا متن شکسته شود یا خیر. اگر روی true تنظیم شود، خطوط طولانی به چند خط شکسته می‌شوند و در صورت لزوم ارتفاع پنجره اعلان برای جا گرفتن آن‌ها افزایش می‌یابد. اگر متن در پنجره جا نشود، مطابق با ellipsize خلاصه‌سازی خواهد شد.
.ie n .IP """ellipsize"" (مقادیر: [start/middle/end], پیش‌فرض: middle)" 4
.el .IP "\f(CWellipsize\fR (values: [start/middle/end], default: middle)" 4
.IX Item "ellipsize (values: [start/middle/end], default: middle)"
مشخص می‌کند خطوط بریده‌شده در کجا باید با علامت سه‌نقطه خلاصه‌سازی شوند.
.ie n .IP """alignment"" (مقادیر: [left/center/right], پیش‌فرض: left)" 4
.el .IP "\f(CWalignment\fR (values: [left/center/right], default: left)" 4
.IX Item "alignment (values: [left/center/right], default: left)"
نحوه تراز شدن متن را در اعلان تعیین می‌کند.
.ie n .IP """hide_text"" (مقادیر: [true/false], پیش‌فرض: false)" 4
.el .IP "\f(CWhide_text\fR (values: [true/false], default: false)" 4
.IX Item "hide_text (values: [true/false], default: false)"
تنظیم این گزینه روی true از نمایش هرگونه متن مربوط به اعلان صرف‌نظر می‌کند. آیکون و نوار پیشرفت اعلان همچنان نمایش داده خواهند شد. این گزینه ممکن است برای اعلان‌هایی که در آن‌ها یک آیکون یا نوار پیشرفت اطلاعات کافی برای اعلان ارائه می‌دهد (مانند میزان صدای صوتی یا سطح روشنایی) مفید باشد.
.ie n .IP """markup"" (مقادیر: [full/strip/no], پیش‌فرض: no)" 4
.el .IP "\f(CWmarkup\fR (values: [full/strip/no], default: no)" 4
.IX Item "markup (values: [full/strip/no], default: no)"
نحوه مدیریت نشانه‌گذاری (markup) در اعلان‌ها را تعیین می‌کند.
.Sp
توجه به این نکته مهم است که نشانه‌گذاری در گزینه format صرف‌نظر از مقدار این تنظیم تجزیه خواهد شد.
.Sp
مقادیر ممکن:
.RS 4
.IP \fBfull\fR 4
.IX Item "full"
زیرمجموعه کوچکی از نشانه‌گذاری html را در اعلان‌ها مجاز می‌کند:
.Sp
.Vb 4
\&    <b>پررنگ</b>
\&    <i>مورب</i>
\&    <s>خط‌خورده</s>
\&    <u>زیرخط‌دار</u>
.Ve
.Sp
برای مرجع کامل به
https://docs.gtk.org/Pango/pango_markup.html
مراجعه کنید.
.IP \fBstrip\fR 4
.IX Item "strip"
این تنظیم برای سازگاری با برخی کلاینت‌های معیوب ارائه شده است که نشانه‌گذاری ارسال می‌کنند حتی با اینکه روی سرور فعال نشده است.
.Sp
Dunst سعی می‌کند نشانه‌گذاری را حذف (strip) کند اما تجزیه آن ساده‌انگارانه است، بنابراین استفاده از این گزینه خارج از قواعد تطبیق برای برنامه‌های خاص \fBاکیداً منع می‌شود\fR.
.Sp
برای تطبیق کلاینت‌های معیوب خاص به بخش RULES مراجعه کنید.
.IP \fBno\fR 4
.IX Item "no"
تجزیه نشانه‌گذاری را غیرفعال می‌کند؛ اعلان‌های دریافتی به عنوان متن ساده در نظر گرفته خواهند شد. اگر این گزینه به عنوان یک تنظیم سراسری تعیین شود، dunst اعلام نخواهد کرد که می‌تواند نشانه‌گذاری را تجزیه کند.
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.SS "اسکریپت‌نویسی (SCRIPTING)"
.IX Subsection "SCRIPTING"
درون قواعد می‌توانید با انتساب گزینه \*(Aqscript\*(Aq به نام اسکریپتی که باید اجرا شود، اسکریپتی را مشخص کنید که هر بار با تطبیق قاعده اجرا شود.
.PP
هنگام فراخوانی اسکریپت، جزئیات اعلانی که آن را راه‌اندازی کرده از طریق متغیرهای محیطی ارسال خواهد شد. متغیرهای زیر در دسترس هستند:
\&\fBDUNST_APP_NAME\fR، \fBDUNST_SUMMARY\fR، \fBDUNST_BODY\fR، \fBDUNST_ICON_PATH\fR،
\&\fBDUNST_URGENCY\fR، \fBDUNST_ID\fR، \fBDUNST_PROGRESS\fR، \fBDUNST_CATEGORY\fR،
\&\fBDUNST_STACK_TAG\fR، \fBDUNST_URLS\fR، \fBDUNST_TIMEOUT\fR، \fBDUNST_TIMESTAMP\fR
و \fBDUNST_DESKTOP_ENTRY\fR.
.PP
روش دیگر که کمتر توصیه می‌شود برای دریافت جزئیات اعلان‌ها از یک اسکریپت، از طریق پارامترهای خط فرمان است. این پارامترها به ترتیب زیر به اسکریپت ارسال می‌شوند:
\&\fBappname\fR، \fBsummary\fR، \fBbody\fR، \fBicon_path\fR، \fBurgency\fR.
.PP
که در آن \fBDUNST_ICON_PATH\fR یا \fBicon_path\fR مسیر مطلق فایل آیکون است (در صورت وجود). \fBDUNST_URGENCY\fR یا \fBurgency\fR یکی از موارد "LOW"، "NORMAL" یا "CRITICAL" است. \fBDUNST_URLS\fR فهرستی جداشده با خط جدید از نشانی‌های وب مرتبط با اعلان است.
.PP
توجه داشته باشید که برخی از متغیرها ممکن است خالی باشند.
.PP
اگر اعلان سرکوب شده باشد، اسکریپت اجرا نخواهد شد مگر اینکه \fBalways_run_script\fR روی true تنظیم شده باشد.
.PP
پارامتر script بر اساس \fBwordexp\fR\|(3) با غیرفعال بودن جایگزینی دستور بسط داده می‌شود. اگر مقدار بسط‌یافته یک مسیر مطلق نباشد، شاخه‌های موجود در متغیر PATH برای یک فایل اجرایی با همان نام جستجو خواهند شد.
.SH "رنگ‌ها (COLORS)"
.IX Header "COLORS"
رنگ‌ها مقادیری با قالب #RGB یا #RRGGBB هستند.
.PP
همچنین می‌توانید با استفاده از قالب #RGBA یا #RRGGBBAA یک مؤلفه شفافیت مشخص کنید.
.PP
\&\fBنکته\fR: نویسه \*(Aq#\*(Aq به عنوان توضیح (کامنت) تفسیر می‌شود، برای استفاده از آن باید کل مقدار درون گیومه قرار گیرد.
برای مثال:
.PP
.Vb 1
\&    separator_color="#123456"
.Ve
.SH "نشانه‌های NOTIFY\-SEND (NOTIFY\-SEND HINTS)"
.IX Header "NOTIFY-SEND HINTS"
Dunst قادر است رنگ‌های مختلفی را برای یک پیام از طریق notify\-send دریافت کند.
برای انجام این کار باید با گزینه \-h یک نشانه (hint) اضافه کنید.
مقدار پیشرفت را نیز می‌توان با یک نشانه تنظیم کرد.
.PP
توجه: Dunstify با notify\-send سازگار است و تمام این تنظیمات به همان صورت کار می‌کنند.
.PP
تمام نشانه‌های پذیرفته‌شده در زیر فهرست شده‌اند.
.PP
برای توضیحات دقیق‌تر در مورد برخی گزینه‌ها به بخش RULES مراجعه کنید.
.IP "\fBfgcolor\fR (نوع: string)" 4
.IX Item "fgcolor (type: string)"
رنگ پیش‌زمینه.
.IP "\fBbgcolor\fR (نوع: string)" 4
.IX Item "bgcolor (type: string)"
رنگ پس‌زمینه.
.IP "\fBfrcolor\fR (نوع: string)" 4
.IX Item "frcolor (type: string)"
رنگ کادر.
.IP "\fBhlcolor\fR (نوع: string یا آرایه‌ای از string)" 4
.IX Item "hlcolor (type: string or string array)"
رنگ برجسته‌سازی.
.IP "\fBvalue\fR (نوع: int یا uint)" 4
.IX Item "value (type: int or uint)"
مقدار پیشرفت.
.IP "\fBimage\-path\fR (نوع: string)" 4
.IX Item "image-path (type: string)"
نام آیکون. این می‌تواند یک مسیر یا صرفاً نام آیکون باشد.
.Sp
نام مستعار \fBimage_path\fR نیز پشتیبانی می‌شود.
.IP "\fBimage\-data\fR (نوع: variant)" 4
.IX Item "image-data (type: variant)"
جریانی از داده‌های خام تصویر.
.Sp
نام‌های مستعار \fBimage_data\fR و \fBicon_data\fR نیز پشتیبانی می‌شوند.
.IP "\fBcategory\fR (نوع: string)" 4
.IX Item "category (type: string)"
دسته‌بندی.
.IP "\fBdesktop\-entry\fR (نوع: string)" 4
.IX Item "desktop-entry (type: string)"
مدخل میزکار (desktop entry).
.IP "\fBtransient\fR (نوع: int یا boolean)" 4
.IX Item "transient (type: int or boolean)"
مقدار گذرا.
.IP "\fBx\-dunst\-stack\-tag\fR (نوع: string)" 4
.IX Item "x-dunst-stack-tag (type: string)"
برچسب پشته اعلان.
اعلانی با برچسب مشخص، جایگزین اعلان قبلی با همان برچسب خواهد شد.
.IP "\fBx\-canonical\-private\-synchronous\fR (نوع: string)" 4
.IX Item "x-canonical-private-synchronous (type: string)"
نام مستعار برای \fBx\-dunst\-stack\-tag\fR.
.PP
چند مثال:
.PP
.Vb 1
\&    notify\-send \-h string:fgcolor:#ff4444 "سلام"
\&
\&    notify\-send \-h string:bgcolor:#4444ff \-h string:fgcolor:#ff4444 \-h string:frcolor:#44ff44 ":)"
\&
\&    notify\-send \-h int:value:42 "در حال پردازش ..."
\&
\&    notify\-send \-h string:x\-canonical\-private\-synchronous:volume "بی‌صدا"
.Ve
.SH "کنش‌ها (ACTIONS)"
.IX Header "ACTIONS"
Dunst به اعلان‌دهنده‌ها (یعنی برنامه‌هایی که اعلان‌ها را ارسال می‌کنند) اجازه می‌دهد کنش‌هایی را مشخص کنند. Dunst هم از نمایش نشانگرها برای این کنش‌ها و هم از تعامل با آن‌ها پشتیبانی می‌کند.
.PP
اگر "show_indicators" برابر با true باشد و یک اعلان دارای کنش باشد، عبارت «(A)» به ابتدای قالب اعلان اضافه خواهد شد. به همین ترتیب، عبارت «(U)» به اعلان‌های حاوی نشانی‌های وب اضافه می‌شود. تعامل با اعلان‌هایی که دارای کنش هستند بدون در نظر گرفتن این تنظیم امکان‌پذیر است، هرچند ممکن است مشخص نباشد کدام اعلان‌ها دارای کنش هستند.
.PP
کلید میانبر «context» برای تعامل با این کنش‌ها از طریق نمایش منویی از کنش‌های ممکن استفاده می‌شود. این قابلیت به وجود «dmenu» یا جایگزینی سازگار با dmenu نیاز دارد.
.PP
به عنوان روشی دیگر، می‌توانید با کلیک وسط روی اعلان، یک کنش را فراخوانی کنید. اگر دقیقاً یک کنش مرتبط وجود داشته باشد، یا یکی به عنوان پیش‌فرض علامت‌گذاری شده باشد، همان اجرا می‌شود. اگر چندین کنش وجود داشته باشد، منوی زمینه نشان داده می‌شود. همین امر در مورد نشانی‌های وب در صورت نبود هیچ کنشی اعمال می‌شود.
.SH "قالب زمان (TIME FORMAT)"
.IX Header "TIME FORMAT"
زمان می‌تواند هر مقدار عدد صحیح اعشاری باشد که یک واحد زمان به آن پسوند شده است. اگر هیچ واحدی داده نشود، ثانیه ("s") به عنوان پیش‌فرض در نظر گرفته می‌شود.
.PP
واحدهای زمانی قابل فهم برای dunst عبارتند از "ms" (میلی‌ثانیه)، "s" (ثانیه)، "m" (دقیقه)، "h" (ساعت) و "d" (روز).
.PP
زمان نمونه: "1000ms"، "10m".
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "REPORTING BUGS"
باگ‌ها و پیشنهادات باید در گیت‌هاب در نشانی https://github.com/dunst\-project/dunst/issues گزارش شوند.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر ‎2011\-2014 متعلق به Sascha Kruse
.PP
حق نشر ‎2014\-2026 متعلق به مشارکت‌کنندگان Dunst
.PP
نرم‌افزار Dunst تحت مجوز ۳\-بندی BSD منتشر شده است، برای اطلاعات بیشتر پرونده LICENSE را ببینید.
.PP
اگر احساس می‌کنید حق نشری نقض شده است، لطفاً به نگهدارندگان ایمیل ارسال کنید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdunst\fR\|(1)، \fBdunstctl\fR\|(1)، \fBdmenu\fR\|(1)، \fBnotify\-send\fR\|(1)، \fBdunstify\fR\|(1)