.TH xxkb 1 "24 Jun 2002" "XXKB"

.SH "نام (NAME)"
xxkb \- چیدمان صفحه‌کلید فعلی را تغییر داده و نمایش می‌دهد.
.SH "خلاصه دستور (SYNOPSIS)"
.B xxkb
.SH "توضیحات (DESCRIPTION)"
برنامه \fBxxkb\fR چیدمان صفحه‌کلید فعلی (یک گروه XKB) را نشان داده و
امکان جابه‌جایی آن را با یک کلیک ماوس فراهم می‌کند. این برنامه دارای برخی ویژگی‌های اضافی است.
برنامه \fBxxkb\fR چیدمان را برای هر پنجره برنامه به خاطر می‌سپارد و زمانی که
پنجره فوکوس دریافت می‌کند، وضعیت صفحه‌کلید را متناسب با آن تغییر می‌دهد. \fBxxkb\fR
می‌تواند یک دکمه اضافی روی نوار عنوان پنجره قرار دهد که آن دکمه به عنوان یک
تغییردهنده و نشانگر برای آن پنجره مجزا عمل می‌کند. اگر نگاشت صفحه‌کلید بیش از
دو چیدمان داشته باشد، \fBxxkb\fR می‌تواند با استفاده از حالت \fBtwo_state\fR جابه‌جایی را
ساده‌تر کند. در این حالت \fBxxkb\fR امکان انتخاب دو چیدمان را می‌دهد؛ یکی به عنوان
چیدمان پایه و دیگری به عنوان چیدمان جایگزین، و سپس وضعیت صفحه‌کلید را تنها بین
این دو تغییر می‌دهد. همچنین \fBxxkb\fR از فهرست برنامه‌ها پشتیبانی می‌کند که امکان تنظیم
دقیق رفتار آن را برای برخی برنامه‌های خاص فراهم می‌سازد.
  برنامه \fBxxkb\fR با هر مدیر پنجره‌ای کار می‌کند.
.SH "نحوه استفاده (USAGE)"
هنگام کار به عنوان یک نشانگر، \fBxxkb\fR چیدمان فعلی XKB را با استفاده از یکی از
چهار تصویر pixmap نشان می‌دهد و هنگامی که چیدمان را با صفحه‌کلید تغییر می‌دهید
(با استفاده از کلید یا ترکیب کلیدهای مشخص‌شده در فایل پیکربندی به عنوان تعویض‌کننده
گروه XKB) یا از طریق هر برنامه دیگری که قادر به تغییر گروه XKB باشد، pixmap را تغییر می‌دهد.
همچنین \fBxxkb\fR تصاویر pixmap مشابهی را روی نوار عنوان هر پنجره برنامه نمایش می‌دهد
که نشانگرهایی برای پنجره‌های جداگانه هستند. از آنجا که نشانگر سراسری و نشانگرهای
اختصاصی هر پنجره یکدیگر را تکرار می‌کنند، می‌توانید نشانگر سراسری یا تمام نشانگرهای
پنجره‌ها را با استفاده از گزینه‌های پیکربندی پنهان کنید.
  همچنین می‌توانید از \fBxxkb\fR به عنوان تغییردهنده چیدمان با کلیک دکمه ماوس
روی پنجره اصلی \fBxxkb\fR یا یکی از نشانگرهای پنجره‌ها استفاده کنید.
در حالت اخیر، چیدمان را برای برنامه انتخاب‌شده تغییر می‌دهید.
.TP 4
.B MouseButton1
دکمه اول به عنوان تغییردهنده چیدمان عمل می‌کند. اگر حالت \fBtwo_state\fR فعال
باشد، کلیک دکمه چیدمان فعلی را بین دو چیدمان انتخاب‌شده (گروه‌های XKB) جابه‌جا می‌کند.
در غیر این صورت، تمام چیدمان‌های ممکن را به صورت چرخشی انتخاب می‌کند.
.TP 4
.B MouseButton3
هنگامی که حالت \fBtwo_state\fR روشن است، دکمه سوم امکان انتخاب یک چیدمان
جایگزین را فراهم می‌سازد. این دکمه تمام چیدمان‌های ممکن را به صورت چرخشی پیمایش کرده و
چیدمانی که روی آن توقف می‌کنید، تبدیل به چیدمان جایگزین می‌شود. بدون حالت
\fBtwo_state\fR عملکرد این دکمه مشابه عملکرد دکمه اول است.
.TP 4
.B MouseButton2
عملکرد دکمه دوم (وسط) بستگی به مکانی دارد که کلیک می‌کنید.
کلیک روی نشانگر اصلی به اجرای \fBxxkb\fR خاتمه می‌دهد. اما کلیک روی یکی
از نشانگرهای پنجره‌ها، صرفاً نشانگر را از نوار عنوان حذف کرده و آن برنامه را
از مجموعه برنامه‌های تحت مدیریت خارج می‌سازد. همچنین دکمه دوم به شما امکان می‌دهد
یک برنامه را به یکی از سه فهرست برنامه‌های نادیده‌گرفته‌شده اضافه کنید (به بخش
\fBگزینه‌های فهرست برنامه‌ها\fR در زیر مراجعه کنید). با کلیک روی نشانگر پنجره در حالی که
کلید \fBControl\fR فشرده شده است، این برنامه را به فهرست \fBwm_class_class\fR اضافه می‌کنید.
اگر کلید \fBShift\fR فشرده شده باشد، کلیک دکمه برنامه را به فهرست \fBwm_name\fR اضافه می‌کند.
اگر هر دو کلید فشرده شده باشند، کلیک برنامه را به فهرست \fBwm_class_name\fR اضافه خواهد کرد.
در تمام موارد، فهرست‌های به‌روزشده در فایل پیکربندی اختصاصی کاربر یعنی \fI~/.xxkbrc\fR
ذخیره خواهند شد.
.SH "گزینه‌های پیکربندی (CONFIGURE OPTIONS)"
برنامه \fBxxkb\fR تمام گزینه‌های پیکربندی را از دو فایل
\fIapp\-defaults/XXkb\fR و \fI~/.xxkbrc\fR می‌خواند.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.TP 4
.B XXkb.xpm.path
دایرکتوری که \fBxxkb\fR در آن به دنبال فایل‌های pixmap می‌گردد.
.SH "گزینه‌های پنجره اصلی (MAIN WINDOW OPTIONS)"
.TP 4
.B XXkb.mainwindow.enable
فعال کردن پنجره اصلی \fBxxkb\fR (به‌طور پیش‌فرض yes). اگر حالت \fIper window button\fR
روشن باشد، برخی از کاربران ترجیح می‌دهند پنجره اصلی \fBxxkb\fR را پنهان کنند.
.TP 4
.B XXkb.mainwindow.appicon
اجرای \fBxxkb\fR به صورت یک آیکون پویانما. این گزینه برای مدیر پنجره‌هایی که امکان
الحاق (dock) برنامه‌ها را دارند مفید است.
.TP 4
.B XXkb.mainwindow.in_tray
امکان الحاق \fBxxkb\fR به سینی سیستم (system tray). مقدار آن true یا false است.
.TP 4
.B XXkb.mainwindow.geometry
هندسه ( WIDTHxHEIGHT{+-}XOFF{+-}YOFF ) پنجره اصلی. لطفاً بخش
\fBGEOMETRY SPECIFICATIONS\fR از راهنمای X(7) را برای جزئیات مطالعه کنید.
.TP 4
.B XXkb.mainwindow.border.color
رنگی که هنگام رسم کادر پنجره استفاده می‌شود.
.TP 4
.B XXkb.mainwindow.border.width
عرض کادر به پیکسل.
.TP 4
.B XXkb.mainwindow.xpm.N
نام فایل‌های pixmap برای هر گروه مشخص‌شده N. اگر نگاشت نمادهای شما کمتر از چهار
گروه دارد، آیکون‌های گروه‌های بدون استفاده را می‌توان نادیده گرفت. اگر نام فایل با '/'
شروع شود به معنای مسیر کامل فایل است. در غیر این صورت به معنای مسیر نسبی از مقدار
\fBXXkb.xpm.path\fR خواهد بود.
.TP 4
.B XXkb.mainwindow.label.enable
فعال‌سازی چاپ برچسب‌های متنی به جای تصاویر. از توضیحات گروه استفاده خواهد شد
مگر اینکه توسط گزینه‌های \fBXXkb.mainwindow.label.text.N\fR (که N شماره گروه ۱..۴ است)
بازنویسی شود.
.TP 4
.B XXkb.mainwindow.label.text.N
برچسب برای گروه مشخص‌شده N.
.TP 4
.B XXkb.mainwindow.label.background
.TP 4
.B XXkb.mainwindow.label.foreground
رنگ‌های مورد استفاده برای رسم پس‌زمینه و متن برچسب به ترتیب.
.TP 4
.B XXkb.mainwindow.label.font
فونت مورد استفاده هنگام رسم برچسب‌ها.
.SH "گزینه‌های حالت عملیاتی (OPERATION MODE OPTIONS)"
از آنجا که \fBxxkb\fR می‌تواند وضعیت صفحه‌کلید را برای هر برنامه نگه دارد و هنگام تغییر
فوکوس وضعیت را بازیابی کند، گروهی از گزینه‌ها وجود دارند که نحوه یافتن پنجره‌های
برنامه توسط \fBxxkb\fR را کنترل می‌کنند.
.TP 4
.B XXkb.controls.add_when_start 
اگر این حالت فعال باشد (پیش‌فرض)، \fBxxkb\fR در زمان شروع تلاش می‌کند تمام
برنامه‌هایی را که از قبل اجرا شده‌اند پیدا کند.
.TP 4
.B XXkb.controls.add_when_create 
در این حالت \fBxxkb\fR پنجره برنامه جدید را در همان زمان ایجاد توسط برنامه دریافت
می‌کند. این حالت پایه است اما تضمین نمی‌شود که با تمام مدیر پنجره‌ها کار کند.
.TP 4
.B XXkb.controls.add_when_change 
در این حالت \fBxxkb\fR پنجره‌ها را در زمان ایجاد آن‌ها نمی‌گیرد، بلکه اگر وضعیت صفحه‌کلید
هنگام فوکوس روی پنجره تغییر کند، پنجره‌ها را به فهرست پنجره‌های تحت مدیریت اضافه
می‌کند. این یک حالت کمکی است (توصیه نمی‌شود) و ممکن است تنها در صورتی مفید باشد
که حالت \fBadd_when_create\fR بنا به دلیلی کار نکند.
.TP 4
.B XXkb.controls.focusout 
باعث می‌شود هنگامی که فوکوس پنجره را ترک می‌کند، \fBxxkb\fR گروه صفحه‌کلید را
بازنشانی کند. این حالت تنها همراه با حالت \fBadd_when_change\fR معنا دارد.
.TP 4
.B XXkb.controls.button_delete 
این حالت (به‌طور پیش‌فرض فعال) به کاربر اجازه می‌دهد دکمه اختصاصی پنجره را با
استفاده از کلیک دکمه وسط ماوس حذف کند. اگرچه \fBxxkb\fR تلاش می‌کند پنجره‌هایی را
که تغییر چیدمان صفحه‌کلید در آن‌ها بی‌معنی است نادیده بگیرد، اما چنین پنجره‌هایی
همچنان ممکن است ظاهر شوند، یا ممکن است پنجره‌هایی باشند که کاربر به دلایلی تمایلی
به داشتن دکمه روی آن‌ها نداشته باشد.
.TP 4
.B XXkb.controls.button_delete_and_forget 
این حالت علاوه بر حالت قبلی، باعث می‌شود \fBxxkb\fR پنجره‌ای را که دکمه‌اش حذف شده
فراموش کند. این بدان معناست که \fBxxkb\fR تغییرات وضعیت صفحه‌کلید در این پنجره را
به خاطر نمی‌سپارد و هنگام فوکوس مجدد روی آن، این وضعیت را بازیابی نخواهد کرد.
.TP 4
.B XXkb.controls.two_state 
جابه‌جایی تنها بین دو چیدمان انتخاب‌شده صفحه‌کلید.
اگر نگاشت نمادهای XKB بیش از دو گروه داشته باشد و همه آن‌ها برای هر برنامه مورد
نیاز نباشند، \fBxxkb\fR امکان رد کردن چیدمان‌های غیرضروری را هنگام تغییر چیدمان
فراهم می‌کند. می‌توانید یک گروه را به عنوان گروه پایه و دیگری را به عنوان گروه جایگزین
انتخاب کنید و سپس تنها میان این دو گروه جابه‌جا شوید. گروه پایه برای تمام برنامه‌ها
مشترک است (معمولاً شامل ASCII است) اما گروه جایگزین می‌تواند برای هر پنجره برنامه
به صورت جداگانه انتخاب شود. در این حالت دکمه راست ماوس اجازه می‌دهد گروه جایگزین
انتخاب شود و دکمه چپ ماوس و همچنین کلیدی که به عنوان تغییردهنده چیدمان پیکربندی
شده است، وضعیت فعلی را تنها میان دو چیدمان انتخاب‌شده تغییر می‌دهند.
  این حالت از دو گزینه پیکربندی اضافی استفاده می‌کند:
.TP 4
.B XXkb.group.base
گروه پایه (عدد صحیح ۱..۴).
.TP 4
.B XXkb.group.alt
گروه جایگزین پیش‌فرض (عدد صحیح ۱..۴).
.SH "گزینه‌های دکمه پنجره برنامه (APPLICATION WINDOW BUTTON OPTIONS)"
تمام این گزینه‌ها در صورتی معنا دارند که \fBXXkb.button.enable\fR فعال باشد.
.TP 4
.B XXkb.button.enable 
در صورت فعال بودن، \fBxxkb\fR یک دکمه اضافی به نوار عنوان هر پنجره تحت مدیریت
اضافه می‌کند که نشانگر و تغییردهنده چیدمان برای آن پنجره خاص است.
این دکمه‌ها دکمه‌های معمولی مدیر پنجره نیستند، بلکه پنجره‌هایی (دارای یک تصویر pixmap)
متعلق به خود \fBxxkb\fR هستند. این بدان معناست که در برخی موارد کاربر نیاز به تنظیم اندازه
و موقعیت دکمه دارد تا دکمه شبیه به یک جزء تزیینی مدیر پنجره به نظر برسد.
.TP 4
.B XXkb.button.geometry
هندسه دکمه ( WIDTHxHEIGHT{+-}XOFF{+-}YOFF ).
.TP 4
.B XXkb.button.xpm.N
نام فایل‌های pixmap (همانند گزینه‌های \fBXXkb.mainwindow.xpm.*\fR).
.TP 4
.B XXkb.button.label.enable
.TP 4
.B XXkb.button.label.text.N
.TP 4
.B XXkb.button.label.background
.TP 4
.B XXkb.button.label.foreground
.TP 4
.B XXkb.button.label.font
.TP 4
.B XXkb.button.border.color
.TP 4
.B XXkb.button.border.width
توضیحات همتایان آن‌ها در پنجره اصلی را ببینید.
.SH "گزینه‌های زنگ (BELL OPTIONS)"
.TP 4
.B XXkb.bell.enable
زنگ صفحه‌کلید را هنگام تغییر چیدمان فعال می‌کند.
.TP 4
.B XXkb.bell.percent
مقدار یک آرگومان برای فراخوانی XBell.
.SH "گزینه‌های فهرست برنامه‌ها (APPLICATIONS LISTS OPTIONS)"
برنامه \fBxxkb\fR اجازه می‌دهد تا فهرستی از برنامه‌هایی را که نیازمند اقدامات خاصی هستند
مشخص کنید. برنامه‌ها می‌توانند با استفاده از مشخصه‌های \fBWM_CLASS\fR یا \fBWM_NAME\fR
خود تعیین شوند.
  شکل معمول چنین گزینه‌ای به صورت زیر است:

\fBXXkb.app_list.\fIproperty\fB.\fIaction\fB: \fIan applications list\fR

  مقدار \fIaction\fR در اینجا می‌تواند یکی از \fBignore\fR، \fBstart_alt\fR یا
\fBalt_group\fIn\fR باشد.
عملکرد \fBignore\fR بدان معناست که \fBxxkb\fR باید پنجره‌های آن برنامه‌ها را نادیده بگیرد
و آن‌ها را به مجموعه پنجره‌های تحت مدیریت اضافه نکند. عملکرد \fBstart_alt\fR به این
معناست که \fBxxkb\fR باید هنگام شروع برنامه، وضعیت صفحه‌کلید را روی چیدمان جایگزین
تنظیم کند. و عملکردهای \fBalt_group1\fR، \fBalt_group2\fR، \fBalt_group3\fR یا
\fBalt_group4\fR به شما اجازه می‌دهند تا چیدمان جایگزین را برای برخی برنامه‌ها، در صورتی که
این چیدمان باید متفاوت از چیدمان جایگزین مشترک مشخص‌شده در گزینه \fBXXkb.group.alt\fR باشد،
تعیین کنید.
  مقدار \fIproperty\fR می‌تواند یکی از \fBwm_class_class\fR، \fBwm_class_name\fR یا
\fBwm_name\fR باشد.
برنامه \fBxxkb\fR می‌تواند یک برنامه را با استفاده از مشخصه‌های پنجره آن یعنی
\fBWM_CLASS\fR یا \fBWM_NAME\fR شناسایی کند. مشخصه \fBWM_CLASS\fR در واقع از
دو بخش تشکیل شده است \- یک \fBres_class\fR و یک \fBres_name\fR. بنابراین فیلد
\fIproperty\fR مشخص می‌کند کدام مشخصه یا بخشی از مشخصه باید برای شناسایی برنامه
در نظر گرفته شود.
  به‌طور پیش‌فرض تمام این فهرست‌ها خالی هستند. یک فهرست غیرخالی، دنباله‌ای از کلمات است
که با فاصله/tab جدا شده‌اند. برنامه \fBxxkb\fR علامت ستاره (*) را به عنوان بخشی از کلمه می‌پذیرد.
فهرست‌های طولانی را می‌توان با استفاده از یک بک‌اسلش به عنوان آخرین نویسه در خط، در خط
بعدی ادامه داد.
  برای مثال:
  XXkb.app_list.wm_name.ignore: Fvwm* *clock \\
.br
                                Xman
.TP 4
.B XXkb.ignore.reverse
این گزینه معنای فهرست \fBXXkb.*.ignore\fR را معکوس می‌کند. اگر این گزینه فعال شود،
فهرست \fBignore\fR تبدیل به فهرستی از پنجره‌هایی می‌شود که باید مدیریت شوند و همه پنجره‌های
دیگر نادیده گرفته خواهند شد.
.SH "نویسندگان (AUTHORS)"
Ivan Pascal