نام (NAME)

xbindkeys - برنامه‌ای برای دریافت کلیدها در X

خلاصه دستور (SYNOPSIS)

xbindkeys [ گزینه‌ها ]

توضیحات (DESCRIPTION)

XbindKeys برنامه‌ای است که رویدادهای کلیدها و دکمه‌های ماوس را در X دریافت کرده و دستورهای متناظر در شل را اجرا می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان موجود به شرح زیر هستند:

-d, --defaults: چاپ یک فایل rc پیش‌فرض
-f, --file: استفاده از یک فایل rc جایگزین
-h, --help: راهنمای کوتاه درباره گزینه‌ها به‌همراه اطلاعات نسخه و نویسنده.
-X, --display: تنظیم نمایشگر X برای استفاده
-v, --verbose: اطلاعات بیشتر درباره xbindkeys در حین اجرا
-k, --key: شناسایی یک کلید فشرده‌شده (مفید برای پیکربندی)
-mk, --multikey: شناسایی چند کلید فشرده‌شده (مفید برای پیکربندی)
-g, --geometry: اندازه و موقعیت پنجره همراه با گزینه -k|-mk
-n, --nodaemon: عدم اجرا به صورت دیمن

در صورتی که پشتیبانی از guile غیرفعال نشده باشد:

-dg, --defaults-guile: چاپ یک فایل پیکربندی پیش‌فرض guile
-fg, --file-guile: استفاده از یک فایل پیکربندی جایگزین guile

XBINDKEYSRC

فایل پیکربندی پیش‌فرض XBindKeys در مسیر $HOME/.xbindkeysrc قرار دارد و تنها برای یک کاربر استفاده می‌شود.

فایل پیکربندی شامل دستورهایی درون گیومه دوتایی و کلیدهای متناظر در خط بعدی است.

توضیحات با یک علامت هش (#) آغاز شده و تا انتهای خط ادامه می‌یابند.

می‌توانید یک پیکربندی پیش‌فرض را با --defaults مشاهده کنید.

KEYSYMS

این برنامه انتظار دارد که ترکیب کدهای کلید (keysyms) با استفاده از نویسه به‌علاوه (+) انجام شود تا با یکدیگر ترکیب گردند.

قالب یک خط دستور به صورت زیر است:

"command to start &"
   associated key

برای تعیین کلید متناظر، می‌توانید از `xbindkeys --key` یا `xbindkeys --multikey` استفاده کرده و یکی از دو خط را در فایل پیکربندی قرار دهید.

فهرست کلیدها در /usr/include/X11/keysym.h و /usr/include/X11/keysymdef.h موجود است. نیازی به پیشوند XK_ نیست.

فهرست کلیدهای تغییردهنده (modifiers):

Release, Control, Shift, Mod1 (Alt), Mod2 (NumLock),
Mod3 (CapsLock), Mod4, Mod5 (Scroll).

تغییردهنده Release یک تغییردهنده استاندارد در X نیست، اما اگر می‌خواهید به جای رویداد فشرده شدن، رویداد رها کردن را دریافت کنید، می‌توانید از آن استفاده کنید. کلیدهای تغییردهنده به بزرگی و کوچکی حروف حساس نیستند.

به‌طور پیش‌فرض، xbindkeys به تغییردهنده‌های NumLock، CapsLock و ScrollLock توجهی نمی‌کند. اگر می‌خواهید این کلیدها در نظر گرفته شوند، خطوط زیر را به فایل پیکربندی اضافه کنید:

keystate_numlock = enable

keystate_capslock = enable
keystate_scrolllock= enable

مثال‌ها (EXAMPLES)

# فشردن control+shift+q برنامه xterm را اجرا می‌کند

"xterm"
  control+shift + q

# کلید Menu برنامه xbindkeys_show را اجرا می‌کند
"xbindkeys_show"
  Menu

# کلید Control به‌همراه دکمه ۱ ماوس برنامه xterm را اجرا می‌کند
"xterm"
  Control + b:1

# رویداد رها کردن Control+Shift+a برنامه rxvt را اجرا می‌کند
"rxvt"
  release+control+shift + a

# رویداد رها کردن Control به‌همراه دکمه ۲ ماوس برنامه rxvt را اجرا می‌کند
"rxvt"
  Control + b:2 + Release

سبک پیکربندی SCHEME (SCHEME CONFIGURATION STYLE)

در صورتی که پشتیبانی از guile غیرفعال نشده باشد، می‌توان از یک پیکربندی scheme استفاده کرد. پیکربندی استاندارد تنها در صورتی بارگذاری می‌شود که پیکربندی scheme در دسترس نباشد.

برای جزئیات بیشتر، لطفاً اینجا را ببینید:

http://www.gnu.org/software/guile/guile.html

نکته: فایل پیکربندی guile برای پیکربندی‌های غیرمعمول و پیچیده، مانند دوبار کلیک، کلیک زمان‌بندی‌شده یا ترکیب کلیدها ارجحیت دارد.

مسیر پیش‌فرض ~/.xbindkeysrc.scm است.

برای جزئیات بیشتر از xbindkeys --defaults-guile استفاده کنید.

و برای استفاده از این روش دستور xbindkeys --defaults-guile > ~/.xbindkeysrc.scm را اجرا نمایید.

نکته (NOTE)

در صورت تغییر فایل پیکربندی، xbindkeys آن را دوباره بارگذاری می‌کند. برای وادار کردن آن به بارگذاری مجدد، یک سیگنال HUP ارسال کنید:

killall -HUP xbindkeys

هنگامی که سیگنال HUP به xbindkeys ارسال می‌شود، تغییرات تنها پس از حرکت دادن ماوس اعمال می‌گردند.

گزارش باگ‌ها (BUGS)

اگر باگی پیدا کردید، لطفاً یک رایانامه به <xbindkeys-devel@nongnu.org> بفرستید.

صفحه خانگی (HOMEPAGE)

http://www.nongnu.org/xbindkeys

نویسندگان (AUTHORS)

Philippe Brochard <hocwp@free.fr>

Marcello Mathias Herreshoff برای پشتیبانی از guile <marcello@hummer.stanford.edu>

فایل‌ها (FILES)

$HOME/.xbindkeysrc
        فایل پیکربندی کاربر.

$HOME/.xbindkeysrc.scm
        فایل پیکربندی کاربر در scheme
        (اگر پشتیبانی از guile غیرفعال نشده باشد).

همچنین ببینید (SEE ALSO)

xbindkeys_show
    ابزاری برای نمایش کلیدهای میانبر فعلی با xbindkeys
xmodmap(1x)
    ابزاری برای تغییر نگاشت کلیدها و دکمه‌ها در X.
xev(1x)
    چاپ محتویات رویدادهای X.
/usr/include/X11/keysymdef.h
    تعاریف KeySym در X11.