.TH "BATMAN" 1
.SH "نام (NAME)"
batman \- خواندن صفحات راهنمای سیستم (\fR\fIman\fR) با استفاده از \fR\fIbat\fR به عنوان قالب‌بند صفحه راهنما.
.SH "توضیحات (DESCRIPTION)"
.P
دوران گم کردن خط و جایگاه هنگام خواندن صفحات راهنمای یکنواخت و تک‌رنگ به سر آمده است. با \fR\fIbat\fR و \fR\fIbatman\fR، می‌توانید دستوراتی مانند \fR\fIman ifconfig\fR را با رنگ‌آمیزی زیبای ۲۴ بیتی و برجسته‌سازی نحوی (syntax highlighting) مطالعه کنید.
.P
اگر \fR\fIfzf\fR روی سیستم شما نصب باشد، حتی می‌توانید از \fR\fIbatman\fR برای جستجو در میان صفحات راهنما استفاده نمایید!
.SH "روش استفاده (USAGE)"
.P
    batman [بخش] [ورودی]
.SS "به عنوان جایگزینی برای دستور man"
.P
در پوسته bash:
.P
\fR\fI\fR\fR\fIbash
.br
eval "$(batman --export-env)"
.br
\fR\fI\fR\fR\fI
.P
در پوسته fish:
.P
\fR\fI\fR\fR\fIfish
.br
batman --export-env | source
.br
\fR\fI\fR\fR\fI
.SH "محیط (ENVIRONMENT)"
.TS
tab(|) box;
| cB | cB |
| _ | _ |
| l0 |1 l |.
 متغیر | توضیحات
|
.SP
 \fR\fIMANPAGER\fR | برنامه‌نمایش‌صفحه (pager) مورد استفاده برای \fR\fIbatman\fR را تغییر می‌دهد. این متغیر مانند \fR\fIBAT_PAGER\fR عمل می‌کند، اما تنها بر همین دستور تأثیر می‌گذارد.
.TE

.SH "سفارشی‌سازی (CUSTOMIZATION)"
.SS "تغییر پوسته ظاهری (Theme)"
.P
می‌توانید با تنظیم متغیر محیطی \fR\fIBAT_THEME\fR پیش از فراخوانی \fR\fIbatman\fR، پوسته برجسته‌سازی نحوی آن را تغییر دهید. تابع واسط زیر، پوسته را به \fR\fISolarized (dark)\fR تغییر می‌دهد، بدون اینکه سایر دستورات \fR\fIbat\fR تحت تأثیر قرار گیرند.
.P
\fR\fI\fR\fR\fIbash
.br
batman() {
.br
    BAT_THEME="Solarized (dark)" batman "$@"
.br
    return $?
.br
}
.br
\fR\fI\fR\fR\fI
.SH "هشدارها و نکات (CAVEATS)"
.P
\fR\fBنشان‌ها (پرچم‌ها) برجسته نمی‌شوند:\fR
.P
- این مورد زمانی رخ می‌دهد که پوسته ظاهری \fR\fIbat\fR را از طریق فایل پیکربندی \fR\fIbat\fR یا متغیر محیطی \fR\fIBAT_THEME\fR تغییر دهید. همه پوسته‌ها رنگ‌بندی مربوط به نشان‌ها را ارائه نمی‌دهند و این یک مسئله شناخته‌شده است.
.br
- می‌توانید با قرار دادن آن در تابعی که \fR\fIBAT_THEME\fR را مقداردهی می‌کند، پوسته را برای \fR\fIbatman\fR بازنویسی نمایید.
.br
- پوسته‌های زیر از برجسته‌سازی صفحات man پشتیبانی می‌کنند:
.br
  - \fR\fIMonokai Extended\fR / \fR\fI\fRMonokai Extended Light\fR\fI
.br
  - \fR\fISolarized (dark)\fR / \fR\fISolarized (light)\fR
.SH "قدردانی (ACKNOWLEDGEMENTS)"
.P
با تشکر از @sharkdp و @LunarLambda بابت اشکال‌زدایی و رفع اشکال جهت اجرای صحیح در محیط‌های خاص.