.\" Automatically generated by Pandoc 3.2
.\"
.TH "rofi\-actions" "5" "" "rofi" "راهنمای قالب‌های فایل"
.SH "نام (NAME)"
\f[B]rofi\-actions\f[R] \- دستورات سفارشی در پی تعامل با منوهای rofi
.SH "توضیحات (DESCRIPTION)"
\f[B]rofi\f[R] امکان تنظیم دستورات یا اسکریپت‌های سفارشی را فراهم می‌کند تا هنگام انجام برخی کنش‌ها در منو، مانند تغییر انتخاب، پذیرش یک ورودی یا لغو کردن، اجرا شوند.
.PP
این قابلیت به عنوان مثال پخش جلوه‌های صوتی یا خواندن گزینه‌های منو با صدای بلند هنگام انتخاب را امکان‌پذیر می‌سازد.
.SH "نحوه استفاده (USAGE)"
در ادامه فهرستی از گزینه‌های rofi برای تعیین دستورات یا اسکریپت‌های سفارشی جهت اجرا هنگام کنش‌های پشتیبانی‌شده آمده است:
.TP
\f[B]\-on\-selection\-changed\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام تغییر انتخاب جاری اجرا می‌شود.
متن انتخاب‌شده با جایگزینی الگوی \f[I]{entry}\f[R] به دستور فرستاده می‌شود.
.TP
\f[B]\-on\-entry\-accepted\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام پذیرش یک ورودی منو اجرا می‌شود.
متن پذیرفته‌شده با جایگزینی الگوی \f[I]{entry}\f[R] به دستور فرستاده می‌شود.
.TP
\f[B]\-on\-mode\-changed\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام تغییر حالت منو (مانند drun,window,ssh\&...) اجرا می‌شود.
.TP
\f[B]\-on\-menu\-canceled\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام لغو شدن منو اجرا می‌شود.
.TP
\f[B]\-on\-menu\-error\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام نمایش منوی خطا اجرا می‌شود (مانند \f[B]rofi \-e \[dq]error message\[dq]\f[R]).
متن خطا با جایگزینی الگوی \f[I]{error}\f[R] به دستور فرستاده می‌شود.
.TP
\f[B]\-on\-screenshot\-taken\f[R] \f[I]cmd\f[R]
دستور یا اسکریپتی که هنگام گرفتن تصویر صفحه از rofi اجرا می‌شود.
مسیر تصویر گرفته‌شده با جایگزینی الگوی \f[I]{path}\f[R] به دستور فرستاده می‌شود.
.SS "نمونه کاربرد (Example usage)"
خط فرمان rofi:
.IP
.EX
rofi \-on\-selection\-changed \[dq]/path/to/select.sh {entry}\[dq] \[rs]
     \-on\-entry\-accepted \[dq]/path/to/accept.sh {entry}\[dq] \[rs]
     \-on\-menu\-canceled \[dq]/path/to/exit.sh\[dq] \[rs]
     \-on\-mode\-changed \[dq]/path/to/change.sh\[dq] \[rs]
     \-on\-menu\-error \[dq]/path/to/error.sh {error}\[dq] \[rs]
     \-on\-screenshot\-taken \[dq]/path/to/camera.sh {path}\[dq] \[rs]
     \-show drun
.EE
.PP
فایل پیکربندی rofi:
.IP
.EX
configuration {
    on\-selection\-changed: \[dq]/path/to/select.sh {entry}\[dq];
    on\-entry\-accepted: \[dq]/path/to/accept.sh {entry}\[dq];
    on\-menu\-canceled: \[dq]/path/to/exit.sh\[dq];
    on\-mode\-changed: \[dq]/path/to/change.sh\[dq];
    on\-menu\-error: \[dq]/path/to/error.sh {error}\[dq];
    on\-screenshot\-taken: \[dq]/path/to/camera.sh {path}\[dq];
}
.EE
.SS "پخش جلوه‌های صوتی (Play sound effects)"
در ادامه یک اسکریپت نمونه bash آمده است که هنگام تغییر انتخاب جاری، با استفاده از \f[B]aplay\f[R] یک جلوه صوتی پخش می‌کند:
.IP
.EX
\f[I]#!/bin/bash\f[R]

coproc aplay \-q $HOME/Music/selecting_an_item.wav
.EE
.PP
استفاده از \f[B]coproc\f[R] برای پخش صداها پیشنهاد می‌شود، در غیر این صورت فرآیند rofi قبل از خروج، تا پایان پخش صدا منتظر خواهد ماند.
.SS "خواندن با صدای بلند (Read aloud)"
در ادامه یک اسکریپت نمونه bash آمده است که ورودی‌های انتخاب‌شده جاری را با استفاده از \f[B]espeak\f[R] با صدای بلند می‌خواند:
.IP
.EX
\f[I]#!/bin/bash\f[R]

killall espeak
echo \[dq]selected: $\[at]\[dq] \f[B]|\f[R] espeak
.EE