.\" colorit.1 -- 
.\" Created: Tue, 28 Oct 2003 22:19:36 +0200
.\"  by Aleksey Cheusov <vle@gmx.net>

.TH COLORIT 1 "28 Oct 2003" "" ""
.SH "نام (NAME)"
colorit \- اسکریپتی برای نشانه‌گذاری متن ورودی
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.BI colorit " [OPTIONS] [files...]"
.fi
.SH "توضیحات (DESCRIPTION)"
دستور
.B colorit
اسکریپتی برای نشانه‌گذاری متن ورودی و ارسال خروجی به یک صفحه‌نما (به‌طور پیش‌فرض
.I less -r
) یا به خروجی استاندارد (stdout) است.
قوانین نشانه‌گذاری در یک فایل پیکربندی تعریف می‌شوند که توسط یک پیش‌پردازنده (به صورت پیش‌فرض
.I m4
) پالایش می‌گردد.
مقدار HOME برابر با دایرکتوری خانگی شما، با استفاده از گزینهٔ \-D که توسط هر دوی
.I m4
و
.I cpp
پشتیبانی می‌شود، برای پیش‌پردازنده تنظیم شده است.
این اسکریپت می‌تواند برای رنگ‌آمیزی متن به کمک توالی‌های فرار ANSI یا انجام تبدیلات متنی ساده به کار رود و همچنین می‌تواند توسط
.I dict
یا سایر برنامه‌ها به عنوان صفحه‌نما به جای
.I less
استفاده شود. به‌ویژه، خروجی فایل‌های لاگ،
.IR dict ،
.IR cc ،
.I make
یا
.I diff
را می‌توان به آسانی رنگ‌آمیزی کرد و دید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-V " یا " \-\-version
نمایش اطلاعات نسخه.
.TP
.BR \-h " یا " \-\-help
نمایش اطلاعات راهنما.
.TP
.BI \-c " file\fR یا "  \-\-config " file"
مشخص کردن فایل پیکربندی. مقدار پیش‌فرض
.I ~/.coloritrc
یا
.I /etc/dict/colorit.conf
است.
.TP
.BI \-P " pager\fR یا "  \-\-pager " pager"
مشخص کردن یک صفحه‌نما (\- برای هیچ‌کدام). پیش‌فرض
.I less -r
است.
.TP
.BI \-\-pp " preprocessor"
مشخص کردن یک پیش‌پردازنده (\- برای هیچ‌کدام).
.SH "فایل‌ها (FILES)"
.TP
.I ~/.coloritrc
فایل پیکربندی کاربر برای
.B colorit
.TP
.I /etc/dict/colorit.conf
فایل پیکربندی سراسری سیستم برای
.B colorit
.SH "فایل پیکربندی (CONFIG FILE)"
خطوط خالی یا خطوطی که با علامت هش (`#') آغاز می‌شوند نادیده گرفته می‌شوند. تمام خطوط دیگر دارای این ساختار هستند:
.I command arg1 arg2 ... argN.
همهٔ دستورها برای هر خط ورودی، یکی پس از دیگری پردازش می‌شوند.
.br
رشته‌های
.I args
می‌توانند در میان نویسه‌های نقل‌قول دوگانه (دابل‌کوتیشن) محصور شوند.
.br
در حال حاضر، تنها دستور
.I mark
در دسترس است که آرگومان‌های زیر را می‌پذیرد:
.I regexp pre_string post_string
.br
رشته‌های
.I pre_string
و
.I post_string
به ابتدا و انتهای زیررشته‌ای که با عبارت باقاعدهٔ
.I regexp
تطابق یافته است، اضافه می‌شوند.
.SH "گزارش باگ‌ها (BUGS)"
تنها توالی فرار پشتیبانی‌شده در رشته‌های محصور در دابل‌کوتیشن، \\033 است.
.SH "همچنین ببینید (SEE ALSO)"
.BR less (1),
.BR m4 (1),
.BR cpp (1),
.BR dict (1)