labnag(1) General Commands Manual labnag(1)

labnag - نمایش کادر محاوره‌ای همراه با پیام و دکمه‌ها

labnag [options...]

-B, --button <text> [<action>]

ایجاد یک دکمه با متن text که در صورت فشرده شدن، به صورت اختیاری action را اجرا می‌کند. با تعیین چندباره این فلگ، می‌توان چندین دکمه را تعریف کرد. دکمه‌ها به ترتیبی که ارائه شده‌اند از چپ به راست نمایش داده می‌شوند.

-Z, --button-dismiss <text> [<action>]

ایجاد یک دکمه با متن text که در صورت فشرده شدن، به صورت اختیاری action را اجرا کرده و labnag را می‌بندد. با تعیین چندباره این فلگ، می‌توان چندین دکمه را تعریف کرد. دکمه‌ها به ترتیبی که ارائه شده‌اند از چپ به راست نمایش داده می‌شوند.

-d, --debug

فعال‌سازی اشکال‌زدایی (دیباگ).

-e, --edge top|bottom

تعیین لبه مورد استفاده. پیش‌فرض top است.

-y, --layer overlay|top|bottom|background

تعیین لایه مورد استفاده. پیش‌فرض top است.

-k, --keyboard-focus none|exclusive|on-demand

تعیین سیاست فوکوس صفحه‌کلید. پیش‌فرض none است.

-f, --font <font>

تعیین قلم (فونت) مورد استفاده. پیش‌فرض Sans 10 است.

-h, --help

نمایش پیام راهنما و خروج.

-l, --detailed-message

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

-L, --detailed-button <text>

تنظیم متن دکمه‌ای که وضعیت جزئیات را تغییر می‌دهد. در صورتی که پیام همراه با جزئیات وجود نداشته باشد، این گزینه هیچ اثری ندارد. پیش‌فرض Toggle details است.

-m, --message <msg>

تنظیم متن پیام.

-o, --output <output>

تعیین خروجی مورد استفاده. این مقدار باید نام یک xdg_output باشد.

-t, --timeout

تنظیم مدت‌زمان لازم برای بستن کادر محاوره. پیش‌فرض ۵ ثانیه است.

-x, --exclusive-zone

استفاده از ناحیه اختصاصی (exclusive zone). پیش‌فرض false است.

-v, --version

نمایش شماره نسخه و خروج.

--background-color <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه. پیش‌فرض 900000 است.

--button-border-color <RRGGBB[AA]>

تنظیم رنگ کادر دکمه. پیش‌فرض D92424 است.

--border-bottom-color <RRGGBB[AA]>

تنظیم رنگ کادر پایینی. پیش‌فرض 470909 است.

--button-background-color <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه دکمه‌ها. پیش‌فرض 680A0A است.

--text-color <RRGGBB[AA]>

تنظیم رنگ متن. پیش‌فرض FFFFFF است.

--button-text-color <RRGGBB[AA]>

تنظیم رنگ متن دکمه. پیش‌فرض FFFFFF است.

--border-bottom-size <size>

تنظیم ضخامت کادر پایینی. پیش‌فرض 3 است.

--message-padding <padding>

تنظیم فاصله درونی (padding) پیام. پیش‌فرض 8 است.

--details-background-color <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه بخش جزئیات. پیش‌فرض 680A0A است.

--details-border-size <size>

تنظیم ضخامت کادر جزئیات. پیش‌فرض 3 است.

--details-border-color <RRGGBB[AA]>

تنظیم رنگ کادر جزئیات. پیش‌فرض 680A0A است.

--details-margin <margin>

تنظیم حاشیه بیرونی (margin) جزئیات. پیش‌فرض 11 است.

--button-border-size <size>

تنظیم ضخامت کادر دکمه. پیش‌فرض 3 است.

--button-gap <gap>

تنظیم فاصله میان دکمه‌ها. پیش‌فرض 20 است.

--button-dismiss-gap <gap>

تنظیم فاصله میان دکمه بستن و دکمه دیگر. پیش‌فرض 15 است.

--button-margin-right <margin>

تنظیم فاصله از سمت راست دکمه بستن تا لبه. پیش‌فرض 2 است.

--button-padding <padding>

تنظیم فاصله درونی (padding) متن دکمه. پیش‌فرض 3 است.

این یک مثال ساده از واسط گرافیکی خروج با استفاده از labnag است.

#!/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
2026-08-22