.\" Generated by scdoc 1.11.5
.\" 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 "labnag" "1" "2026\-08\-22"
.PP
.SH "نام (NAME)"
.PP
labnag \- نمایش کادر محاوره‌ای همراه با پیام و دکمه‌ها
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fIlabnag\fR [options.\&.\&.\&]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-B, \-\-button\fR <text> [<action>]
.RS 4
ایجاد یک دکمه با متن \fItext\fR که در صورت فشرده شدن، به صورت اختیاری \fIaction\fR را اجرا می‌کند.\& با تعیین چندباره این فلگ، می‌توان چندین دکمه را تعریف کرد.\& دکمه‌ها به ترتیبی که ارائه شده‌اند از چپ به راست نمایش داده می‌شوند.\&
.PP
.RE
\fB\-Z, \-\-button\-dismiss\fR <text> [<action>]
.RS 4
ایجاد یک دکمه با متن \fItext\fR که در صورت فشرده شدن، به صورت اختیاری \fIaction\fR را اجرا کرده و labnag را می‌بندد.\& با تعیین چندباره این فلگ، می‌توان چندین دکمه را تعریف کرد.\& دکمه‌ها به ترتیبی که ارائه شده‌اند از چپ به راست نمایش داده می‌شوند.\&
.PP
.RE
\fB\-d, \-\-debug\fR
.RS 4
فعال‌سازی اشکال‌زدایی (دیباگ).\&
.PP
.RE
\fB\-e, \-\-edge\fR top|bottom
.RS 4
تعیین لبه مورد استفاده.\& پیش‌فرض top است.\&
.PP
.RE
\fB\-y, \-\-layer\fR overlay|top|bottom|background
.RS 4
تعیین لایه مورد استفاده.\& پیش‌فرض top است.\&
.PP
.RE
\fB\-k, \-\-keyboard\-focus none|exclusive|on\-demand\fR
.RS 4
تعیین سیاست فوکوس صفحه‌کلید.\& پیش‌فرض none است.\&
.PP
.RE
\fB\-f, \-\-font\fR <font>
.RS 4
تعیین قلم (فونت) مورد استفاده.\& پیش‌فرض \fISans 10\fR است.\&
.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\-t, \-\-timeout\fR
.RS 4
تنظیم مدت‌زمان لازم برای بستن کادر محاوره.\& پیش‌فرض ۵ ثانیه است.\&
.PP
.RE
\fB\-x, \-\-exclusive\-zone\fR
.RS 4
استفاده از ناحیه اختصاصی (exclusive zone).\& پیش‌فرض false است.\&
.PP
.RE
\fB\-v, \-\-version\fR
.RS 4
نمایش شماره نسخه و خروج.\&
.PP
.RE
.SH "گزینه‌های ظاهری (APPEARANCE OPTIONS)"
.PP
\fB\-\-background\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه.\& پیش‌فرض 900000 است.\&
.PP
.RE
\fB\-\-button\-border\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ کادر دکمه.\& پیش‌فرض D92424 است.\&
.PP
.RE
\fB\-\-border\-bottom\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ کادر پایینی.\& پیش‌فرض 470909 است.\&
.PP
.RE
\fB\-\-button\-background\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه دکمه‌ها.\& پیش‌فرض 680A0A است.\&
.PP
.RE
\fB\-\-text\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ متن.\& پیش‌فرض FFFFFF است.\&
.PP
.RE
\fB\-\-button\-text\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ متن دکمه.\& پیش‌فرض FFFFFF است.\&
.PP
.RE
\fB\-\-border\-bottom\-size\fR <size>
.RS 4
تنظیم ضخامت کادر پایینی.\& پیش‌فرض 3 است.\&
.PP
.RE
\fB\-\-message\-padding\fR <padding>
.RS 4
تنظیم فاصله درونی (padding) پیام.\& پیش‌فرض 8 است.\&
.PP
.RE
\fB\-\-details\-background\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ پس‌زمینه بخش جزئیات.\& پیش‌فرض 680A0A است.\&
.PP
.RE
\fB\-\-details\-border\-size\fR <size>
.RS 4
تنظیم ضخامت کادر جزئیات.\& پیش‌فرض 3 است.\&
.PP
.RE
\fB\-\-details\-border\-color\fR <RRGGBB[AA]>
.RS 4
تنظیم رنگ کادر جزئیات.\& پیش‌فرض 680A0A است.\&
.PP
.RE
\fB\-\-details\-margin\fR <margin>
.RS 4
تنظیم حاشیه بیرونی (margin) جزئیات.\& پیش‌فرض 11 است.\&
.PP
.RE
\fB\-\-button\-border\-size\fR <size>
.RS 4
تنظیم ضخامت کادر دکمه.\& پیش‌فرض 3 است.\&
.PP
.RE
\fB\-\-button\-gap\fR <gap>
.RS 4
تنظیم فاصله میان دکمه‌ها.\& پیش‌فرض 20 است.\&
.PP
.RE
\fB\-\-button\-dismiss\-gap\fR <gap>
.RS 4
تنظیم فاصله میان دکمه بستن و دکمه دیگر.\& پیش‌فرض 15 است.\&
.PP
.RE
\fB\-\-button\-margin\-right\fR <margin>
.RS 4
تنظیم فاصله از سمت راست دکمه بستن تا لبه.\& پیش‌فرض 2 است.\&
.PP
.RE
\fB\-\-button\-padding\fR <padding>
.RS 4
تنظیم فاصله درونی (padding) متن دکمه.\& پیش‌فرض 3 است.\&
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
این یک مثال ساده از واسط گرافیکی خروج با استفاده از \fIlabnag\fR است.\&
.PP
.nf
.RS 4
#!/bin/sh

# logout with labnag

labnag \\
 \-f "Hack Regular 10"\\
 \-m "Choose your logout option"\\
 \-Z "  Lock   " "gtklock \-d"\\
 \-Z " Logout  " "labwc \-e"\\
 \-Z "Shutdown " "systemctl poweroff"\\
 \-Z " Reboot  " "systemctl reboot"\\
 \-Z "Hibernate" "systemctl hibernate"\\
 \-Z " Suspend " "systemctl suspend"\\
 \-Z " Cancel  "\\
 \-\-background\-color 00ffff\\
 \-\-button\-background\-color 00ffff\\
 \-\-button\-border\-color 00ccccaa\\
 \-\-text\-color 000000\\
 \-\-button\-text\-color 000000\\
 \-\-button\-gap 8\\
 \-\-button\-margin\-right 0\\
 \-\-button\-padding 5\\
 \-\-button\-border\-size 2\\
 \-t 60
.fi
.RE