XKBCOMP(1) X Version 11 XKBCOMP(1)

xkbcomp - کامپایل توصیف صفحه‌کلید XKB

xkbcomp [option] source [destination]

کامپایلر نگاشت کلید xkbcomp توصیف یک نگاشت کلید XKB را به یکی از چندین قالب خروجی تبدیل می‌کند. رایج‌ترین کاربرد xkbcomp ایجاد یک فایل کامپایل‌شدهٔ نگاشت کلید (با پسوند .xkm) است که می‌تواند مستقیماً توسط کارسازهای X یا ابزارهای مجهز به قابلیت XKB خوانده شود. این کامپایلر همچنین می‌تواند فایل‌های هدر C یا فایل‌های منبع XKB را تولید کند. فایل‌های هدر C تولیدشده توسط xkbcomp می‌توانند در کارسازهای X یا ابزارهایی که به نگاشت کلید پیش‌فرض داخلی نیاز دارند، گنجانده (include) شوند. فایل‌های منبع XKB تولیدشده توسط xkbcomp کاملاً تفکیک‌شده هستند و می‌توان از آن‌ها برای اطمینان از ادغام صحیح فایل‌هایی که معمولاً یک نگاشت کلید XKB را تشکیل می‌دهند یا برای ایجاد یک فایل واحد حاوی توصیف کامل نگاشت کلید استفاده کرد.

آرگومان source ممکن است یک نمایشگر X (نمایشگر X display) یا یک فایل .xkb یا .xkm را مشخص کند؛ مگر اینکه صراحتاً تعیین شده باشد، قالب destination به قالب منبع بستگی دارد. کامپایل یک فایل .xkb (منبع نگاشت کلید) به‌طور پیش‌فرض یک فایل .xkm (فایل نگاشت کلید کامپایل‌شده) تولید می‌کند. اگر منبع یک فایل .xkm یا یک نمایشگر X باشد، xkbcomp به‌طور پیش‌فرض یک فایل منبع نگاشت کلید ایجاد می‌کند.

اگر destination یک نمایشگر X باشد، نگاشت کلید آن نمایشگر با نگاشت کلید کامپایل‌شده به‌روزرسانی می‌شود.

نام destination معمولاً از روی نام منبع و با جایگزینی مناسب پسوند آن محاسبه می‌شود. هنگام کامپایل یک نگاشت واحد از فایلی که شامل چندین نگاشت است، xkbcomp نام فایل مقصد را با افزودن پسوند مناسب به نام نگاشت مورد استفاده می‌سازد.

نمایش تمام اطلاعات صفحه‌کلید، و گزارش اطلاعات ضمنی یا مشتق‌شده به‌صورت کامنت (توضیح). فقط بر خروجی قالب .xkb تأثیر می‌گذارد.
تولید یک فایل هدر C به عنوان خروجی (با پسوند .h).
محاسبه مقادیر پیش‌فرض برای هر مؤلفهٔ ناموجود، مانند نام کلیدها.
چاپ msg قبل از نمایش اولین پیام خطا.
چاپ msg در ابتدای هر خط از پیام‌ها.
در صورت بروز هرگونه خطا، چاپ msg پیش از خروج.
نمایش گزینه‌های موجود.
مشخص کردن دایرکتوری‌های سطح بالا برای جستجوی فایل‌های فراخوانی‌شده توسط توصیف نگاشت کلید. پس از جستجوی تمام دایرکتوری‌های مشخص‌شده توسط گزینه‌های -I، دایرکتوری جاری و در نهایت، دایرکتوری پیش‌فرض xkb یعنی /usr/share/X11/xkb جستجو خواهند شد.

برای جلوگیری از جستجوی دایرکتوری جاری و دایرکتوری پیش‌فرض، گزینهٔ -I را به تنهایی (یعنی بدون دایرکتوری) قبل از هر گزینهٔ -I دیگری که دایرکتوری‌های مورد نظر شما را مشخص می‌کند، به کار ببرید.

اگر source یا destination یک نمایشگر معتبر X باشد، نگاشت کلید را از/به دستگاهی با شناسهٔ مشخص‌شده (نه نام آن) بارگذاری می‌کند.
فهرست کردن نگاشت‌هایی که الگوی map را در هر یک از فایل‌های ذکرشده در خط فرمان مشخص کرده‌اند (هنوز پیاده‌سازی نشده است).
مشخص کردن نگاشتی که باید از فایلی با چندین مدخل کامپایل شود.
ادغام اطلاعات کامپایل‌شده با نگاشت موجود در کارساز (هنوز پیاده‌سازی نشده است).
تعیین نامی برای فایل خروجی تولیدشده. پیش‌فرض، نام فایل منبع با پسوند مناسب برای قالب خروجی است.
تعیین فهرستی از بخش‌های اختیاری. خطاهای کامپایل در هر یک از بخش‌های اختیاری کشنده نیستند. بخش‌ها می‌توانند از هر ترکیبی از حروف c، g، k، s و t تشکیل شوند که به‌ترتیب نگاشت سازگاری (compatibility map)، هندسه (geometry)، کدهای کلید (keycodes)، نمادها (symbols) و انواع (types) را مشخص می‌کنند.
مشخص کردن دایرکتوری ریشه برای مسیرهای نسبی.
اجبار همگام‌سازی (synchronization) برای درخواست‌های X.
چاپ شماره نسخه.
کنترل گزارش هشدارها هنگام کامپایل. سطح هشدار 0 همهٔ هشدارها را غیرفعال می‌کند؛ سطح هشدار 10 همهٔ آن‌ها را فعال می‌سازد.
تولید توصیف منبع صفحه‌کلید به عنوان خروجی (با پسوند .xkb).
تولید فایل کامپایل‌شدهٔ نگاشت کلید به عنوان خروجی (با پسوند .xkm).

setxkbmap(1), X(7), xkeyboard-config(7)

Erik Fortune, Silicon Graphics

2025-03-31 xkbcomp 1.5.0