.\" Generated by scdoc 1.11.4
.\" 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 "swaynag" "1" "2026-06-23"
.PP
.SH "نام (NAME)"
.PP
swaynag \- نمایش پیام هشدار یا خطا همراه با دکمه‌ها
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fIswaynag\fR [گزینه‌ها.\&.\&.\&]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-b, --button\fR <text> <action>
.RS 4
ایجاد دکمه‌ای با متن \fItext\fR که هنگام فشرده شدن، \fIaction\fR را اجرا می‌کند.\&
اگر متغیر محیطی \fITERMINAL\fR تنظیم شده باشد، \fIaction\fR درون ترمینال اجرا خواهد شد.\& در غیر این صورت، به اجرای مستقیم بازمی‌گردد.\& با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.\&
.PP
.RE
\fB-B, --button-no-terminal\fR <text> <action>
.RS 4
ایجاد دکمه‌ای با متن \fItext\fR که هنگام فشرده شدن، \fIaction\fR را اجرا می‌کند.\&
\fIaction\fR به جای اجرا در ترمینال، مستقیماً اجرا خواهد شد.\& با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.\&
.PP
.RE
\fB-z, --button-dismiss\fR <text> <action>
.RS 4
ایجاد دکمه‌ای با متن \fItext\fR که هنگام فشرده شدن، \fIaction\fR را اجرا کرده و swaynag را می‌بندد.\&
اگر متغیر محیطی \fITERMINAL\fR تنظیم شده باشد، \fIaction\fR درون ترمینال اجرا خواهد شد.\& در غیر این صورت، به اجرای مستقیم بازمی‌گردد.\& با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.\&
.PP
.RE
\fB-Z, --button-dismiss-no-terminal\fR <text> <action>
.RS 4
ایجاد دکمه‌ای با متن \fItext\fR که هنگام فشرده شدن، \fIaction\fR را اجرا کرده و swaynag را می‌بندد.\&
\fIaction\fR به جای اجرا در ترمینال، مستقیماً اجرا خواهد شد.\& با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.\&
.PP
.RE
\fB-c, --config\fR <path>
.RS 4
فایل پیکربندی مورد استفاده.\& به صورت پیش‌فرض، مسیرهای زیر بررسی می‌شوند:
\fI$HOME/.\&swaynag/config\fR، \fI$XDG_CONFIG_HOME/swaynag/config\fR و
\fISYSCONFDIR/swaynag/config\fR.\& تمام پرچم‌ها به جز این گزینه و \fIdebug\fR گزینه‌های
معتبری در فایل پیکربندی با قالب \fIlong-option=value\fR هستند.\& تمام خط فاصله‌های
ابتدایی باید حذف شوند و علامت مساوی الزامی است.\& برای اطلاعات بیشتر swaynag(5) را ببینید.\&
.PP
.RE
\fB-d, --debug\fR
.RS 4
فعال‌سازی اشکال‌زدایی.\&
.PP
.RE
\fB-e, --edge\fR top|bottom
.RS 4
تنظیم لبه مورد استفاده.\&
.PP
.RE
\fB-y, --layer\fR overlay|top|bottom|background
.RS 4
تنظیم لایه مورد استفاده.\&
.PP
.RE
\fB-f, --font\fR <font>
.RS 4
تنظیم فونت مورد استفاده.\&
.PP
.RE
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-l, --detailed-message\fR
.RS 4
خواندن یک پیام با جزئیات از stdin.\& دکمه‌ای برای تغییر وضعیت نمایش جزئیات اضافه
خواهد شد.\& جزئیات در یک ناحیه متنی چندخطی و قابل پیمایش نمایش داده می‌شوند.\&
.PP
.RE
\fB-L, --detailed-button\fR <text>
.RS 4
تنظیم متن دکمه تغییر وضعیت نمایش جزئیات.\& اگر پیام دارای جزئیات وجود نداشته
باشد، این گزینه تأثیری ندارد.\& مقدار پیش‌فرض \fIToggle details\fR است.\&
.PP
.RE
\fB-m, --message\fR <msg>
.RS 4
تنظیم متن پیام.\&
.PP
.RE
\fB-o, --output\fR <output>
.RS 4
تنظیم خروجی مورد استفاده.\& این مقدار باید نام یک \fIxdg_output\fR باشد.\&
.PP
.RE
\fB-s, --dismiss-button\fR <text>
.RS 4
تنظیم متن دکمه بستن nagbar.\& مقدار پیش‌فرض \fIX\fR است.\&
.PP
.RE
\fB-t, --type\fR <type>
.RS 4
تنظیم نوع پیام.\& دو نوع به صورت پیش‌فرض ایجاد شده‌اند: \fIerror\fR و
\fIwarning\fR.\& انواع سفارشی را می‌توان در فایل پیکربندی تعریف کرد.\& برای جزئیات به
\fI--config\fR و swaynag(5) مراجعه کنید.\& هر دو نوع پیش‌فرض را می‌توان در فایل پیکربندی نیز بازنویسی کرد.\&
.PP
.RE
\fB-v, --version\fR
.RS 4
نمایش شماره نسخه و خروج.\&
.PP
.RE
.SH "گزینه‌های ظاهری (APPEARANCE OPTIONS)"
.PP
\fB--background\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه.\&
.PP
.RE
\fB--border\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ حاشیه.\&
.PP
.RE
\fB--border-bottom\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ حاشیه پایینی.\&
.PP
.RE
\fB--button-background\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه دکمه‌ها.\&
.PP
.RE
\fB--text\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ متن.\&
.PP
.RE
\fB--button-text\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ متن دکمه.\&
.PP
.RE
\fB--border-bottom-size\fR <size>
.RS 4
تنظیم ضخامت حاشیه پایینی.\&
.PP
.RE
\fB--message-padding\fR <padding>
.RS 4
تنظیم حاشیه درونی (padding) پیام.\&
.PP
.RE
\fB--details-background\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه برای جزئیات.\&
.PP
.RE
\fB--details-border-size\fR <size>
.RS 4
تنظیم ضخامت حاشیه جزئیات.\&
.PP
.RE
\fB--button-border-size\fR <size>
.RS 4
تنظیم ضخامت حاشیه دکمه.\&
.PP
.RE
\fB--button-gap\fR <gap>
.RS 4
تنظیم اندازه فاصله میان دکمه‌ها.\&
.PP
.RE
\fB--button-dismiss-gap\fR <gap>
.RS 4
تنظیم اندازه فاصله میان دکمه بستن و دکمه‌ای دیگر.\&
.PP
.RE
\fB--button-margin-right\fR <margin>
.RS 4
تنظیم فاصله حاشیه از سمت راست دکمه بستن تا لبه.\&
.PP
.RE
\fB--button-padding\fR <padding>
.RS 4
تنظیم حاشیه درونی (padding) متن دکمه.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
swaynag(5)