swaynag(1)                  General Commands Manual                 swaynag(1)

نام (NAME)
       swaynag - نمایش پیام هشدار یا خطا همراه با دکمه‌ها

خلاصه دستور (SYNOPSIS)
       swaynag [گزینه‌ها...]

گزینه‌ها (OPTIONS)
       -b, --button <text> <action>
           ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا می‌کند.
           اگر متغیر محیطی TERMINAL تنظیم شده باشد، action درون ترمینال اجرا
           خواهد شد. در غیر این صورت، به اجرای مستقیم بازمی‌گردد. با مشخص کردن
           چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.

       -B, --button-no-terminal <text> <action>
           ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا می‌کند.
           action به جای اجرا در ترمینال، مستقیماً اجرا خواهد شد. با مشخص کردن
           چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.

       -z, --button-dismiss <text> <action>
           ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا کرده و
           swaynag را می‌بندد. اگر متغیر محیطی TERMINAL تنظیم شده باشد، action
           درون ترمینال اجرا خواهد شد. در غیر این صورت، به اجرای مستقیم
           بازمی‌گردد. با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را
           تعریف کرد.

       -Z, --button-dismiss-no-terminal <text> <action>
           ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا کرده و
           swaynag را می‌بندد. action به جای اجرا در ترمینال، مستقیماً اجرا
           خواهد شد. با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف
           کرد.

       -c, --config <path>
           فایل پیکربندی مورد استفاده. به صورت پیش‌فرض، مسیرهای زیر بررسی
           می‌شوند: $HOME/.swaynag/config، $XDG_CONFIG_HOME/swaynag/config و
           SYSCONFDIR/swaynag/config. تمام پرچم‌ها به جز این گزینه و debug
           گزینه‌های معتبری در فایل پیکربندی با قالب long-option=value هستند.
           تمام خط فاصله‌های ابتدایی باید حذف شوند و علامت مساوی الزامی است.
           برای اطلاعات بیشتر swaynag(5) را ببینید.

       -d, --debug
           فعال‌سازی اشکال‌زدایی.

       -e, --edge top|bottom
           تنظیم لبه مورد استفاده.

       -y, --layer overlay|top|bottom|background
           تنظیم لایه مورد استفاده.

       -f, --font <font>
           تنظیم فونت مورد استفاده.

       -h, --help
           نمایش پیام راهنما و خروج.

       -l, --detailed-message
           خواندن یک پیام با جزئیات از stdin. دکمه‌ای برای تغییر وضعیت نمایش
           جزئیات اضافه خواهد شد. جزئیات در یک ناحیه متنی چندخطی و قابل پیمایش
           نمایش داده می‌شوند.

       -L, --detailed-button <text>
           تنظیم متن دکمه تغییر وضعیت نمایش جزئیات. اگر پیام دارای جزئیات وجود
           نداشته باشد، این گزینه تأثیری ندارد. مقدار پیش‌فرض Toggle details
           است.

       -m, --message <msg>
           تنظیم متن پیام.

       -o, --output <output>
           تنظیم خروجی مورد استفاده. این مقدار باید نام یک xdg_output باشد.

       -s, --dismiss-button <text>
           تنظیم متن دکمه بستن nagbar. مقدار پیش‌فرض X است.

       -t, --type <type>
           تنظیم نوع پیام. دو نوع به صورت پیش‌فرض ایجاد شده‌اند: error و
           warning. انواع سفارشی را می‌توان در فایل پیکربندی تعریف کرد. برای
           جزئیات به --config و swaynag(5) مراجعه کنید. هر دو نوع پیش‌فرض را
           می‌توان در فایل پیکربندی نیز بازنویسی کرد.

       -v, --version
           نمایش شماره نسخه و خروج.

گزینه‌های ظاهری (APPEARANCE OPTIONS)
       --background <RRGGBB[AA]>
           تنظیم رنگ پس‌زمینه.

       --border <RRGGBB[AA]>
           تنظیم رنگ حاشیه.

       --border-bottom <RRGGBB[AA]>
           تنظیم رنگ حاشیه پایینی.

       --button-background <RRGGBB[AA]>
           تنظیم رنگ پس‌زمینه دکمه‌ها.

       --text <RRGGBB[AA]>
           تنظیم رنگ متن.

       --button-text <RRGGBB[AA]>
           تنظیم رنگ متن دکمه.

       --border-bottom-size <size>
           تنظیم ضخامت حاشیه پایینی.

       --message-padding <padding>
           تنظیم حاشیه درونی (padding) پیام.

       --details-background <RRGGBB[AA]>
           تنظیم رنگ پس‌زمینه برای جزئیات.

       --details-border-size <size>
           تنظیم ضخامت حاشیه جزئیات.

       --button-border-size <size>
           تنظیم ضخامت حاشیه دکمه.

       --button-gap <gap>
           تنظیم اندازه فاصله میان دکمه‌ها.

       --button-dismiss-gap <gap>
           تنظیم اندازه فاصله میان دکمه بستن و دکمه‌ای دیگر.

       --button-margin-right <margin>
           تنظیم فاصله حاشیه از سمت راست دکمه بستن تا لبه.

       --button-padding <padding>
           تنظیم حاشیه درونی (padding) متن دکمه.

همچنین ببینید (SEE ALSO)
       swaynag(5)

                                  2026-06-23                        swaynag(1)