.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICEWM-KEYS 5" .TH ICEWM-KEYS 5 2026-08-06 "icewm\ 4.1.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" .IX Subsection "NAME" .Vb 1 \& icewm\-keys \- فایل پیکربندی کلیدهای میانبر icewm .Ve .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" .Vb 5 \& $ICEWM_PRIVCFG/keys \& $XDG_CONFIG_HOME/icewm/keys \& $HOME/.icewm/keys \& /usr/etc/icewm/keys \& /usr/share/icewm/keys .Ve .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" فایل \f(CW\*(C`keys\*(C'\fR کلیدهای میانبر سراسری را برای اجرای برنامه‌ها تعریف می‌کند. یک کلید میانبر از سه بخش تشکیل شده است: واژهٔ \fBkey\fR، یک رشتهٔ داخل نقل‌قول دوتایی با ترکیب کلیدهای X11 و یک برنامه به همراه آرگومان‌های آن. این موارد با یک یا چند فاصله از هم جدا می‌شوند. خطوط خالی مجاز هستند. خطوط توضیحات با علامت هش (#) آغاز می‌شوند. .PP به عنوان مثال، دستور زیر یک کلید میانبر را برای راه‌اندازی مجدد \fBicewm\fR تعریف می‌کند: .PP .Vb 1 \& key "Ctrl+Shift+r" icesh restart .Ve .PP برای مشاهدهٔ فهرستی از نام‌های فراوان کلیدها که می‌توانید در تعاریف کلید icewm استفاده کنید، خروجی \f(CW\*(C`xmodmap \-pk\*(C'\fR را ببینید. از نسخهٔ 3.4.0 نرم‌افزار IceWM به بعد، میانبرها نه تنها با نام کلید (keystroke name) بلکه با برچسب کلید (key label) نیز قابل تعریف هستند. علاوه بر این، کلیدهای تغییریافته با Shift نیز اکنون قابل تعریف می‌باشند. برای مثال، کلید دارای + و = را می‌توان به هر یک از چهار روش زیر که همگی معادل یکدیگرند تعریف کرد: .PP .Vb 4 \& key "Ctrl+Shift+equal" xterm \& key "Ctrl+Shift+=" xterm \& key "Ctrl+plus" xterm \& key "Ctrl++" xterm .Ve .PP برای اتصال دکمه‌های ماوس، از \f(CW\*(C`Pointer_Button1\*(C'\fR برای دکمهٔ ۱ و به همین ترتیب برای دکمه‌های دیگر استفاده کنید. این قابلیت تنها زمانی کار می‌کند که اشاره‌گر ماوس روی پنجرهٔ ریشه (root window) قرار داشته باشد. برای مشاهدهٔ مثال‌ها بخش‌های زیر را ببینید. .PP گاهی اوقات ممکن است بخواهید یک برنامه فقط یک‌بار اجرا شود. برای این منظور از کلیدواژهٔ \f(CW\*(C`runonce\*(C'\fR استفاده کنید که یک آرگومان منبع (resource) اضافی را نیز می‌پذیرد. .PP دستور \f(CW\*(C`icesh keys\*(C'\fR به icewm دستور می‌دهد تا این فایل را مجدداً بارگذاری کند. .SS "قالب (FORMAT)" .IX Subsection "FORMAT" ساختار نحوی فایل \fIkeys\fR به شرح زیر است: .RS 4 .IP "\fBkey\fR \fB""\fR\fIkey_combination\fR\fB""\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "key ""key_combination"" program options" .RE .RS 4 .RE .PP که در آن: .IP \fBkey\fR 4 .IX Item "key" واژهٔ \fBkey\fR تعریف یک کلید میانبر را آغاز می‌کند. .IP \fIkey_combination\fR 4 .IX Item "key_combination" ترکیبی از کلیدهای تغییردهنده (modifiers) و یک کلید، مانند \f(CW\*(C`Ctrl+Alt+Delete\*(C'\fR. تغییردهنده‌های معتبر عبارتند از: Alt, AltGr, Ctrl, Hyper, Meta, Shift, Super. پس از هر تغییردهنده باید یک علامت به‌علاوه (+) قرار گیرد. کلید موردنظر می‌تواند نام کلید یا برچسب کلید باشد. به جای کلید کیبورد، می‌توان دکمه‌های اشاره‌گر ماوس را با \f(CW\*(C`Pointer_Button1\*(C'\fR به بالا مشخص کرد، مانند \f(CW\*(C`Shift+Pointer_Button3\*(C'\fR. .IP "\fIprogram\fR \fIoptions\fR" 4 .IX Item "program options" مقدار \fIprogram\fR نام فایل اجرایی یا مسیر آن است. این مقدار می‌تواند با یک تیلدا (~) یا یک متغیر محیطی شروع شود که در این صورت بسط داده خواهد شد. گزینه‌های \fIoptions\fR به عنوان آرگومان به \fIprogram\fR ارسال می‌شوند. .IP \fBrunonce\fR 4 .IX Item "runonce" جایگزینی برای \fBkey\fR است. ساختار نحوی آن به صورت زیر می‌باشد: .RS 4 .RS 4 .IP "\fBrunonce\fR \fB""\fR\fIhotkey\fR\fB""\fR \fB""\fR\fIwmclass\fR\fB""\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "runonce ""hotkey"" ""wmclass"" program options" .RE .RS 4 .RE .RE .RS 4 .Sp در اینجا \fIwmclass\fR نام منبع و/یا کلاس پنجره است. پیش از نام کلاس باید یک نقطه قرار گیرد. برنامه تنها زمانی اجرا می‌شود که هیچ پنجرهٔ برنامهٔ دیگری با همین \fIwmclass\fR وجود نداشته باشد. Icewm رویدادهای تکرار کلید را برای این کلید میانبر نادیده می‌گیرد. .RE .IP \fBswitchkey\fR 4 .IX Item "switchkey" جایگزینی برای \fBkey\fR است. در این حالت \fIprogram\fR باید تعریف یک \fBicewm\-menu\fR\|(1) پویا را در خروجی استاندارد چاپ کند. این منو به صورت یک منوی بازشو (popup) نمایش داده خواهد شد. .PP برای درج علامت نقل‌قول دوتایی به صورت مستقیم در آرگومان‌های برنامه، آن را با یک بک‌اسلش گریز دهید (\(rs"). یک رشتهٔ داخل نقل‌قول دوتایی را می‌توان با استفاده از بک‌اسلش در انتهای خط به خط بعد ادامه داد، اما این کار ضروری نیست زیرا خطوط می‌توانند طول دلخواهی داشته باشند. .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLES" در ادامه نمونه فایل \fIkeys\fR که همراه با \fBicewm\fR\|(1) ارائه می‌شود آمده است: .PP .Vb 10 \& # This is an example for IceWM\*(Aqs hotkey definition file. \& # \& # A list of all valid keyboard symbols can be found in \& # /usr/include/X11/keysymdef.h, XF86keysym.h, ... \& # Omit the XK_ prefixs and replace XF86XK_ prefixes by XF86. \& # Valid modifiers are Alt, AltGr, Ctrl, Shift, Meta, Super, Hyper. \& # \& key "Alt+Ctrl+t" xterm \& key "Alt+Ctrl+b" xdg\-open about:blank \& key "Alt+Ctrl+s" xdg\-open https://www.google.com \& \& key "Super+KP_Subtract" amixer sset PCM 5%\- \& key "Super+KP_Add" amixer sset PCM 5%+ \& \& # "Multimedia key" bindings for XFree86. Gather the \& # keycodes of your advanced function keys by watching the \& # output of the xev command whilst pressing those keys \& # and map those symbols using xmodmap. \& \& key "XF86AudioLowerVolume" amixer sset PCM 5%\- \& key "XF86AudioRaiseVolume" amixer sset PCM 5%+ \& key "XF86AudioMute" amixer sset PCM 0% \& key "XF86HomePage" xdg\-open about:blank \& key "XF86Search" xdg\-open https://www.google.com \& key "XF86Eject" eject \& \& # display and select monitor setup configurations \& switchkey "Super+p" icewm\-menu\-xrandr \& \& # display and select from all terminals \& switchkey "Super+q" icesh \-Z switchmenu .Ve .PP مثال زیر نحوهٔ افزودن اتصال دکمه‌های ماوس روی پنجرهٔ ریشه را برای تغییر فضای کاری جاری با چرخاندن چرخ ماوس روی دسکتاپ نشان می‌دهد: .PP .Vb 2 \& key "Pointer_Button4" icesh goto prev \& key "Pointer_Button5" icesh goto next .Ve .PP این‌ها میانبرهای کلیدی برای عملیات کاشی‌کاری (tile) تک‌پنجره‌ای هستند که جایگزین میانبرهای کلیدی \fIKeyWinArrange\fR از فایل \fIpreferences\fR می‌شوند: .PP .Vb 9 \& key "Ctrl+Alt+KP_Home" icesh \-f sizeto 49% 49% top left \& key "Ctrl+Alt+KP_Up" icesh \-f sizeto 100% 49% top left \& key "Ctrl+Alt+KP_Prior" icesh \-f sizeto 49% 49% top right \& key "Ctrl+Alt+KP_Right" icesh \-f sizeto 49% 100% top right \& key "Ctrl+Alt+KP_Next" icesh \-f sizeto 49% 49% bottom right \& key "Ctrl+Alt+KP_Down" icesh \-f sizeto 100% 49% bottom left \& key "Ctrl+Alt+KP_End" icesh \-f sizeto 49% 49% bottom left \& key "Ctrl+Alt+KP_Left" icesh \-f sizeto 49% 100% top left \& key "Ctrl+Alt+KP_Begin" icesh \-f sizeto 49% 49% center .Ve .SH "فایل‌ها (FILES)" .IX Subsection "FILES" مسیرهای فایل \fIkeys\fR به شرح زیر هستند: .PP .Vb 5 \& $ICEWM_PRIVCFG/keys \& $XDG_CONFIG_HOME/icewm/keys \& $HOME/.icewm/keys \& /usr/etc/icewm/keys \& /usr/share/icewm/keys .Ve .PP مسیرها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین فایل یافت‌شده خوانده شده و بقیه نادیده گرفته می‌شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Subsection "SEE ALSO" \&\fBicewm\fR\|(1). .SH "نویسندگان (AUTHORS)" .IX Subsection "AUTHORS" Brian Bidulock . .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" نرم‌افزار \fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. فایل \fICOPYING\fR را در توزیع برنامه مشاهده کنید.