نام (NAME)

setxkbmap — تنظیم نگاشت کلیدها و چیدمان‌ها از طریق افزونه صفحه‌کلید X

خلاصه دستور (SYNOPSIS)

setxkbmap [options] [layout [variant [option ...]]]

توضیحات (DESCRIPTION)

ابزار setxkbmap صفحه‌کلید را برای استفاده از چیدمان مشخص‌شده در یک نشست X(7) نگاشت می‌کند. برای مشاهده جدول چیدمان‌ها و گزینه‌های موجود، xkeyboard-config(7) را ببینید.

گزینه‌ها به شرح زیر هستند:

-?, -help: چاپ پیامی برای توصیف ورودی‌های معتبر برای setxkbmap.
-compat name: نام مؤلفهٔ نگاشت سازگاری (compatibility map) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-config file: نام یک فایل پیکربندی XKB را مشخص می‌کند که صفحه‌کلید مورد استفاده را توصیف می‌کند.
-device deviceid: شناسه عددی دستگاه (device id) ورودی را برای به‌روزرسانی با چیدمان صفحه‌کلید جدید مشخص می‌کند. در صورت عدم تعیین، دستگاه صفحه‌کلید اصلی کارساز Xorg(1) به‌روزرسانی می‌شود.
-display display: نمایشگری (display) را مشخص می‌کند که باید با چیدمان جدید صفحه‌کلید به‌روزرسانی شود.
-geometry name: نام مؤلفهٔ هندسه (geometry) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-I directory: یک دایرکتوری را به فهرست دایرکتوری‌های مورد استفاده برای جستجوی فایل‌های چیدمان یا قوانین (rules) مشخص‌شده اضافه می‌کند.
-keycodes name: نام مؤلفهٔ کدهای کلید (keycodes) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-keymap name: نام توصیف نگاشت کلید (keymap) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-layout name: نام چیدمان مورد استفاده برای تعیین مؤلفه‌های سازنده توصیف صفحه‌کلید را مشخص می‌کند. گزینه -layout تنها یک بار می‌تواند استفاده شود. چندین چیدمان را می‌توان به صورت یک فهرست جداشده با کاما تعیین کرد.
-model name: نام مدل صفحه‌کلید مورد استفاده برای تعیین مؤلفه‌های سازنده توصیف صفحه‌کلید را مشخص می‌کند. تنها یک مدل می‌تواند در خط فرمان تعیین شود.
-option name: نام یک گزینه را برای تعیین مؤلفه‌های سازنده توصیف صفحه‌کلید مشخص می‌کند؛ می‌توان چندین گزینه را مشخص کرد، به ازای هر پرچم -option یک مورد. توجه داشته باشید که setxkbmap گزینه‌های مشخص‌شده در خط فرمان را به گزینه‌هایی که پیش‌تر تنظیم شده بودند (طبق آنچه در ویژگی‌های پنجره ریشه ذخیره شده است) اضافه می‌کند. اگر می‌خواهید تمام گزینه‌های از پیش تعیین‌شده را جایگزین کنید، ابتدا از پرچم -option با یک آرگومان خالی استفاده کنید.
-print: نام‌های مؤلفه‌ها را در قالبی قابل قبول برای کامپایلر نگاشت کلید xkbcomp(1) چاپ کرده و خارج می‌شود. این گزینه می‌تواند برای آزمودن به‌جای گزینه پرگویی (verbose) و در مواردی که نیاز است هر دو ابزار setxkbmap و xkbcomp(1) به‌صورت زنجیره‌ای اجرا شوند (به پایین مراجعه کنید) استفاده شود.
-query: قوانین، مدل، چیدمان، متغیر (variant) و گزینه‌های فعلی را چاپ کرده و سپس خارج می‌شود.
-rules file: نام فایل قوانینی را مشخص می‌کند که برای حل و تبدیل چیدمان و مدل درخواستی به مجموعه‌ای از نام‌های مؤلفه به کار می‌رود.
-symbols name: نام مؤلفهٔ نمادها (symbols) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-synch: همگام‌سازی اجباری را برای درخواست‌های X اعمال می‌کند.
-types name: نام مؤلفهٔ انواع (types) مورد استفاده برای ساخت یک چیدمان صفحه‌کلید را مشخص می‌کند.
-variant name: مشخص می‌کند کدام متغیر (variant) از چیدمان صفحه‌کلید باید برای تعیین مؤلفه‌های سازنده توصیف صفحه‌کلید استفاده شود. گزینه -variant تنها یک بار می‌تواند استفاده شود. چندین متغیر را می‌توان به صورت یک فهرست جداشده با کاما مشخص کرد که با چیدمان‌های مشخص‌شده با -layout تطبیق داده خواهند شد.
-v[erbose] [level]: سطح پرگویی (verbosity) در پیام‌های خروجی را مشخص می‌کند. سطوح معتبر از 0 (کمترین پرگویی) تا 10 (بیشترین پرگویی) است. پیش‌فرض: 5. در صورتی که هیچ سطحی تعیین نشود، هر پرچم -v یا -verbose سطح را 1 واحد افزایش می‌دهد.
-version: شماره نسخه ابزار را چاپ کرده و خارج می‌شود.

نکات پیاده‌سازی (IMPLEMENTATION NOTES)

یک نگاشت کلید XKB از چندین مؤلفه تشکیل شده است که تنها در صورت نیاز، با تبدیل آرگومان‌ها به نام‌های فایل‌های پیکربندی XKB در /usr/share/X11/xkb روی کلاینت X(7) کامپایل می‌شوند. این نام‌فایل‌ها سپس به کارساز Xorg(1) ارسال می‌شوند، مگر اینکه با -print در stdout(4) چاپ شوند.

فایل‌ها (FILES)

/usr/share/X11/xkb: منبع تمامی مؤلفه‌های XKB

وضعیت خروج (EXIT STATUS)

The setxkbmap utility exits 0 on success, and >0 if an error occurs.

مثال‌ها (EXAMPLES)

تغییر کاربری کلید Caps Lock به عنوان یک Control چپ اضافی:

setxkbmap -option
  ctrl:nocaps

تنظیم چیدمان به us و سرهم‌بندی نگاشت کلید روی کلاینت برای شرایطی که ممکن است فایل‌های مؤلفه XKB میان Xserver(1) و کلاینت تفاوت داشته باشند:

setxkbmap us -print | xkbcomp -
  $DISPLAY

بازنشانی گزینه‌های XKB:

setxkbmap -option

خطاها (DIAGNOSTICS)

Cannot open display "default display": محیط شل از نشست در حال اجرای X(7) آگاه نیست. پیش از استفاده از این ابزار X(7) را شروع کنید، یا متغیر محیطی DISPLAY را تنظیم کنید.
Running setxkbmap against an Xwayland server: این ابزار در یک نشست Xwayland(1) اجرا نخواهد شد. به‌جای آن از روش پیکربندی بومی XKB کامپوزیتور Wayland استفاده کنید.

همچنین ببینید (SEE ALSO)

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

تاریخچه (HISTORY)

setxkbmap نخستین بار در XFree86 3.2 ظاهر شد.