.Dd June 4, 2024
.Dt XKBCLI\-COMPILE\-KEYMAP 1
.Os
.
.Sh "نام (NAME)"
.Nm "xkbcli\-compile\-keymap"
.Nd کامپایل یک نگاشت کلید X Keyboard
.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar options
.Op Ar KEYMAP_PATH
.
.Sh "توضیحات (DESCRIPTION)"
.Nm
بر اساس گزینه‌های داده‌شده، یک نگاشت کلید را کامپایل و چاپ می‌کند.
.
.Bl -tag -width Ds
.It Ar KEYMAP_PATH
مسیر فایل نگاشت کلید، یا
.Dq \-
برای خواندن از ورودی استاندارد (stdin)
.
.It Fl \-help
چاپ راهنما و خروج
.
.It Fl \-verbose
فعال‌سازی خروجی اشکال‌زدایی پرگو (verbose)
.
.It Fl \-test
آزمایش و بررسی کامپایل بدون چاپ نگاشت کلید
.
.It Fl \-rmlvo
چاپ کامل RMLVO با پر کردن مقادیر پیش‌فرض برای عناصر ناموجود، در قالب YAML
.
.It Fl \-kccgst
چاپ نگاشت کلیدی که به جای نگاشت کلید کامل، تنها شامل نام‌های مؤلفه KcCGST است
.
.It Fl \-kccgst-yaml
چاپ نام‌های مؤلفه KcCGST در قالب YAML.
.
.It Fl \-modmaps
چاپ نگاشت کلیدهای (modmaps) واقعی و مجازی و کدگذاری‌های کلید تبدیل (modifier) در قالب YAML.
.
.It Fl \-include Ar PATH
افزودن مسیر داده‌شده به فهرست مسیرهای include.
این گزینه به ترتیب وابسته است؛ مسیرهای include که زودتر بیایند، زودتر جستجو می‌شوند.
اگر یک مسیر include مشخص شود، فهرست پیش‌فرض مسیرهای include استفاده نخواهد شد.
برای افزودن مسیرهای پیش‌فرض include از
.Fl \-include\-defaults
استفاده کنید.
.
.It Fl \-include\-defaults
افزودن مجموعه پیش‌فرض دایرکتوری‌های include.
این گزینه به ترتیب وابسته است؛ مسیرهای include که زودتر بیایند، زودتر جستجو می‌شوند.
.
.It Fl \-input\-format Ar keymap_format
قالب نگاشت کلید (عددی یا برچسبی، مانند\&
.Dq v1 )
برای تجزیه (parsing)
.
.It Fl \-output\-format Ar keymap_format
قالب نگاشت کلید (عددی یا برچسبی، مانند\&
.Dq v1 )
برای سریال‌سازی (serializing)
.
.It Fl \-format Ar keymap_format
قالب نگاشت کلید (عددی یا برچسبی، مانند\&
.Dq v1 )
هم برای تجزیه و هم برای سریال‌سازی
.
.It Fl \-no\-pretty
غیرفعال‌سازی زیباسازی چاپ (pretty-printing) برای سریال‌سازی نگاشت کلید.
.
.It Fl \-drop\-unused
غیرفعال‌سازی سریال‌سازی بیت‌های بلااستفاده.
.
.It Fl \-keymap Oo Ar PATH Oc , Fl \-from\-xkb Oo Ar PATH Oc
بارگذاری نگاشت کلید XKB از یک فایل و نادیده گرفتن گزینه‌های RMLVO. اگر
.Ar PATH
خالی یا
.Dq \-
باشد، از stdin خوانده می‌شود.
.
.It Fl \-rules Ar rules
مجموعه قوانین (ruleset) مربوط به XKB
.
.It Fl \-model Ar model
مدل (model) مربوط به XKB
.
.It Fl \-layout Ar layout
طرح‌بندی (layout) مربوط به XKB
.
.It Fl \-variant Ar variant
گونه (variant) طرح‌بندی XKB
.
.It Fl \-options Ar options
گزینه‌های (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
توجه داشته باشید که این گزینه ممکن است بر مقادیر پیش‌فرض گزینه‌های پیشین تأثیر بگذارد.
.
.El
.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr xkbcli 1 ,
.Lk https://xkbcommon.org "مستندات برخط libxkbcommon"