.TH XKBSEL 5 "23 Jul 1999" "xkbsel" "" .\" $Id: xkbsel.5,v 1.2 1999/07/23 14:46:32 stano Exp $ .SH "نام (NAME)" xkbsel \- فایل‌های ابزار انتخاب صفحه‌کلید XKB .SH "توضیحات (DESCRIPTION)" .B xkbsel چارچوبی برای تعریف، انتخاب و نمایش نگاشت‌های صفحه‌کلید XKB است. این ابزار امکان پیوست کردن داده‌های اضافی به فایل‌های منبع XKB و انتخاب زیرمجموعه‌ای از نگاشت‌های ارائه‌شده به کاربر (به‌ازای هر سیستم و به‌ازای هر کاربر) را در یک رابط گرافیکی یا واسط خط فرمان فراهم می‌کند. .PP این صفحه راهنما نحو (syntax) فایل‌های پیکربندی و افزونه‌های نحو XKB را که برای پیوست کردن داده‌های اضافی استفاده می‌شوند، شرح می‌دهد. .SH "فایل‌های پیکربندی (CONFIGURATION FILES)" فایل‌های پیکربندی .I xkbsel.conf نام دارند و حاوی مدخل‌های پیکربندی تقسیم‌شده به بخش‌ها هستند. نام بخش‌ها درون براکت قرار می‌گیرد و مدخل‌ها می‌توانند با یک توصیف‌کننده اختیاری مشخص شوند. هر مدخل می‌تواند صفر یا چند مقدار داشته باشد: .RS .PP .nf # comment // comment [section] entry1 = value entry2[qualif] = val1 "special-val2" val3 .fi .RE .PP نام بخش‌ها، نام مدخل‌ها، توصیف‌کننده‌ها و مقادیر فاقد علامت نقل‌قول با یک حرف، اسلش یا زیرخط آغاز می‌شوند؛ سایر کاراکترها می‌توانند شامل اعداد و پرانتز باشند. هر چیز دیگری در بخش مقدار باید درون علامت نقل‌قول قرار گیرد (هنوز امکانی برای درج علامت نقل‌قول دوگانه درون خود مقدار وجود ندارد). این فایل‌ها عموماً حساس به حروف کوچک و بزرگ هستند و ترتیب قرارگیری بخش‌ها اهمیت دارد. .PP در صورت وجود فایل پیکربندی کاربر، این فایل به‌طور کامل استفاده می‌شود و هیچ ادغامی با فایل پیکربندی سیستم رخ نخواهد داد. .PP در حال حاضر دو بخش وجود دارد: .SS shortcut میان‌برها نگاشتی بین نام‌های کوتاهی که برای نام‌گذاری راحت‌تر نگاشت‌ها در ابزارهای خط فرمان و رابط گرافیکی به کار می‌روند و نام‌های کامل نگاشت کلید XKB تعریف می‌کنند. نام نگاشت کلید XKB از یک مسیر نسبی به یک فایل (که اغلب فاقد بخش دایرکتوری است) و نام یک نگاشت درون پرانتز در همان فایل خاص تشکیل می‌شود. .PP نمونه‌ای از یک بخش میان‌بر که صفحه‌کلیدهای آمریکایی، آلمانی و فرانسوی (از توزیع X11) و اسلواکی (از توزیع .BR xkbsel ) را تعریف می‌کند: .RS .PP .nf [shortcut] us = xfree86(us) de = xfree86(de) fr = xfree86(fr) sk = czsk(sk) .fi .RE .SS mapset میان‌برهای تعریف‌شده در بخش قبلی برای ایجاد یک فهرست گزینش مرتب استفاده می‌شوند که توسط انتخاب‌کننده‌های رابط گرافیکی برای ارائه یک منوی انتخاب به کاربر به کار می‌روند. امکان تعریف فهرست‌ها بر اساس بخش زبان در تعریف محلی (locale) (با حروف کوچک)، بخش منطقه (با حروف بزرگ) و/یا یک فهرست پیش‌فرض در صورت عدم تطابق با هیچ فهرست خاصی وجود دارد. نمونه‌ای از آن: .RS .PP .nf [mapset] map[sk] = sk us map[de] = de us map[fr] = fr us map = us sk de fr .fi .RE .SS "داده‌های اضافی XKB (ADDITIONAL XKB DATA)" فرض بر این است که شما نحوه ایجاد یک نگاشت صفحه‌کلید XKB را می‌دانید. این بخش تنها چگونگی افزودن داده‌های .B xkbsel را به نگاشت‌های جدید و نگاشت‌های موجود در توزیع X توضیح می‌دهد. .PP بسته .B xkbsel ساختار دایرکتوری XKB (که معمولاً در .I /usr/X11R6/lib/X11/xkb قرار دارد) را در دایرکتوری سیستمی .B xkbsel (معمولاً .IR /usr/share/xkbsel ) و در نهایت دایرکتوری کاربر .RI ( ~/.xkbsel ) منعکس می‌کند. .PP تنها دایرکتوری از ساختار اصلی XKB که برای .B xkbsel اهمیت دارد، زیردایرکتوری .I keymap است. این دایرکتوری نقطه شروعی است که بسته در آن به جستجوی نگاشت‌ها پرداخته و آن‌ها را برای کامپایل و نصب به .BR xkbcomp (1) ارسال می‌کند. .PP ابزار .B xkbsel دو دایرکتوری دیگر به این سلسله‌مراتب اضافه می‌کند. دایرکتوری .I redef شامل فایل‌هایی است که بدون نیاز به هیچ‌گونه تغییر در خود نگاشت‌ها، داده‌های اضافی .B xkbsel را به نگاشت‌های تعریف‌شده قبلی اضافه می‌کنند. دایرکتوری .I pixmap حاوی نمادها (آیکون‌ها)ی کوچکی است که می‌توانند توسط ابزارهای رابط گرافیکی ارجاع داده شوند (این قابلیت هنوز پیاده‌سازی نشده است). .PP هنگام وجود داده‌های متناقض، اولویت از بالاترین به پایین‌ترین عبارت است از: .RS ۱. دایرکتوری \fIredef\fR در سلسله‌مراتب کاربر .br ۲. فایل‌های موجود در سلسله‌مراتب کاربر .br ۳. دایرکتوری \fIredef\fR در سلسله‌مراتب \fBxkbsel\fR .br ۴. فایل‌های موجود در سلسله‌مراتب \fBxkbsel\fR .br ۵. توزیع اصلی X11 .RE .PP فایل‌های موجود در دایرکتوری‌های کاربر غیر از .I keymap یا .I redef (مانند .IR symbols ) تنها زمانی استفاده می‌شوند که خود نگاشت در فایلی درون این دو دایرکتوری ذکر شده باشد؛ در غیر این صورت .B xkbsel اطلاعی از آن‌ها نخواهد داشت. .PP داده‌های مربوط به .B xkbsel با استفاده از یادداشت‌ها (کامنت‌ها)ی با قالب‌بندی ویژه در محدوده تعریف نگاشت کلید خاص به فایل‌های XKB اضافه می‌شوند. قالب کامنت به‌صورت زیر است: .RS .PP .nf \fB%xkb_\fIkeyword\fB%\fR \fB"\fIvalue\fB"\fR .fi .RE .PP در حال حاضر دو مدخل از این داده‌ها وجود دارد: .TP .B description توصیفی از نگاشت صفحه‌کلید در ابزارهای رابط گرافیکی تعریف می‌کند .TP .B pixmap یک پیکس‌مپ برای ابزارهای رابط گرافیکی تعریف می‌کند (هنوز پیاده‌سازی نشده است) .PP نمونه‌ای از چنین تعریفی برای نگاشت کلید: .RS .PP .nf 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" }; }; .fi .RE .PP توضیحات می‌توانند از کاراکترهایی در کدگذاری نویسه محلی استفاده کنند، اما به یاد داشته باشید که یک ابزار رابط گرافیکی در یک محلی (locale) خاص اجرا می‌شود و لزوماً تمام توضیحات نگاشت‌های انتخاب‌شده را به‌درستی نمایش نخواهد داد. .PP امکان افزودن این داده‌ها به نگاشت‌های موجود نیز وجود دارد. از آنجا که انجام این کار تنها در چند فایل به‌جای مطابقت دادن فایل‌های بازتعریف با فایل‌های keymap کاربردی‌تر است، این امکان وجود دارد که نام فایل را برای تعاریف بعدی مشخص کرد. این ویژگی فقط برای فایل‌های موجود در دایرکتوری‌های .I redef کاربرد دارد و به‌صورت .RS .PP .nf \fB%xkb_file% "\fIvalue\fB"\fR .fi .RE .PP خارج از تعاریف نگاشت کلید مشخص می‌شود. بنابراین می‌توانید ساختاری مشابه زیر ایجاد کنید: .RS .PP .nf // %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" }; .fi .RE .SH "فایل‌ها (FILES)" .TP .B /usr/X11R6/lib/X11/xkb سلسله‌مراتب XKB در توزیع X11 .TP .B /usr/share/xkbsel دایرکتوری داده‌های سیستم .TP .B /etc/xkbsel.conf فایل پیکربندی سیستم .TP .B ~/.xkbsel دایرکتوری داده‌های کاربر .TP .B ~/.xkbsel/xkbsel.conf فایل پیکربندی کاربر .SH "همچنین ببینید (SEE ALSO)" .BR xkbseldb (1), .BR xkbsel (1), .BR xkbsel-aw (1), .BR xkbsel (5) .SH "نویسنده (AUTHOR)" Stanislav Meduna