fnott(5) File Formats Manual fnott(5)

fnott.ini - فایل پیکربندی دیمن اعلان fnott

برنامه fnott از قالب استاندارد پیکربندی یونیکس با جفت‌های کلید/مقدار مبتنی بر بخش (section) استفاده می‌کند. بخش پیش‌فرض (سراسری) بدون نام است (یعنی پیشوندی مانند [section] ندارد). با این حال می‌توان آن را به طور صریح [main] نامید، به عنوان مثال اگر نیاز باشد پس از هر یک از بخش‌های دیگر مجدداً باز شود.

برنامه fnott فایل پیکربندی را به ترتیب در مکان‌های زیر جستجو می‌کند:

  • XDG_CONFIG_HOME/fnott/fnott.ini (در صورت تنظیم نشدن، به صورت پیش‌فرض ~/.config/fnott/fnott.ini)
  • XDG_CONFIG_DIRS/fnott/fnott.ini (در صورت تنظیم نشدن، به صورت پیش‌فرض /etc/xdg/fnott/fnott.ini)

output

خروجی (نمایشگر) برای نمایش اعلان‌ها روی آن. اگر تعیین نشود، کامپوزیتور یکی را انتخاب خواهد کرد.

توجه داشته باشید که اگر خروجی را تعیین نکنید، و خروجی انتخاب‌شده توسط کامپوزیتور دارای مقیاس‌بندی (scaled) باشد، هر اعلان جدید پیش از رندر مجدد با ضریب مقیاس صحیح، یک فریم با وضوح پایین چشمک خواهد زد. این به این دلیل است که fnott تا پس از نگاشت شدن (یعنی نمایش داده شدن) اعلان، هیچ راهی برای دانستن ضریب مقیاس ندارد.

پیش‌فرض: تعیین‌نشده (unspecified).

در Sway می‌توانید از swaymsg -t get_outputs برای دریافت فهرستی از خروجی‌های در دسترس استفاده کنید.

min-width

حداقل عرض اعلان، بر حسب پیکسل. پیش‌فرض: 0.

max-width

حداکثر عرض اعلان، بر حسب پیکسل. مقدار 0 به معنای نامحدود است. توجه داشته باشید که اگر روی مقداری غیر از صفر تنظیم شود، fnott به طور خودکار متن اعلان را سطربندی (word-wrap) می‌کند. پیش‌فرض: 0.

max-height

حداکثر ارتفاع اعلان، بر حسب پیکسل. مقدار 0 به معنای نامحدود است. پیش‌فرض: 0.

icon-theme

تم آیکون مورد استفاده هنگامی که یک اعلان درخواست آیکونی غیرداخلی (non-embedded) داده است. پیش‌فرض: default.

max-icon-size

حداکثر اندازه آیکون، بر حسب پیکسل. آیکون‌های بزرگ‌تر از این مقدار کوچک‌تر خواهند شد. مقدار 0 آیکون‌ها را غیرفعال می‌کند. پیش‌فرض: 32.

stacking-order

نحوه چیدمان (پشته‌بندی) چندین اعلان روی هم.
  • bottom-up : قدیمی‌ترین و با بالاترین اولویت در دورترین نقطه از نقطه لنگر.
  • top-down: قدیمی‌ترین و با بالاترین اولویت در محل نقطه لنگر.

بنابراین، اگر اعلان‌ها در بالا لنگر انداخته باشند، حالت bottom-up جدیدترین اعلان را در گوشه بالا قرار می‌دهد، در حالی که قدیمی‌ترین اعلان در پایین پشته قرار می‌گیرد.

پیش‌فرض: bottom-up.

anchor

محل قرارگیری اعلان‌ها: top-left، top-right، bottom-left، bottom-right یا center. پیش‌فرض: top-right.

edge-margin-vertical

حاشیه عمودی، بر حسب پیکسل، بین لبه صفحه (بالا یا پایین، بسته به نقطه لنگر) و اعلان‌ها. پیش‌فرض: 10.

edge-margin-horizontal

حاشیه افقی، بر حسب پیکسل، بین لبه صفحه (چپ یا راست، بسته به نقطه لنگر) و اعلان‌ها. پیش‌فرض: 10.

notification-margin

حاشیه بین اعلان‌ها. پیش‌فرض: 10.

selection-helper

دستور (و در صورت تمایل آرگومان‌ها) برای اجرا جهت نمایش اقدامات (actions) و اجازه دادن به کاربر برای انتخاب یک اقدام جهت اجرا.

این ابزار کمکی باید ورودی‌های اقدام را که با خط جدید از هم جدا شده‌اند از ورودی استاندارد (stdin) بپذیرد و مورد انتخاب‌شده را روی خروجی استاندارد (stdout) بنویسد.

اکیداً توصیه می‌شود که اگر ابزار انتخابی شما پشتیبانی می‌کند، گزینه selection-helper-uses-null-separator (در زیر را ببینید) را فعال کنید.

پیش‌فرض: dmenu.

selection-helper-uses-null-separator

بولین (Boolean). هنگام فعال بودن، رشته‌های اقدام که به ابزار کمکی انتخاب ارسال می‌شوند، به جای جدا شدن با خط جدید، با کاراکتر NULL از هم جدا خواهند شد.

توجه داشته باشید که ممکن است لازم باشد selection-helper را نیز تنظیم کنید تا مطمئن شوید ابزار کمکی انتخاب، رشته‌های اقدام را به درستی تجزیه می‌کند. به عنوان مثال، به جای fuzzel --dmenu، باید از fuzzel --dmenu0 استفاده کنید.

پیش‌فرض: no.

play-sound

دستور اجرایی برای پخش صدای اعلان‌ها. عبارت ${filename} به مسیر فایل صوتی برای پخش بسط داده می‌شود. پیش‌فرض: aplay ${filename}.

scaling-filter

فیلتر مقیاس‌بندی مورد استفاده هنگام تغییر مقیاس تصویرهای اعلان غیر SVG.

مقادیر ممکن عبارتند از:

  • none
  • nearest
  • bilinear
  • cubic
  • lanczos3

حالت none سریع‌ترین است، اما بدترین ظاهر را دارد. حالت lanczos3 بهترین نتیجه را ایجاد می‌کند، اما با اختلاف زیاد، کندترین گزینه است.

پیش‌فرض: lanczos3

این گزینه‌ها را می‌توان در یک بخش فوریت (urgency) نیز مشخص کرد، که در این صورت مقادیر مشخص‌شده در بخش پیش‌فرض را بازنویسی می‌کنند.

layer

لایه‌ای که اعلان‌ها در آن ظاهر می‌شوند: background، bottom، top یا overlay. پیش‌فرض: top.

background

رنگ پس‌زمینه اعلان، در قالب RGBA. پیش‌فرض: 3f5f3fff.

border-color

رنگ کادر دور اعلان، در قالب RGBA. پیش‌فرض: 909090ff.

border-radius

شعاع گردی گوشه‌های کادر، بر حسب پیکسل. پیش‌فرض: 0.

border-size

اندازه ضخامت کادر، بر حسب پیکسل. پیش‌فرض: 1.

padding-vertical

فاصله درونی (padding) عمودی، بر حسب پیکسل، بین لبه اعلان (بالا یا پایین) و متن اعلان. پیش‌فرض: 20.

padding-horizontal

فاصله درونی (padding) افقی، بر حسب پیکسل، بین لبه اعلان (چپ یا راست) و متن اعلان. پیش‌فرض: 20.

dpi-aware

بولین (Boolean).

وقتی روی yes تنظیم شود، اندازه قلم‌ها با استفاده از DPI نمایشگر محاسبه می‌شود، به طوری که یک قلم با اندازه مشخص، بدون توجه به نوع نمایشگر، اندازه فیزیکی یکسانی خواهد داشت.

در این حالت، ضریب مقیاس (scaling factor) نمایشگر نادیده گرفته می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر نخواهد کرد.

وقتی روی no تنظیم شود، DPI نمایشگر نادیده گرفته می‌شود. در عوض اندازه قلم با استفاده از ضریب مقیاس نمایشگر تعیین می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر می‌کند.

توجه داشته باشید که این گزینه معمولاً با فونت‌های بیتی (bitmap) که فقط شامل مجموعه‌ای از اندازه‌های از پیش تعریف‌شده هستند و نمی‌توانند به طور پویا مقیاس‌بندی شوند، کار نمی‌کند. از بین اندازه‌های موجود، اندازه‌ای که بیشترین تطابق را با DPI یا ضریب مقیاس داشته باشد، استفاده خواهد شد.

همچنین توجه داشته باشید که اگر اندازه قلم بر حسب پیکسل مشخص شده باشد (:pixelsize=N به جای :size=N)، مقیاس‌بندی DPI (dpi-aware=yes) هیچ تاثیری نخواهد داشت (اندازه پیکسلی مشخص‌شده همان‌طور که هست استفاده می‌شود). اما اگر از ضریب مقیاس نمایشگر برای تعیین اندازه قلم استفاده شود (dpi-aware=no)، اندازه پیکسلی قلم در ضریب مقیاس ضرب خواهد شد.

پیش‌فرض: no

title-font

قلم مورد استفاده برای عنوان برنامه، در قالب fontconfig (بخش قالب فونت (FONT FORMAT) را ببینید). پیش‌فرض: sans serif.

title-color

رنگ متن مورد استفاده برای عنوان برنامه، در قالب RGBA. پیش‌فرض: ffffffff.

title-format

رشته الگو برای بخش عنوان اعلان (بخش رشته‌های قالب‌بندی (FORMAT STRINGS) را ببینید). پیش‌فرض: <i>%a%A</i>.

summary-font

قلم مورد استفاده برای خلاصه (چکیده)، در قالب fontconfig (بخش قالب فونت (FONT FORMAT) را ببینید). پیش‌فرض: sans serif.

summary-color

رنگ متن مورد استفاده برای خلاصه، در قالب RGBA. پیش‌فرض: ffffffff.

summary-format

رشته الگو برای بخش خلاصه اعلان (بخش رشته‌های قالب‌بندی (FORMAT STRINGS) را ببینید). پیش‌فرض: <b>%s\n</b>.

body-font

قلم مورد استفاده برای بدنه متن، در قالب fontconfig (بخش قالب فونت (FONT FORMAT) را ببینید). پیش‌فرض: sans serif.

body-color

رنگ متن مورد استفاده برای بدنه متن، در قالب RGBA. پیش‌فرض: ffffffff.

body-format

رشته الگو برای بخش بدنه اعلان (بخش رشته‌های قالب‌بندی (FORMAT STRINGS) را ببینید). پیش‌فرض: %b.

progress-bar-height

ارتفاع، بر حسب پیکسل، برای نوار پیشرفت (هنگامی که یک اعلان دارای نشانه int:value باشد رندر می‌شود). پیش‌فرض: 20.

progress-color

رنگ نشانگر پیشرفت، در قالب RGBA. پیش‌فرض: ffffffff.

progress-style

سبک نشانگر پیشرفت در اعلان‌ها را مشخص می‌کند.

مقادیر ممکن:

  • bar: یک نوار پیشرفت مجزا را نمایش می‌دهد.
  • background: پس‌زمینه اعلان را با رنگ پیشرفت پر می‌کند.

پیش‌فرض: bar.

max-timeout

محدودیت زمانی، بر حسب ثانیه، قبل از اینکه اعلان‌ها به طور خودکار بسته شوند. برنامه‌ها می‌توانند هنگام ایجاد اعلان، زمان پایان (timeout) خود را ارائه دهند. این گزینه می‌تواند برای محدود کردن آن زمان استفاده شود. مقدار 0 این محدودیت را غیرفعال می‌کند. پیش‌فرض: 0.

default-timeout

مدت زمان، بر حسب ثانیه، قبل از بسته شدن خودکار اعلان‌ها، در صورتی که برنامه ارسال‌کننده اعلان زمانی را مشخص نکرده باشد. مقدار 0 این زمان را غیرفعال می‌کند؛ یعنی اگر برنامه زمانی را ارائه ندهد، اعلان هرگز به طور خودکار بسته نمی‌شود (مگر اینکه max-timeout تنظیم شده باشد). پیش‌فرض: 0.

idle-timeout

مدت زمان، بر حسب ثانیه، که سیستم باید بیکار (idle) باشد تا از بسته شدن هرگونه اعلان جلوگیری شود. مقدار 0 این قابلیت را غیرفعال می‌کند. پیش‌فرض: 0.

sound-file

مسیر مطلق به فایل صوتی برای پخش در هنگام دریافت یک اعلان. در صورت تنظیم نشدن، هیچ صدایی پخش نمی‌شود. پیش‌فرض: تنظیم‌نشده (unset).

icon

آیکون مورد استفاده هنگامی که هیچ آیکونی توسط خود اعلان‌ها ارائه نشده باشد. می‌تواند یک مسیر مطلق یا یک نام (بدون پسوند) باشد.

در حالت دوم، بر اساس قوانین جایگزین (fallback) تعریف‌شده در مشخصات تم آیکون XDG، در تم آیکون انتخاب‌شده جستجو خواهد شد.

پیش‌فرض: تنظیم‌نشده (unset).

این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در گزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options) را برای اعلان‌های با اولویت کم (low) بازنویسی (override) کنید.

به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند:

  • background: 2b2b2bff
  • title-color: 888888ff
  • summary-color: 888888ff
  • body-color: 888888ff

این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در گزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options) را برای اعلان‌های با اولویت عادی (normal) بازنویسی کنید.

به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند: هیچ‌کدام (none).

این بخش به شما امکان می‌دهد گزینه‌های فهرست‌شده در گزینه‌های پیش‌فرض بر اساس فوریت (per-urgency default options) را برای اعلان‌های با اولویت بحرانی (critical) بازنویسی کنید.

به‌طور پیش‌فرض، گزینه‌های زیر از قبل بازنویسی شده‌اند:

•
background: 6c3333ff

قلم در نحو (syntax) ابزار FontConfig مشخص می‌شود؛ یعنی فهرستی جداشده با دونقطه (:) از نام قلم و گزینه‌های قلم.

مثال‌ها:

  • Dina:weight=bold:slant=italic
  • Courier New:size=12

گزینه‌های title-format، summary-format و body-format به شما امکان می‌دهند مشخص کنید چه چیزی برای بخش مربوطه از اعلان نمایش داده شود.

این گزینه‌ها رشته‌هایی شامل متغیرهای جایگزین (placeholders) هستند که با ویژگی‌های دریافت شده از اعلان بسط می‌یابند:

  • %a نام برنامه
  • %s خلاصه (چکیده) اعلان
  • %b متن بدنه اعلان
  • %A نشانگر اقدام (اگر اقداماتی وجود داشته باشد '*'، در غیر این صورت رشته خالی)
  • %% کاراکتر واقعی '%'
  • \n یک خط جدید واقعی (newline)

همچنین برچسب‌های نشانه‌گذاری (markup tags) زیر نیز پشتیبانی می‌شوند:

  • <b> توپر (bold)
  • <i> مورب (italic)
  • <u> زیرخط‌دار (underline)

fnott(1)

2025-07-16