.Dd September 11, 2024
.Dt XKBCLI\-HOW\-TO\-TYPE 1
.Os
.
.Sh "نام (NAME)"
.Nm "xkbcli\-how\-to\-type"
.Nd جستجوی نحوه تایپ یک نقطه کد یونیکد یا keysym داده‌شده
.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op گزینه‌ها
.Ar character/code point/keysym
.
.Sh "توضیحات (DESCRIPTION)"
.Nm
ترکیب‌های کلید (keycode + کلیدهای تغییردهنده) را در چیدمان‌های keymap که
نقطه کد یونیکد یا keysym مشخص‌شده را تولید می‌کنند، چاپ می‌کند.
.Pp
.Ar code point/keysym
یکی از موارد زیر است:
.
.Bl -bullet -compact
.It
یک نویسه منفرد (نیازمند ترمینالی است که از کدگذاری نویسه UTF-8 استفاده می‌کند)؛
.It
یک نقطه کد یونیکد، که در صورت داشتن پیشوند
.Li 0x
یا
.Li U+
به‌عنوان شانزده‌شانزدهی (هگزادسیمال) و در غیر این صورت به‌عنوان ده‌دهی (دسیمال) تفسیر می‌شود؛
.
.It
یک keysym در صورتی که تفسیرهای قبلی ناموفق باشند یا از
.Fl \-keysym
استفاده شود. در این حالت، این پارامتر یا یک \fIname\fP (نام) keysym است یا یک مقدار \fInumeric\fP (عددی)
(در صورت داشتن پیشوند
.Li 0x
شانزده‌شانزدهی، وگرنه ده‌دهی). توجه داشته باشید که مقادیر
.Li 0
تا
.Li 9
خاص هستند: آن‌ها هم نام و هم
مقدار عددی محسوب می‌شوند. تفسیر پیش‌فرض \fInames\fP است؛ برای تفسیر به‌عنوان مقادیر عددی از قالب شانزده‌شانزدهی
.Li 0x0
تا
.Li 0x9
استفاده کنید.
.El
.
.Sh "مثال‌ها (EXAMPLES)"
.Bl -tag -width Ds
.It Nm Fl \-layout Ar us 97
.It Nm Fl \-layout Ar us 0x61
.It Nm Fl \-layout Ar us U+0061
.It Nm Fl \-layout Ar us a
چاپ ترکیب کلیدهایی که حرف «a»
.Po
نقطه کد ده‌دهی:
.Ar 97 ,
نقطه کد شانزده‌شانزدهی:
.Ar 61
.Pc
را در چیدمان پیش‌فرض
.Ar us
تولید می‌کنند.
.It Nm Fl \-layout Ar us Fl \-keysym Ar 97
.It Nm Fl \-layout Ar us Fl \-keysym Ar 0x61
.It Nm Fl \-layout Ar us Fl \-keysym Ar a
چاپ ترکیب کلیدهایی که keysym با عنوان «a»
.Po
کد ده‌دهی:
.Ar 97 ,
کد شانزده‌شانزدهی:
.Ar 61
.Pc
را در چیدمان پیش‌فرض
.Ar us
تولید می‌کنند.
.El
.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl \-keysym
آرگومان فقط به‌عنوان یک keysym در نظر گرفته شود
.
.It Fl \-disable\-compose
غیرفعال کردن پشتیبانی از Compose
.
.It Fl \-format Ar keymap_format
مشخص کردن قالب keymap (عددی یا برچسب، مثلاً\&
.Dq v1 )
.
.It Fl \-keymap Oo = Ar PATH Oc
بارگذاری keymap مربوط به XKB از یک فایل، نادیده گرفتن گزینه‌های RMLVO. اگر
.Ar PATH
خالی یا
.Dq \-
باشد، از ورودی استاندارد (stdin) خوانده می‌شود.
.
.It Fl \-rules Ar rules
مجموعه قوانین XKB
.
.It Fl \-model Ar model
مدل XKB
.
.It Fl \-layout Ar layout
چیدمان XKB
.
.It Fl \-variant Ar variant
گونه چیدمان XKB
.
.It Fl \-options Ar options
گزینه‌های XKB
.
.It Fl \-enable\-environment\-names
امکان تنظیم مقادیر پیش‌فرض RMLVO از طریق متغیرهای محیطی زیر:
.Bl -dash -compact -hang
.It
.Ev XKB_DEFAULT_RULES
.It
.Ev XKB_DEFAULT_MODEL
.It
.Ev XKB_DEFAULT_LAYOUT
.It
.Ev XKB_DEFAULT_VARIANT
.It
.Ev XKB_DEFAULT_OPTIONS
.El
توجه داشته باشید که این گزینه ممکن است بر مقادیر پیش‌فرض گزینه‌های قبلی تأثیر بگذارد.
.
.It Fl \-verbose
فعال‌سازی خروجی اشکال‌زدایی پرگو (verbose)
.
.It Fl \-help
چاپ یک پیام راهنما و خروج.
.El
.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr xkbcli 1 ,
.Lk https://xkbcommon.org "مستندات برخط libxkbcommon"