fnott(5)                      File Formats Manual                     fnott(5)

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

توضیحات (DESCRIPTION)
       برنامه 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)

بخش: پیش‌فرض (SECTION: default)
   گزینه‌های سراسری (Global options)
       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

   گزینه‌های پیش‌فرض بر اساس فوریت (Per-urgency default options)
       این گزینه‌ها را می‌توان در یک بخش فوریت (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).

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

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

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

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

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

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

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

       •   background: 6c3333ff

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

       مثال‌ها:
       •   Dina:weight=bold:slant=italic
       •   Courier New:size=12

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

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

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

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

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

همچنین ببینید (SEE ALSO)
       fnott(1)

                                  2025-07-16                          fnott(5)