.\" SPDX-License-Identifier: GPL-2.0-or-later
.TH "CHARMAP" "5" "مه ۲۰۲۵" "man-pages" "فایلهای پیکربندی"
.SH "نام (NAME)"
charmap \- فایل توصیف و نگاشت مجموعهنویسه (Character Set)
.SH "توضیحات (DESCRIPTION)"
فایل توصیف مجموعهنویسه (\fIcharmap\fR) تمامی نویسههای موجود و کدگذاری آنها را در یک مجموعهنویسه مشخص تعریف میکند و توسط ابزار localedef برای ایجاد متغیرهای محلی (locale) استفاده میشود.
.BR localedef (1)
میتواند از فایلهای charmap برای ایجاد متغیرهای محلی سازگار با مجموعهنویسههای گوناگون استفاده کند.
.SS "ساختار (Syntax)"
فایل charmap با یک سربرگ آغاز میشود که میتواند شامل کلیدواژههای زیر باشد:
.TP
.RI < code_set_name >
نام نگاشت مجموعهنویسه در ادامه آن میآید.
.TP
.RI < comment_char >
نویسهای در ادامه آن میآید که به عنوان نویسه کامنت (توضیح) برای ادامه فایل استفاده خواهد شد.
مقدار پیشفرض آن علامت هش (#) است.
.TP
.RI < escape_char >
نویسهای در ادامه آن میآید که به عنوان نویسه گریز (escape) برای باقی فایل استفاده میشود تا نویسه‌هایی که باید به شکل ویژه‌ای تفسیر شوند را مشخص کند.
مقدار پیشفرض آن بکاسلش (\[rs]) است.
.TP
.RI < mb_cur_max >
حداکثر تعداد بایتها برای یک نویسه در ادامه آن میآید.
مقدار پیشفرض 1 است.
.TP
.RI < mb_cur_min >
حداقل تعداد بایتها برای یک نویسه در ادامه آن میآید.
این مقدار باید کمتر یا مساوی با
.RI < mb_cur_max >
باشد. در صورت عدم تعیین، مقدار پیشفرض آن
.RI < mb_cur_max >
خواهد بود.
.P
بخش تعریف مجموعهنویسه با کلیدواژه
.I CHARMAP
در ستون اول آغاز میشود.
.P
خطوط بعدی میتوانند یکی از دو فرم زیر را برای تعریف مجموعهنویسه داشته باشند:
.TP
.RI < character >\  byte-sequence\ comment
این فرم دقیقاً یک نویسه و توالی بایتهای آن را تعریف میکند، که درج
.I comment
(توضیح) در آن اختیاری است.
.TP
.RI < character >..< character >\  byte-sequence\ comment
این فرم یک محدوده نویسهای و توالی بایتهای آن را تعریف میکند، که درج
.I comment
(توضیح) در آن اختیاری است.
.P
بخش تعریف مجموعهنویسه با رشته
.IR "END CHARMAP"
پایان مییابد.
.P
بخش تعریف مجموعهنویسه میتواند به صورت اختیاری با بخشی برای تعریف عرض (پهنای) نویسهها دنبال شود.
.P
کلیدواژه
.I WIDTH_DEFAULT
میتواند برای تعیین عرض پیشفرض تمامی نویسههایی که صریحاً فهرست نشدهاند به کار رود.
عرض پیشفرض نویسه 1 است.
.P
بخش عرض برای نویسههای منفرد با کلیدواژه
.I WIDTH
در ستون اول آغاز میشود.
.P
خطوط بعدی میتوانند یکی از دو فرم زیر را برای تعریف عرض نویسهها داشته باشند:
.TP
.RI < character >\  width
این فرم عرض دقیقاً یک نویسه را تعریف میکند.
.TP
.RI < character >...< character >\  width
این فرم عرض را برای تمامی نویسههای موجود در محدوده تعریف میکند.
.P
بخش تعریف عرض با رشته
.IR "END WIDTH"
پایان مییابد.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/share/i18n/charmaps
مسیر معمول پیشفرض فایلهای نگاشت مجموعهنویسه.
.SH "استانداردها (STANDARDS)"
POSIX.2.
.SH "مثال‌ها (EXAMPLES)"
نماد یورو در نگاشت
.I UTF\-8
به صورت زیر تعریف شده است:
.P
.nf
<U20AC>     /xe2/x82/xac EURO SIGN
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR iconv (1),
.BR locale (1),
.BR localedef (1),
.BR locale (5),
.BR charsets (7)