.\" 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 "fnott" "5" "2025-07-16"
.PP
.SH "نام (NAME)"
fnott.ini \- فایل پیکربندی دیمن اعلان fnott
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBfnott\fR
از
\fIقالب استاندارد پیکربندی یونیکس\fR
با جفت‌های کلید/مقدار مبتنی بر بخش (section) استفاده می‌کند.\& بخش پیش‌فرض (سراسری) بدون نام است (یعنی پیشوندی مانند
\fI[section]\fR
ندارد).\& با این حال می‌توان آن را به طور صریح
\fI[main]\fR
نامید، به عنوان مثال اگر نیاز باشد پس از هر یک از بخش‌های دیگر مجدداً باز شود.\&
.PP
برنامه fnott فایل پیکربندی را به ترتیب در مکان‌های زیر جستجو می‌کند:
.PP
.PD 0
.IP \(bu 4
\fBXDG_CONFIG_HOME/fnott/fnott.\&ini\fR
(در صورت تنظیم نشدن، به صورت پیش‌فرض
\fB~/.\&config/fnott/fnott.\&ini\fR)
.IP \(bu 4
\fBXDG_CONFIG_DIRS/fnott/fnott.\&ini\fR
(در صورت تنظیم نشدن، به صورت پیش‌فرض
\fB/etc/xdg/fnott/fnott.\&ini\fR)
.PD
.PP
.SH "بخش: پیش‌فرض (SECTION: default)"
.PP
.SS "گزینه‌های سراسری (Global options)"
.PP
\fBoutput\fR
.RS 4
خروجی (نمایشگر) برای نمایش اعلان‌ها روی آن.\& اگر تعیین نشود، کامپوزیتور یکی را انتخاب خواهد کرد.\&
.PP
توجه داشته باشید که اگر خروجی را تعیین
\fBنکنید\fR،
و خروجی انتخاب‌شده توسط کامپوزیتور دارای مقیاس‌بندی (scaled) باشد، هر اعلان جدید پیش از رندر مجدد با ضریب مقیاس صحیح، یک فریم با وضوح پایین چشمک خواهد زد.\& این به این دلیل است که fnott تا
\fBپس از\fR
نگاشت شدن (یعنی نمایش داده شدن) اعلان، هیچ راهی برای دانستن ضریب مقیاس ندارد.\&
.PP
پیش‌فرض:
\fIتعیین‌نشده (unspecified)\fR.\&
.PP
در Sway می‌توانید از
\fBswaymsg -t get_outputs\fR
برای دریافت فهرستی از خروجی‌های در دسترس استفاده کنید.\&
.PP
.RE
\fBmin-width\fR
.RS 4
حداقل عرض اعلان، بر حسب پیکسل.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBmax-width\fR
.RS 4
حداکثر عرض اعلان، بر حسب پیکسل.\& مقدار 0 به معنای نامحدود است.\& توجه داشته باشید که اگر روی مقداری غیر از صفر تنظیم شود، fnott به طور خودکار متن اعلان را سطربندی (word-wrap) می‌کند.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBmax-height\fR
.RS 4
حداکثر ارتفاع اعلان، بر حسب پیکسل.\& مقدار 0 به معنای نامحدود است.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBicon-theme\fR
.RS 4
تم آیکون مورد استفاده هنگامی که یک اعلان درخواست آیکونی غیرداخلی (non-embedded) داده است.\& پیش‌فرض:
\fIdefault\fR.\&
.PP
.RE
\fBmax-icon-size\fR
.RS 4
حداکثر اندازه آیکون، بر حسب پیکسل.\& آیکون‌های بزرگ‌تر از این مقدار کوچک‌تر خواهند شد.\& مقدار 0 آیکون‌ها را غیرفعال می‌کند.\& پیش‌فرض:
\fI32\fR.\&
.PP
.RE
\fBstacking-order\fR
.RS 4
نحوه چیدمان (پشته‌بندی) چندین اعلان روی هم.\&
.PP
.RS 4
.PD 0
.IP \(bu 4
\fBbottom-up\fR :
قدیمی‌ترین و با بالاترین اولویت در دورترین نقطه از نقطه لنگر.\&
.IP \(bu 4
\fBtop-down\fR:
قدیمی‌ترین و با بالاترین اولویت در محل نقطه لنگر.\&
.PD
.PP
.RE
بنابراین، اگر اعلان‌ها در بالا لنگر انداخته باشند، حالت
\fBbottom-up\fR
جدیدترین اعلان را در گوشه بالا قرار می‌دهد، در حالی که قدیمی‌ترین اعلان در پایین پشته قرار می‌گیرد.\&
.PP
پیش‌فرض:
\fIbottom-up\fR.\&
.PP
.RE
\fBanchor\fR
.RS 4
محل قرارگیری اعلان‌ها:
\fBtop-left\fR،
\fBtop-right\fR،
\fBbottom-left\fR،
\fBbottom-right\fR
یا
\fBcenter\fR.\&
پیش‌فرض:
\fItop-right\fR.\&
.PP
.RE
\fBedge-margin-vertical\fR
.RS 4
حاشیه عمودی، بر حسب پیکسل، بین لبه صفحه (بالا یا پایین، بسته به نقطه لنگر) و اعلان‌ها.\& پیش‌فرض:
\fI10\fR.\&
.PP
.RE
\fBedge-margin-horizontal\fR
.RS 4
حاشیه افقی، بر حسب پیکسل، بین لبه صفحه (چپ یا راست، بسته به نقطه لنگر) و اعلان‌ها.\& پیش‌فرض:
\fI10\fR.\&
.PP
.RE
\fBnotification-margin\fR
.RS 4
حاشیه بین اعلان‌ها.\& پیش‌فرض:
\fI10\fR.\&
.PP
.RE
\fBselection-helper\fR
.RS 4
دستور (و در صورت تمایل آرگومان‌ها) برای اجرا جهت نمایش اقدامات (actions) و اجازه دادن به کاربر برای انتخاب یک اقدام جهت اجرا.\&
.PP
این ابزار کمکی باید ورودی‌های اقدام را که با خط جدید از هم جدا شده‌اند از ورودی استاندارد (stdin) بپذیرد و مورد انتخاب‌شده را روی خروجی استاندارد (stdout) بنویسد.\&
.PP
اکیداً توصیه می‌شود که اگر ابزار انتخابی شما پشتیبانی می‌کند، گزینه
\fBselection-helper-uses-null-separator\fR
(در زیر را ببینید) را فعال کنید.\&
.PP
پیش‌فرض:
\fIdmenu\fR.\&
.PP
.RE
\fBselection-helper-uses-null-separator\fR
.RS 4
بولین (Boolean).\& هنگام فعال بودن، رشته‌های اقدام که به ابزار کمکی انتخاب ارسال می‌شوند، به جای جدا شدن با خط جدید، با کاراکتر NULL از هم جدا خواهند شد.\&
.PP
توجه داشته باشید که ممکن است لازم باشد
\fBselection-helper\fR
را نیز تنظیم کنید تا مطمئن شوید ابزار کمکی انتخاب، رشته‌های اقدام را به درستی تجزیه می‌کند.\& به عنوان مثال، به جای
\fBfuzzel --dmenu\fR،
باید از
\fBfuzzel --dmenu0\fR
استفاده کنید.\&
.PP
پیش‌فرض:
\fIno\fR.\&
.PP
.RE
\fBplay-sound\fR
.RS 4
دستور اجرایی برای پخش صدای اعلان‌ها.\& عبارت
\fI${filename}\fR
به مسیر فایل صوتی برای پخش بسط داده می‌شود.\& پیش‌فرض:
\fIaplay ${filename}\fR.\&
.PP
.RE
\fBscaling-filter\fR
.PP
.RS 4
فیلتر مقیاس‌بندی مورد استفاده هنگام تغییر مقیاس تصویرهای اعلان غیر SVG.\&
.PP
مقادیر ممکن عبارتند از:
.PD 0
.IP \(bu 4
none
.IP \(bu 4
nearest
.IP \(bu 4
bilinear
.IP \(bu 4
cubic
.IP \(bu 4
lanczos3
.PD
.PP
حالت
\fBnone\fR
سریع‌ترین است، اما بدترین ظاهر را دارد.\& حالت
\fBlanczos3\fR
بهترین نتیجه را ایجاد می‌کند، اما با اختلاف زیاد، کندترین گزینه است.\&
.PP
پیش‌فرض:
\fIlanczos3\fR
.PP
.RE
.SS "گزینه‌های پیش‌فرض بر اساس فوریت (Per-urgency default options)"
.PP
این گزینه‌ها را می‌توان در یک بخش فوریت (\fIurgency\fR) نیز مشخص کرد، که در این صورت مقادیر مشخص‌شده در بخش پیش‌فرض را بازنویسی می‌کنند.\&
.PP
\fBlayer\fR
.RS 4
لایه‌ای که اعلان‌ها در آن ظاهر می‌شوند:
\fBbackground\fR،
\fBbottom\fR،
\fBtop\fR
یا
\fBoverlay\fR.\&
پیش‌فرض:
\fItop\fR.\&
.PP
.RE
\fBbackground\fR
.RS 4
رنگ پس‌زمینه اعلان، در قالب RGBA.\& پیش‌فرض:
\fI3f5f3fff\fR.\&
.PP
.RE
\fBborder-color\fR
.RS 4
رنگ کادر دور اعلان، در قالب RGBA.\& پیش‌فرض:
\fI909090ff\fR.\&
.PP
.RE
\fBborder-radius\fR
.RS 4
شعاع گردی گوشه‌های کادر، بر حسب پیکسل.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBborder-size\fR
.RS 4
اندازه ضخامت کادر، بر حسب پیکسل.\& پیش‌فرض:
\fI1\fR.\&
.PP
.RE
\fBpadding-vertical\fR
.RS 4
فاصله درونی (padding) عمودی، بر حسب پیکسل، بین لبه اعلان (بالا یا پایین) و متن اعلان.\& پیش‌فرض:
\fI20\fR.\&
.PP
.RE
\fBpadding-horizontal\fR
.RS 4
فاصله درونی (padding) افقی، بر حسب پیکسل، بین لبه اعلان (چپ یا راست) و متن اعلان.\& پیش‌فرض:
\fI20\fR.\&
.PP
.RE
\fBdpi-aware\fR
.RS 4
بولین (Boolean).\&
.PP
وقتی روی
\fByes\fR
تنظیم شود، اندازه قلم‌ها با استفاده از DPI نمایشگر محاسبه می‌شود، به طوری که یک قلم با اندازه مشخص، بدون توجه به نوع نمایشگر، اندازه فیزیکی یکسانی خواهد داشت.\&
.PP
در این حالت، ضریب مقیاس (scaling factor) نمایشگر نادیده گرفته می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر
\fBنخواهد کرد\fR.\&
.PP
وقتی روی
\fBno\fR
تنظیم شود، DPI نمایشگر نادیده گرفته می‌شود.\& در عوض اندازه قلم با استفاده از ضریب مقیاس نمایشگر تعیین می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر
\fBمی‌کند\fR.\&
.PP
توجه داشته باشید که این گزینه معمولاً با فونت‌های بیتی (bitmap) که فقط شامل مجموعه‌ای از اندازه‌های از پیش تعریف‌شده هستند و نمی‌توانند به طور پویا مقیاس‌بندی شوند، کار نمی‌کند.\& از بین اندازه‌های موجود، اندازه‌ای که بیشترین تطابق را با DPI یا ضریب مقیاس داشته باشد، استفاده خواهد شد.\&
.PP
همچنین توجه داشته باشید که اگر اندازه قلم بر حسب پیکسل مشخص شده باشد
(\fB:pixelsize=\fR\fIN\fR
به جای
\fB:size=\fR\fIN\fR)،
مقیاس‌بندی DPI
(\fBdpi-aware=yes\fR)
هیچ تاثیری نخواهد داشت (اندازه پیکسلی مشخص‌شده همان‌طور که هست استفاده می‌شود).\& اما اگر از ضریب مقیاس نمایشگر برای تعیین اندازه قلم استفاده شود
(\fBdpi-aware=no\fR)،
اندازه پیکسلی قلم در ضریب مقیاس ضرب خواهد شد.\&
.PP
پیش‌فرض:
\fIno\fR
.PP
.RE
\fBtitle-font\fR
.RS 4
قلم مورد استفاده برای عنوان برنامه، در قالب fontconfig (بخش
\fBقالب فونت (FONT FORMAT)\fR
را ببینید).\& پیش‌فرض:
\fIsans serif\fR.\&
.PP
.RE
\fBtitle-color\fR
.RS 4
رنگ متن مورد استفاده برای عنوان برنامه، در قالب RGBA.\& پیش‌فرض:
\fIffffffff\fR.\&
.PP
.RE
\fBtitle-format\fR
.RS 4
رشته الگو برای بخش عنوان اعلان (بخش
\fBرشته‌های قالب‌بندی (FORMAT STRINGS)\fR
را ببینید).\& پیش‌فرض:
\fI<i>%a%A</i>\fR.\&
.PP
.RE
\fBsummary-font\fR
.RS 4
قلم مورد استفاده برای خلاصه (چکیده)، در قالب fontconfig (بخش
\fBقالب فونت (FONT FORMAT)\fR
را ببینید).\& پیش‌فرض:
\fIsans serif\fR.\&
.PP
.RE
\fBsummary-color\fR
.RS 4
رنگ متن مورد استفاده برای خلاصه، در قالب RGBA.\& پیش‌فرض:
\fIffffffff\fR.\&
.PP
.RE
\fBsummary-format\fR
.RS 4
رشته الگو برای بخش خلاصه اعلان (بخش
\fBرشته‌های قالب‌بندی (FORMAT STRINGS)\fR
را ببینید).\& پیش‌فرض:
\fI<b>%s\en</b>\fR.\&
.PP
.RE
\fBbody-font\fR
.RS 4
قلم مورد استفاده برای بدنه متن، در قالب fontconfig (بخش
\fBقالب فونت (FONT FORMAT)\fR
را ببینید).\& پیش‌فرض:
\fIsans serif\fR.\&
.PP
.RE
\fBbody-color\fR
.RS 4
رنگ متن مورد استفاده برای بدنه متن، در قالب RGBA.\& پیش‌فرض:
\fIffffffff\fR.\&
.PP
.RE
\fBbody-format\fR
.RS 4
رشته الگو برای بخش بدنه اعلان (بخش
\fBرشته‌های قالب‌بندی (FORMAT STRINGS)\fR
را ببینید).\& پیش‌فرض:
\fI%b\fR.\&
.PP
.RE
\fBprogress-bar-height\fR
.RS 4
ارتفاع، بر حسب پیکسل، برای نوار پیشرفت (هنگامی که یک اعلان دارای نشانه
\fIint:value\fR
باشد رندر می‌شود).\& پیش‌فرض:
\fI20\fR.\&
.PP
.RE
\fBprogress-color\fR
.RS 4
رنگ نشانگر پیشرفت، در قالب RGBA.\& پیش‌فرض:
\fIffffffff\fR.\&
.PP
.RE
\fBprogress-style\fR
.RS 4
سبک نشانگر پیشرفت در اعلان‌ها را مشخص می‌کند.\&
.PP
مقادیر ممکن:
.PD 0
.IP \(bu 4
\fBbar\fR:
یک نوار پیشرفت مجزا را نمایش می‌دهد.\&
.IP \(bu 4
\fBbackground\fR:
پس‌زمینه اعلان را با رنگ پیشرفت پر می‌کند.\&
.PD
.PP
پیش‌فرض:
\fIbar\fR.\&
.PP
.RE
\fBmax-timeout\fR
.RS 4
محدودیت زمانی، بر حسب ثانیه، قبل از اینکه اعلان‌ها به طور خودکار بسته شوند.\& برنامه‌ها می‌توانند هنگام ایجاد اعلان، زمان پایان (timeout) خود را ارائه دهند.\& این گزینه می‌تواند برای محدود کردن آن زمان استفاده شود.\& مقدار 0 این محدودیت را غیرفعال می‌کند.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBdefault-timeout\fR
.RS 4
مدت زمان، بر حسب ثانیه، قبل از بسته شدن خودکار اعلان‌ها، در صورتی که برنامه ارسال‌کننده اعلان زمانی را مشخص نکرده باشد.\& مقدار 0 این زمان را غیرفعال می‌کند؛ یعنی اگر برنامه زمانی را ارائه ندهد، اعلان هرگز به طور خودکار بسته نمی‌شود (مگر اینکه
\fBmax-timeout\fR
تنظیم شده باشد).\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBidle-timeout\fR
.RS 4
مدت زمان، بر حسب ثانیه، که سیستم باید بیکار (idle) باشد تا از بسته شدن هرگونه اعلان جلوگیری شود.\& مقدار 0 این قابلیت را غیرفعال می‌کند.\& پیش‌فرض:
\fI0\fR.\&
.PP
.RE
\fBsound-file\fR
.RS 4
مسیر مطلق به فایل صوتی برای پخش در هنگام دریافت یک اعلان.\& در صورت تنظیم نشدن، هیچ صدایی پخش نمی‌شود.\& پیش‌فرض:
\fIتنظیم‌نشده (unset)\fR.\&
.PP
.RE
\fBicon\fR
.RS 4
آیکون مورد استفاده هنگامی که هیچ آیکونی توسط خود اعلان‌ها ارائه نشده باشد.\& می‌تواند یک مسیر مطلق یا یک نام (بدون پسوند) باشد.\&
.PP
در حالت دوم، بر اساس قوانین جایگزین (fallback) تعریف‌شده در مشخصات تم آیکون XDG، در تم آیکون انتخاب‌شده جستجو خواهد شد.\&
.PP
پیش‌فرض:
\fIتنظیم‌نشده (unset)\fR.\&
.PP
.RE
.SH "بخش: کم (SECTION: low)"
.PP
این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در
\fBگزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options)\fR
را برای اعلان‌های با اولویت کم (\fIlow\fR) بازنویسی (override) کنید.\&
.PP
به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند:
.PP
.PD 0
.IP \(bu 4
\fBbackground\fR: \fI2b2b2bff\fR
.IP \(bu 4
\fBtitle-color\fR: \fI888888ff\fR
.IP \(bu 4
\fBsummary-color\fR: \fI888888ff\fR
.IP \(bu 4
\fBbody-color\fR: \fI888888ff\fR
.PD
.PP
.SH "بخش: عادی (SECTION: normal)"
.PP
این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در
\fBگزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options)\fR
را برای اعلان‌های با اولویت عادی (\fInormal\fR) بازنویسی کنید.\&
.PP
به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند:
\fIهیچ‌کدام (none)\fR.\&
.PP
.SH "بخش: بحرانی (SECTION: critical)"
.PP
این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در
\fBگزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options)\fR
را برای اعلان‌های با اولویت بحرانی (\fIcritical\fR) بازنویسی کنید.\&
.PP
به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند:
.PP
.PD 0
.IP \(bu 4
\fBbackground\fR: \fI6c3333ff\fR
.PD
.PP
.SH "قالب فونت (FONT FORMAT)"
.PP
قلم در نحو (syntax) ابزار FontConfig مشخص می‌شود؛ یعنی فهرستی جداشده با دونقطه (:) از نام قلم و گزینه‌های قلم.\&
.PP
\fIمثال‌ها\fR:
.PD 0
.IP \(bu 4
Dina:weight=bold:slant=italic
.IP \(bu 4
Courier New:size=12
.PD
.PP
.SH "رشته‌های قالب‌بندی (FORMAT STRINGS)"
.PP
گزینه‌های
\fBtitle-format\fR،
\fBsummary-format\fR
و
\fBbody-format\fR
به شما امکان می‌دهند مشخص کنید چه چیزی برای بخش مربوطه از اعلان نمایش داده شود.\&
.PP
این گزینه‌ها رشته‌هایی شامل متغیرهای جایگزین (placeholders) هستند که با ویژگی‌های دریافت شده از اعلان بسط می‌یابند:
.PP
.PD 0
.IP \(bu 4
\fB%a\fR  نام برنامه
.IP \(bu 4
\fB%s\fR  خلاصه (چکیده) اعلان
.IP \(bu 4
\fB%b\fR  متن بدنه اعلان
.IP \(bu 4
\fB%A\fR  نشانگر اقدام (اگر اقداماتی وجود داشته باشد '\&*'\&، در غیر این صورت رشته خالی)
.IP \(bu 4
\fB%%\fR  کاراکتر واقعی '\&%'\&
.IP \(bu 4
\fB\en\fR  یک خط جدید واقعی (newline)
.PD
.PP
همچنین برچسب‌های نشانه‌گذاری (markup tags) زیر نیز پشتیبانی می‌شوند:
.PP
.PD 0
.IP \(bu 4
\fB<b>\fR  توپر (bold)
.IP \(bu 4
\fB<i>\fR  مورب (italic)
.IP \(bu 4
\fB<u>\fR  زیرخط‌دار (underline)
.PD
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBfnott\fR(1)