rofi-actions(5)              راهنمای قالب‌های فایل              rofi-actions(5)

نام (NAME)
       rofi-actions - دستورات سفارشی در پی تعامل با منوهای rofi

توضیحات (DESCRIPTION)
       rofi امکان تنظیم دستورات یا اسکریپت‌های سفارشی را فراهم می‌کند تا هنگام
       انجام برخی کنش‌ها در منو، مانند تغییر انتخاب، پذیرش یک ورودی یا لغو
       کردن، اجرا شوند.

       این قابلیت به عنوان مثال پخش جلوه‌های صوتی یا خواندن گزینه‌های منو با
       صدای بلند هنگام انتخاب را امکان‌پذیر می‌سازد.

نحوه استفاده (USAGE)
       در ادامه فهرستی از گزینه‌های rofi برای تعیین دستورات یا اسکریپت‌های
       سفارشی جهت اجرا هنگام کنش‌های پشتیبانی‌شده آمده است:

       -on-selection-changed cmd
              دستور یا اسکریپتی که هنگام تغییر انتخاب جاری اجرا می‌شود.  متن
              انتخاب‌شده با جایگزینی الگوی {entry} به دستور فرستاده می‌شود.

       -on-entry-accepted cmd
              دستور یا اسکریپتی که هنگام پذیرش یک ورودی منو اجرا می‌شود.  متن
              پذیرفته‌شده با جایگزینی الگوی {entry} به دستور فرستاده می‌شود.

       -on-mode-changed cmd
              دستور یا اسکریپتی که هنگام تغییر حالت منو (مانند
              drun,window,ssh...) اجرا می‌شود.

       -on-menu-canceled cmd
              دستور یا اسکریپتی که هنگام لغو شدن منو اجرا می‌شود.

       -on-menu-error cmd
              دستور یا اسکریپتی که هنگام نمایش منوی خطا اجرا می‌شود (مانند rofi
              -e "error message").  متن خطا با جایگزینی الگوی {error} به دستور
              فرستاده می‌شود.

       -on-screenshot-taken cmd
              دستور یا اسکریپتی که هنگام گرفتن تصویر صفحه از rofi اجرا می‌شود.
              مسیر تصویر گرفته‌شده با جایگزینی الگوی {path} به دستور فرستاده
              می‌شود.

   نمونه کاربرد (Example usage)
       خط فرمان rofi:

              rofi -on-selection-changed "/path/to/select.sh {entry}" \
                   -on-entry-accepted "/path/to/accept.sh {entry}" \
                   -on-menu-canceled "/path/to/exit.sh" \
                   -on-mode-changed "/path/to/change.sh" \
                   -on-menu-error "/path/to/error.sh {error}" \
                   -on-screenshot-taken "/path/to/camera.sh {path}" \
                   -show drun

       فایل پیکربندی rofi:

              configuration {
                  on-selection-changed: "/path/to/select.sh {entry}";
                  on-entry-accepted: "/path/to/accept.sh {entry}";
                  on-menu-canceled: "/path/to/exit.sh";
                  on-mode-changed: "/path/to/change.sh";
                  on-menu-error: "/path/to/error.sh {error}";
                  on-screenshot-taken: "/path/to/camera.sh {path}";
              }

   پخش جلوه‌های صوتی (Play sound effects)
       در ادامه یک اسکریپت نمونه bash آمده است که هنگام تغییر انتخاب جاری، با
       استفاده از aplay یک جلوه صوتی پخش می‌کند:

              #!/bin/bash

              coproc aplay -q $HOME/Music/selecting_an_item.wav

       استفاده از coproc برای پخش صداها پیشنهاد می‌شود، در غیر این صورت فرآیند
       rofi قبل از خروج، تا پایان پخش صدا منتظر خواهد ماند.

   خواندن با صدای بلند (Read aloud)
       در ادامه یک اسکریپت نمونه bash آمده است که ورودی‌های انتخاب‌شده جاری را
       با استفاده از espeak با صدای بلند می‌خواند:

              #!/bin/bash

              killall espeak
              echo "selected: $@" | espeak

rofi                                                           rofi-actions(5)