labnag(1)                   General Commands Manual                  labnag(1)

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

خلاصه دستور (SYNOPSIS)
       labnag [options...]

گزینه‌ها (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
           نمایش شماره نسخه و خروج.

گزینه‌های ظاهری (APPEARANCE OPTIONS)
       --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 است.

مثال‌ها (EXAMPLES)
       این یک مثال ساده از واسط گرافیکی خروج با استفاده از 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                         labnag(1)