shortcut

میان‌برها نگاشتی بین نام‌های کوتاهی که برای نام‌گذاری راحت‌تر نگاشت‌ها در ابزارهای خط فرمان و رابط گرافیکی به کار می‌روند و نام‌های کامل نگاشت کلید XKB تعریف می‌کنند. نام نگاشت کلید XKB از یک مسیر نسبی به یک فایل (که اغلب فاقد بخش دایرکتوری است) و نام یک نگاشت درون پرانتز در همان فایل خاص تشکیل می‌شود.

نمونه‌ای از یک بخش میان‌بر که صفحه‌کلیدهای آمریکایی، آلمانی و فرانسوی (از توزیع X11) و اسلواکی (از توزیع xkbsel) را تعریف می‌کند:

[shortcut]
us = xfree86(us)
de = xfree86(de)
fr = xfree86(fr)
sk = czsk(sk)

mapset

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

[mapset]
map[sk] = sk us
map[de] = de us
map[fr] = fr us
map = us sk de fr

داده‌های اضافی XKB (ADDITIONAL XKB DATA)

فرض بر این است که شما نحوه ایجاد یک نگاشت صفحه‌کلید XKB را می‌دانید. این بخش تنها چگونگی افزودن داده‌های xkbsel را به نگاشت‌های جدید و نگاشت‌های موجود در توزیع X توضیح می‌دهد.

بسته xkbsel ساختار دایرکتوری XKB (که معمولاً در /usr/X11R6/lib/X11/xkb قرار دارد) را در دایرکتوری سیستمی xkbsel (معمولاً /usr/share/xkbsel) و در نهایت دایرکتوری کاربر (~/.xkbsel) منعکس می‌کند.

تنها دایرکتوری از ساختار اصلی XKB که برای xkbsel اهمیت دارد، زیردایرکتوری keymap است. این دایرکتوری نقطه شروعی است که بسته در آن به جستجوی نگاشت‌ها پرداخته و آن‌ها را برای کامپایل و نصب به xkbcomp(1) ارسال می‌کند.

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

هنگام وجود داده‌های متناقض، اولویت از بالاترین به پایین‌ترین عبارت است از:

فایل‌های موجود در دایرکتوری‌های کاربر غیر از keymap یا redef (مانند symbols) تنها زمانی استفاده می‌شوند که خود نگاشت در فایلی درون این دو دایرکتوری ذکر شده باشد؛ در غیر این صورت xkbsel اطلاعی از آن‌ها نخواهد داشت.

داده‌های مربوط به xkbsel با استفاده از یادداشت‌ها (کامنت‌ها)ی با قالب‌بندی ویژه در محدوده تعریف نگاشت کلید خاص به فایل‌های XKB اضافه می‌شوند. قالب کامنت به‌صورت زیر است:

%xkb_keyword% "value"

در حال حاضر دو مدخل از این داده‌ها وجود دارد:

description

توصیفی از نگاشت صفحه‌کلید در ابزارهای رابط گرافیکی تعریف می‌کند

pixmap

یک پیکس‌مپ برای ابزارهای رابط گرافیکی تعریف می‌کند (هنوز پیاده‌سازی نشده است)

نمونه‌ای از چنین تعریفی برای نگاشت کلید:

xkb_keymap "sk" {
    // %xkb_description% "Slovenska klavesnica"
    // %xkb_pixmap% "slovak.xpm"
    xkb_keycodes       { include "xfree86"      };
    xkb_types          { include "default"      };
    xkb_compatibility  { include "default"      };
    xkb_symbols        { include "czsk_ibm(sk)" };
    xkb_geometry       { include "pc"           };
};

توضیحات می‌توانند از کاراکترهایی در کدگذاری نویسه محلی استفاده کنند، اما به یاد داشته باشید که یک ابزار رابط گرافیکی در یک محلی (locale) خاص اجرا می‌شود و لزوماً تمام توضیحات نگاشت‌های انتخاب‌شده را به‌درستی نمایش نخواهد داد.

امکان افزودن این داده‌ها به نگاشت‌های موجود نیز وجود دارد. از آنجا که انجام این کار تنها در چند فایل به‌جای مطابقت دادن فایل‌های بازتعریف با فایل‌های keymap کاربردی‌تر است، این امکان وجود دارد که نام فایل را برای تعاریف بعدی مشخص کرد. این ویژگی فقط برای فایل‌های موجود در دایرکتوری‌های redef کاربرد دارد و به‌صورت

%xkb_file% "value"

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

// %xkb_file% "xfree86"
xkb_keymap "us"
{
  // %xkb_description% "US layout"
  // %xkb_pixmap% "us.xpm"
};
// %xkb_file% "sun/xfree86"
xkb_keymap "type4_us"
{
  // %xkb_description% "US layout for Sun"
  // %xkb_pixmap% "us.xpm"
};