xxkb(1) General Commands Manual xxkb(1)

xxkb - چیدمان صفحه‌کلید فعلی را تغییر داده و نمایش می‌دهد.

xxkb

برنامه xxkb چیدمان صفحه‌کلید فعلی (یک گروه XKB) را نشان داده و امکان جابه‌جایی آن را با یک کلیک ماوس فراهم می‌کند. این برنامه دارای برخی ویژگی‌های اضافی است. برنامه xxkb چیدمان را برای هر پنجره برنامه به خاطر می‌سپارد و زمانی که پنجره فوکوس دریافت می‌کند، وضعیت صفحه‌کلید را متناسب با آن تغییر می‌دهد. xxkb می‌تواند یک دکمه اضافی روی نوار عنوان پنجره قرار دهد که آن دکمه به عنوان یک تغییردهنده و نشانگر برای آن پنجره مجزا عمل می‌کند. اگر نگاشت صفحه‌کلید بیش از دو چیدمان داشته باشد، xxkb می‌تواند با استفاده از حالت two_state جابه‌جایی را ساده‌تر کند. در این حالت xxkb امکان انتخاب دو چیدمان را می‌دهد؛ یکی به عنوان چیدمان پایه و دیگری به عنوان چیدمان جایگزین، و سپس وضعیت صفحه‌کلید را تنها بین این دو تغییر می‌دهد. همچنین xxkb از فهرست برنامه‌ها پشتیبانی می‌کند که امکان تنظیم دقیق رفتار آن را برای برخی برنامه‌های خاص فراهم می‌سازد.
برنامه xxkb با هر مدیر پنجره‌ای کار می‌کند.

هنگام کار به عنوان یک نشانگر، xxkb چیدمان فعلی XKB را با استفاده از یکی از چهار تصویر pixmap نشان می‌دهد و هنگامی که چیدمان را با صفحه‌کلید تغییر می‌دهید (با استفاده از کلید یا ترکیب کلیدهای مشخص‌شده در فایل پیکربندی به عنوان تعویض‌کننده گروه XKB) یا از طریق هر برنامه دیگری که قادر به تغییر گروه XKB باشد، pixmap را تغییر می‌دهد. همچنین xxkb تصاویر pixmap مشابهی را روی نوار عنوان هر پنجره برنامه نمایش می‌دهد که نشانگرهایی برای پنجره‌های جداگانه هستند. از آنجا که نشانگر سراسری و نشانگرهای اختصاصی هر پنجره یکدیگر را تکرار می‌کنند، می‌توانید نشانگر سراسری یا تمام نشانگرهای پنجره‌ها را با استفاده از گزینه‌های پیکربندی پنهان کنید.
همچنین می‌توانید از xxkb به عنوان تغییردهنده چیدمان با کلیک دکمه ماوس روی پنجره اصلی xxkb یا یکی از نشانگرهای پنجره‌ها استفاده کنید. در حالت اخیر، چیدمان را برای برنامه انتخاب‌شده تغییر می‌دهید.

دکمه اول به عنوان تغییردهنده چیدمان عمل می‌کند. اگر حالت two_state فعال باشد، کلیک دکمه چیدمان فعلی را بین دو چیدمان انتخاب‌شده (گروه‌های XKB) جابه‌جا می‌کند. در غیر این صورت، تمام چیدمان‌های ممکن را به صورت چرخشی انتخاب می‌کند.
هنگامی که حالت two_state روشن است، دکمه سوم امکان انتخاب یک چیدمان جایگزین را فراهم می‌سازد. این دکمه تمام چیدمان‌های ممکن را به صورت چرخشی پیمایش کرده و چیدمانی که روی آن توقف می‌کنید، تبدیل به چیدمان جایگزین می‌شود. بدون حالت two_state عملکرد این دکمه مشابه عملکرد دکمه اول است.
عملکرد دکمه دوم (وسط) بستگی به مکانی دارد که کلیک می‌کنید. کلیک روی نشانگر اصلی به اجرای xxkb خاتمه می‌دهد. اما کلیک روی یکی از نشانگرهای پنجره‌ها، صرفاً نشانگر را از نوار عنوان حذف کرده و آن برنامه را از مجموعه برنامه‌های تحت مدیریت خارج می‌سازد. همچنین دکمه دوم به شما امکان می‌دهد یک برنامه را به یکی از سه فهرست برنامه‌های نادیده‌گرفته‌شده اضافه کنید (به بخش گزینه‌های فهرست برنامه‌ها در زیر مراجعه کنید). با کلیک روی نشانگر پنجره در حالی که کلید Control فشرده شده است، این برنامه را به فهرست wm_class_class اضافه می‌کنید. اگر کلید Shift فشرده شده باشد، کلیک دکمه برنامه را به فهرست wm_name اضافه می‌کند. اگر هر دو کلید فشرده شده باشند، کلیک برنامه را به فهرست wm_class_name اضافه خواهد کرد. در تمام موارد، فهرست‌های به‌روزشده در فایل پیکربندی اختصاصی کاربر یعنی ~/.xxkbrc ذخیره خواهند شد.

برنامه xxkb تمام گزینه‌های پیکربندی را از دو فایل app-defaults/XXkb و ~/.xxkbrc می‌خواند.

دایرکتوری که xxkb در آن به دنبال فایل‌های pixmap می‌گردد.

فعال کردن پنجره اصلی xxkb (به‌طور پیش‌فرض yes). اگر حالت per window button روشن باشد، برخی از کاربران ترجیح می‌دهند پنجره اصلی xxkb را پنهان کنند.
اجرای xxkb به صورت یک آیکون پویانما. این گزینه برای مدیر پنجره‌هایی که امکان الحاق (dock) برنامه‌ها را دارند مفید است.
امکان الحاق xxkb به سینی سیستم (system tray). مقدار آن true یا false است.
هندسه ( WIDTHxHEIGHT{+-}XOFF{+-}YOFF ) پنجره اصلی. لطفاً بخش GEOMETRY SPECIFICATIONS از راهنمای X(7) را برای جزئیات مطالعه کنید.
رنگی که هنگام رسم کادر پنجره استفاده می‌شود.
عرض کادر به پیکسل.
نام فایل‌های pixmap برای هر گروه مشخص‌شده N. اگر نگاشت نمادهای شما کمتر از چهار گروه دارد، آیکون‌های گروه‌های بدون استفاده را می‌توان نادیده گرفت. اگر نام فایل با '/' شروع شود به معنای مسیر کامل فایل است. در غیر این صورت به معنای مسیر نسبی از مقدار XXkb.xpm.path خواهد بود.
فعال‌سازی چاپ برچسب‌های متنی به جای تصاویر. از توضیحات گروه استفاده خواهد شد مگر اینکه توسط گزینه‌های XXkb.mainwindow.label.text.N (که N شماره گروه ۱..۴ است) بازنویسی شود.
برچسب برای گروه مشخص‌شده N.
رنگ‌های مورد استفاده برای رسم پس‌زمینه و متن برچسب به ترتیب.
فونت مورد استفاده هنگام رسم برچسب‌ها.

از آنجا که xxkb می‌تواند وضعیت صفحه‌کلید را برای هر برنامه نگه دارد و هنگام تغییر فوکوس وضعیت را بازیابی کند، گروهی از گزینه‌ها وجود دارند که نحوه یافتن پنجره‌های برنامه توسط xxkb را کنترل می‌کنند.

اگر این حالت فعال باشد (پیش‌فرض)، xxkb در زمان شروع تلاش می‌کند تمام برنامه‌هایی را که از قبل اجرا شده‌اند پیدا کند.
در این حالت xxkb پنجره برنامه جدید را در همان زمان ایجاد توسط برنامه دریافت می‌کند. این حالت پایه است اما تضمین نمی‌شود که با تمام مدیر پنجره‌ها کار کند.
در این حالت xxkb پنجره‌ها را در زمان ایجاد آن‌ها نمی‌گیرد، بلکه اگر وضعیت صفحه‌کلید هنگام فوکوس روی پنجره تغییر کند، پنجره‌ها را به فهرست پنجره‌های تحت مدیریت اضافه می‌کند. این یک حالت کمکی است (توصیه نمی‌شود) و ممکن است تنها در صورتی مفید باشد که حالت add_when_create بنا به دلیلی کار نکند.
باعث می‌شود هنگامی که فوکوس پنجره را ترک می‌کند، xxkb گروه صفحه‌کلید را بازنشانی کند. این حالت تنها همراه با حالت add_when_change معنا دارد.
این حالت (به‌طور پیش‌فرض فعال) به کاربر اجازه می‌دهد دکمه اختصاصی پنجره را با استفاده از کلیک دکمه وسط ماوس حذف کند. اگرچه xxkb تلاش می‌کند پنجره‌هایی را که تغییر چیدمان صفحه‌کلید در آن‌ها بی‌معنی است نادیده بگیرد، اما چنین پنجره‌هایی همچنان ممکن است ظاهر شوند، یا ممکن است پنجره‌هایی باشند که کاربر به دلایلی تمایلی به داشتن دکمه روی آن‌ها نداشته باشد.
این حالت علاوه بر حالت قبلی، باعث می‌شود xxkb پنجره‌ای را که دکمه‌اش حذف شده فراموش کند. این بدان معناست که xxkb تغییرات وضعیت صفحه‌کلید در این پنجره را به خاطر نمی‌سپارد و هنگام فوکوس مجدد روی آن، این وضعیت را بازیابی نخواهد کرد.
جابه‌جایی تنها بین دو چیدمان انتخاب‌شده صفحه‌کلید. اگر نگاشت نمادهای XKB بیش از دو گروه داشته باشد و همه آن‌ها برای هر برنامه مورد نیاز نباشند، xxkb امکان رد کردن چیدمان‌های غیرضروری را هنگام تغییر چیدمان فراهم می‌کند. می‌توانید یک گروه را به عنوان گروه پایه و دیگری را به عنوان گروه جایگزین انتخاب کنید و سپس تنها میان این دو گروه جابه‌جا شوید. گروه پایه برای تمام برنامه‌ها مشترک است (معمولاً شامل ASCII است) اما گروه جایگزین می‌تواند برای هر پنجره برنامه به صورت جداگانه انتخاب شود. در این حالت دکمه راست ماوس اجازه می‌دهد گروه جایگزین انتخاب شود و دکمه چپ ماوس و همچنین کلیدی که به عنوان تغییردهنده چیدمان پیکربندی شده است، وضعیت فعلی را تنها میان دو چیدمان انتخاب‌شده تغییر می‌دهند.
این حالت از دو گزینه پیکربندی اضافی استفاده می‌کند:
گروه پایه (عدد صحیح ۱..۴).
گروه جایگزین پیش‌فرض (عدد صحیح ۱..۴).

تمام این گزینه‌ها در صورتی معنا دارند که XXkb.button.enable فعال باشد.

در صورت فعال بودن، xxkb یک دکمه اضافی به نوار عنوان هر پنجره تحت مدیریت اضافه می‌کند که نشانگر و تغییردهنده چیدمان برای آن پنجره خاص است. این دکمه‌ها دکمه‌های معمولی مدیر پنجره نیستند، بلکه پنجره‌هایی (دارای یک تصویر pixmap) متعلق به خود xxkb هستند. این بدان معناست که در برخی موارد کاربر نیاز به تنظیم اندازه و موقعیت دکمه دارد تا دکمه شبیه به یک جزء تزیینی مدیر پنجره به نظر برسد.
هندسه دکمه ( WIDTHxHEIGHT{+-}XOFF{+-}YOFF ).
نام فایل‌های pixmap (همانند گزینه‌های XXkb.mainwindow.xpm.*).
توضیحات همتایان آن‌ها در پنجره اصلی را ببینید.

زنگ صفحه‌کلید را هنگام تغییر چیدمان فعال می‌کند.
مقدار یک آرگومان برای فراخوانی XBell.

برنامه xxkb اجازه می‌دهد تا فهرستی از برنامه‌هایی را که نیازمند اقدامات خاصی هستند مشخص کنید. برنامه‌ها می‌توانند با استفاده از مشخصه‌های WM_CLASS یا WM_NAME خود تعیین شوند.
شکل معمول چنین گزینه‌ای به صورت زیر است:

XXkb.app_list.property.action: an applications list


مقدار action در اینجا می‌تواند یکی از ignore، start_alt یا alt_groupn باشد. عملکرد ignore بدان معناست که xxkb باید پنجره‌های آن برنامه‌ها را نادیده بگیرد و آن‌ها را به مجموعه پنجره‌های تحت مدیریت اضافه نکند. عملکرد start_alt به این معناست که xxkb باید هنگام شروع برنامه، وضعیت صفحه‌کلید را روی چیدمان جایگزین تنظیم کند. و عملکردهای alt_group1، alt_group2، alt_group3 یا alt_group4 به شما اجازه می‌دهند تا چیدمان جایگزین را برای برخی برنامه‌ها، در صورتی که این چیدمان باید متفاوت از چیدمان جایگزین مشترک مشخص‌شده در گزینه XXkb.group.alt باشد، تعیین کنید.
مقدار property می‌تواند یکی از wm_class_class، wm_class_name یا wm_name باشد. برنامه xxkb می‌تواند یک برنامه را با استفاده از مشخصه‌های پنجره آن یعنی WM_CLASS یا WM_NAME شناسایی کند. مشخصه WM_CLASS در واقع از دو بخش تشکیل شده است - یک res_class و یک res_name. بنابراین فیلد property مشخص می‌کند کدام مشخصه یا بخشی از مشخصه باید برای شناسایی برنامه در نظر گرفته شود.
به‌طور پیش‌فرض تمام این فهرست‌ها خالی هستند. یک فهرست غیرخالی، دنباله‌ای از کلمات است که با فاصله/tab جدا شده‌اند. برنامه xxkb علامت ستاره (*) را به عنوان بخشی از کلمه می‌پذیرد. فهرست‌های طولانی را می‌توان با استفاده از یک بک‌اسلش به عنوان آخرین نویسه در خط، در خط بعدی ادامه داد.
برای مثال:
XXkb.app_list.wm_name.ignore: Fvwm* *clock \
Xman

این گزینه معنای فهرست XXkb.*.ignore را معکوس می‌کند. اگر این گزینه فعال شود، فهرست ignore تبدیل به فهرستی از پنجره‌هایی می‌شود که باید مدیریت شوند و همه پنجره‌های دیگر نادیده گرفته خواهند شد.

Ivan Pascal

24 Jun 2002 XXKB