\" Enchant configuration man page
\"
\" Copyright (C) 2022-2024 Reuben Thomas
\"
\" This library is distributed in the hope that it will be useful,
\" but WITHOUT ANY WARRANTY; without even the implied warranty of
\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
\" Lesser General Public License for more details.
\"
\" You should have received a copy of the GNU Lesser General Public License
\" along with this program; if not, see <https://www.gnu.org/licenses>.
\"
.TH ENCHANT 5
.SH "نام (NAME)"
enchant \- فایل‌های پیکربندی و نگاشت دیکشنری‌های Enchant
.SH "برچسب‌های زبان (LANGUAGE TAGS)"
برنامه Enchant دیکشنری‌ها را بر اساس برچسب زبان آن‌ها شناسایی می‌کند. برچسب زبان معمولاً یک برچسب زبان IETF BCP 47 به فرم
\fILANGUAGE_COUNTRY\fR
است؛ برای نمونه،
\fIen_US\fR
یا
\fIzh_SG\fR.
می‌توان با ارائه فهرستی جداشده با کاما، از چند دیکشنری به طور همزمان استفاده کرد؛ برای نمونه
\fIen_GB,fr_FR\fR.
این قابلیت می‌تواند برای بررسی متن‌های چندزبانه، یا برای استفاده از فهرست‌های واژگان تخصصی برای یک موضوع، پروژه یا سند خاص سودمند باشد (این موارد ممکن است نام‌هایی مانند
\fIen-medical\fR
یا
\fIen-my-novel\fR
داشته باشند).
.SH "فایل ترتیب‌بندی (ORDERING FILE)"
برنامه Enchant از فایل‌های ترتیب‌بندی سراسری و مخصوص هر کاربر به نام
\fIenchant.ordering\fR
برای تصمیم‌گیری در این مورد که از کدام ارائه‌دهنده غلط‌یابی برای زبان‌های خاص استفاده شود بهره می‌برد.
فایل مخصوص هر کاربر دارای اولویت بالاتر است.
.PP
فایل ترتیب‌بندی ساختاری به صورت
\fIlanguage_tag:<comma-separated list of spelling providers>\fR
دارد.
برای مشاهده دیکشنری‌های موجود، دستور
\fIenchant-lsmod-2\fR
را اجرا کنید. نویسه \(oq*\(cq به معنای «استفاده از این ترتیب‌بندی برای تمامی زبان‌ها، مگر آن‌که خلاف آن مشخص شده باشد» استفاده می‌شود. برای نمونه:
.IP
.nf
*:aspell,hunspell,nuspell
en:aspell,hunspell,nuspell
en_GB:hunspell,nuspell,aspell
fr:hunspell,nuspell,aspell
.fi
.SH "فهرست‌های واژگان شخصی (PERSONAL WORD LISTS)"
فهرست‌های واژگان شخصی فایل‌های متنی ساده‌ای هستند که در هر خط یک واژه دارند.
نام فایل با برچسب زبان آغاز شده و به
\fI.dic\fR
ختم می‌شود.
هر فهرست واژگان شخصی دارای یک فایل استثنا (exclude) متناظر است که به
\fI.exc\fR
ختم می‌شود و واژه‌هایی را فهرست می‌کند که در دیکشنری وجود دارند اما کاربر می‌خواهد نامعتبر در نظر گرفته شوند.
این فایل‌ها در دایرکتوری پیکربندی Enchant ذخیره می‌شوند؛ بخش
.B "فایل‌ها و پوشه‌ها (FILES AND DIRECTORIES)"
را در ادامه ببینید.
خطوطی که با علامت هش \(oq#\(cq آغاز می‌شوند نادیده گرفته می‌شوند.
.SS "اشتراک‌گذاری فهرست‌های واژگان شخصی میان غلط‌یاب‌های املایی (SHARING PERSONAL WORD LISTS BETWEEN SPELL-CHECKERS)"
اشتراک‌گذاری فهرست‌های واژگان شخصی Enchant با سایر غلط‌یاب‌های املایی که از همین فرمت استفاده می‌کنند ممکن و معمولاً بی‌خطر است (توجه داشته باشید که ممکن است سایر غلط‌یاب‌های املایی از کامنت‌ها پشتیبانی نکنند!). غلط‌یاب‌های املایی که سازگاری آن‌ها شناخته شده است عبارتند از Hunspell، Nuspell و Ispell. (اگرچه Enchant از Ispell به عنوان ارائه‌دهنده پشتیبانی نمی‌کند، اما اشتراک‌گذاری فهرست‌های واژگان با آن بدون مشکل است.)
سایر غلط‌یاب‌های املایی پشتیبانی‌شده توسط Enchant یا ناسازگار هستند، یا هیچ سازوکاری برای فهرست واژگان شخصی ندارند. همچنین ممکن است غلط‌یاب‌های املایی دیگری نیز وجود داشته باشند که برای Enchant ناشناخته هستند اما از همین فرمت استفاده می‌کنند.
.PP
برخی از برنامه‌ها از Hunspell یا Nuspell استفاده می‌کنند، اما فهرست واژگان شخصی را تحت نام دیگری یا در مکان دیگری ذخیره می‌کنند؛ مانند فایرفاکس (Firefox) و تاندربرد (Thunderbird). همچنین به نظر می‌رسد فایرفاکس هنگام به‌روزرسانی فهرست واژگان خود، ترتیب آن را تغییر می‌دهد؛ این مورد نیز مشکلی ایجاد نمی‌کند، زیرا خروجی همچنان در همان فرمت باقی می‌ماند.
.PP
برای اشتراک‌گذاری فهرست‌های واژگان با Enchant، فایل فهرست واژگان غلط‌یاب املایی دیگر را پیدا کنید، برای نمونه
\fI~/.hunspell_fr_FR\fR
یا
\fI~/.config/nuspell/fr_FR\fR،
و آن را با فایل متناظر در Enchant ادغام نمایید، که در این مورد
\fI~/.config/enchant/fr_FR.dic\fR
است. از دستور زیر استفاده کنید و
\fIENCHANT-DICT\fR
و
\fIOTHER-DICT\fR
را با نام فایل‌های دیکشنری متناظر جایگزین کنید:
.IP
.nf
cat ENCHANT-DICT OTHER-DICT | sort -u > merged.txt
.fi
.PP
فایل
\fImerged.txt\fR
را بررسی کنید تا مطمئن شوید که ادغام به درستی انجام شده است، سپس:
.IP
.nf
mv merged.txt ENCHANT-DICT
rm OTHER-DICT
ln -s OTHER-DICT ENCHANT-DICT
.fi
.PP
تا فایل دیکشنری دیگر با پیوندی به دیکشنری Enchant جایگزین شود؛ در اینجا نیز نام فایل‌های دیکشنری را جایگزین نمایید.
.SH "محیط (ENVIRONMENT)"
متغیرهای زیر بر رفتار Enchant تأثیر می‌گذارند:
.TP
\fIENCHANT_CONFIG_DIR\fR
پوشه‌ای که Enchant در آن باید به دنبال فایل‌های پیکربندی بگردد. در ادامه توضیح داده شده است.
.TP
\fIG_MESSAGES_DEBUG\fR
برنامه Enchant از توابع ثبت گزارش (log) کتابخانه GLib با دامنه
\fIlibenchant\fR
برای خروجی دادن پیام‌های مفید در اشکال‌زدایی استفاده می‌کند. تنظیم
\fIG_MESSAGES_DEBUG\fR
روی
\fIlibenchant\fR
باعث می‌شود Enchant پیام‌های اشکال‌زدایی را به خطای استاندارد (stderr) ارسال کند. برای جزئیات بیشتر به مستندات GLib مراجعه کنید.
.SH "فایل‌ها و پوشه‌ها (FILES AND DIRECTORIES)"
برنامه Enchant برای یافتن فایل‌های کاربر، مکان‌های زیر را به ترتیب کاهش اولویت بررسی می‌کند:
.TP
\fIENCHANT_CONFIG_DIR\fR
(در صورتی که متغیر محیطی تنظیم شده باشد.)
.TP
\fIXDG_CONFIG_HOME/enchant\fR (سیستم‌های غیر ویندوزی)
پیش‌فرض: \fI~/.config/enchant\fR
.TP
\fICSIDL_LOCAL_APPDATA\\enchant\fR (سیستم‌های ویندوز)
پیش‌فرض: \fIC:\\Documents and Settings\\\fRusername\fI\\Local Settings\\Application Data\\enchant
.PP
دیکشنری‌های مربوط به برخی از ارائه‌دهندگان در یک زیرپوشه هم‌نام با آن ارائه‌دهنده جستجو می‌شوند، برای نمونه
\fI~/.config/enchant/hunspell\fR.
در حال حاضر این سازوکار برای Hspell، Hunspell، Nuspell و Voikko کار می‌کند.
.PP
ارائه‌دهندگان همچنین در پوشه‌های سیستمی خاص، و در برخی موارد در پوشه‌های کاربر به دنبال دیکشنری‌های خود می‌گردند؛ به مستندات هر ارائه‌دهنده مراجعه فرمایید.
.PP
علاوه بر این، Enchant در پوشه‌های سیستمی زیر به دنبال فایل‌های ترتیب‌بندی می‌گردد:
.TP
\fI/etc/enchant-2\fR
(یا مکان معادل نسبت به کتابخانه enchant برای ساخت‌های با قابلیت جابه‌جایی.)
.TP
\fI/usr/share/enchant-2\fR
(یا مکان معادل نسبت به کتابخانه enchant برای ساخت‌های با قابلیت جابه‌جایی.)
.SH "همچنین ببینید (SEE ALSO)"
.BR enchant-2 (1),
.BR enchant-lsmod-2 (1)
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Dom Lachowicz و Reuben Thomas.