.TH filetypes.conf 5 "2019-03-12" "Andre Simon" "user documentation"

.SH "نام (NAME)"
filetypes.conf \- فایل پیکربندی نگاشت انواع فایل و زبان‌ها در Highlight

.SH "توضیحات (DESCRIPTION)"
این فایل پیکربندی شامل پسوندهای نام فایل و الگوهای شِبنگ (shebang) است که به تعاریف نحو (سینتکس) در highlight نگاشت شده‌اند.
.PP
اگر برای یک زبان تنها یک پسوند وجود داشته باشد، کافی است نام فایل lang متناسب با آن پسوند نام‌گذاری شود و نیازی به تعریف ورودی در این فایل نخواهد بود.
.PP
ورودی‌های نوع فایل در
.I gui_files/ext/fileopenfilter.conf
نیز باید به‌روزرسانی شوند.
.PP
پسوندها را می‌توان برای چندین زبان مختلف پیکربندی کرد (به عنوان مثال
.B "asm"
را ببینید که هم به assembler و هم به fasm اختصاص یافته است).
.PP
نسخه‌های خط فرمان (CLI) و رابط گرافیکی (Qt GUI) با تخصیص‌های مبهم و چندگانه به شرح زیر رفتار می‌کنند:
.PP
\- در CLI: اولین نگاشت فهرست‌شده در این فایل استفاده خواهد شد
.PP
\- در GUI: اعلانی برای انتخاب سینتکس به کاربر نمایش داده می‌شود
.PP
اگر فایلی طبق عرف پسوندی نداشته باشد (مانند makefile)، با این حال می‌توان آن را به این فایل اضافه کرد یا به عنوان "Shebang" پیکربندی نمود.
.PP
.B محل قرارگیری:
اولین فایل
.B filetypes.conf
که در دایرکتوری‌های جستجوی highlight یافت شود، اولویت داشته و اعمال می‌شود.
.PP
ارتقا و گسترش پایگاه داده زبان‌های برنامه‌نویسی و تم‌های رنگی highlight به سادگی امکان‌پذیر است.
برای اطلاعات بیشتر به فایل README مراجعه کنید.

.SH "مثال نگاشت پسوند (EXTENSION MAPPING EXAMPLE)"
.IP "{ Lang=\(aqpurebasic\(aq,  Extensions={\(aqpb\(aq, \(aqpbi\(aq} }"

.SH "مثال نگاشت شِبنگ (SHEBANG MAPPING EXAMPLE)"
.IP "{ Lang=\(aqxml\(aq, Shebang=[[^\es*<\e?xml\es+version=\(aq1\.0\(aq\es+[^(\e?>)]*?>\es*$]] }"

.SH "نویسندگان (AUTHORS)"
Andre Simon <as@andre-simon.de>

.SH "همچنین ببینید (SEE ALSO)"
صفحه راهنمای
.BR highlight (1)