.TH "BATGREP" 1
.SH "نام (NAME)"
batgrep \- جستجو در پروندهها از طریق ripgrep و نمایش نتایج با bat
.SH "توضیحات (DESCRIPTION)"
.P
جستجو در میان پرونده‌ها یا دایرکتوری‌ها برای یافتن عبارات باقاعده منطبق (یا رشته‌های ثابت با \fR\fI-F\fR)، و چاپ خروجی با استفاده از \fR\fIbat\fR برای تجربه‌ای آسان با قابلیت برجسته‌سازی نحوی (syntax highlighting).
.SH "روش استفاده (USAGE)"
.P
    batgrep [گزینه‌ها] الگو [مسیر...]
.SH "گزینه‌ها (OPTIONS)"
.TS
tab(|) box;
| cB | cB | cB |
| _ | _ | _ |
| l0 |1 l |.
 کوتاه | بلند | توضیحات 
||
.SP
 \fR\fI-i\fR | \fR\fI--ignore-case\fR | استفاده از جستجوی بدون حساسیت به حروف کوچک و بزرگ. 
 \fR\fI-s\fR | \fR\fI--case-sensitive\fR | استفاده از جستجوی حساس به حروف کوچک و بزرگ. 
 \fR\fI-S\fR | \fR\fI--smart-case\fR | استفاده از جستجوی هوشمند به بزرگی و کوچکی حروف (smart case). 
 \fR\fI-A\fR | \fR\fI--after-context=[LINES]\fR | نمایش \fR\fIn\fR خط بعدی پس از خط منطبق. 
 \fR\fI-B\fR | \fR\fI--before-context=[LINES]\fR | نمایش \fR\fIn\fR خط قبلی پیش از خط منطبق. 
 \fR\fI-C\fR | \fR\fI--context=[LINES]\fR | ترکیبی از \fR\fI--after-context\fR و \fR\fI--before-context\fR. 
 \fR\fI-p\fR | \fR\fI--search-pattern\fR | دستور به صفحه‌بند (pager) برای جستجوی \fR\fIPATTERN\fR. صفحه‌بندهای پشتیبانی‌شده فعلی: \fR\fIless\fR. 
  | \fR\fI--no-follow\fR | عدم دنبال کردن پیوندهای نمادین (symlinks). 
  | \fR\fI--no-snip\fR | تزیین \fR\fIsnip\fR نمایش داده نشود. این مورد هنگامی که \fR\fI--context=0\fR باشد یا نگارش \fR\fIbat --version\fR کمتر از \fR\fI0.12.x\fR باشد، به طور خودکار فعال است. 
  | \fR\fI--no-highlight\fR | برجسته نکردن خطوط منطبق. این مورد هنگامی که \fR\fI--context=0\fR باشد به طور خودکار فعال است. 
  | \fR\fI--color\fR | اجبار خروجی رنگی. 
  | \fR\fI--no-color\fR | غیرفعال‌سازی اجباری خروجی رنگی. 
  | \fR\fI--paging=["never"/"always"]\fR | فعال/غیرفعال کردن صفحه‌بندی (paging). 
  | \fR\fI--pager=[PAGER]\fR | تعیین صفحه‌بند مورد استفاده. 
  | \fR\fI--terminal-width=[COLS]\fR | تولید خروجی برای عرض مشخص‌شده ترمینال. 
  | \fR\fI--no-separator\fR | غیرفعال کردن چاپ جداکننده میان پرونده‌ها. 
  | \fR\fI--rga\fR | استفاده از \fR\fIripgrep-all\fR به‌جای \fR\fIripgrep\fR. 
.TE

.P
گزینه‌های زیر مستقیماً به ripgrep فرستاده می‌شوند و توسط این اسکریپت پردازش نمی‌شوند.
.TS
tab(|) box;
| cB | cB | cB |
| _ | _ | _ |
| l0 |1 l |.
 کوتاه | بلند | یادداشت‌ها 
||
.SP
 \fR\fI-F\fR | \fR\fI--fixed-strings\fR |  
 \fR\fI-U\fR | \fR\fI--multiline\fR |  
 \fR\fI-P\fR | \fR\fI--pcre2\fR |  
 \fR\fI-z\fR | \fR\fI--search-zip\fR |  
 \fR\fI-w\fR | \fR\fI--word-regexp\fR |  
  | \fR\fI--one-file-system\fR |  
  | \fR\fI--multiline-dotall\fR |  
  | \fR\fI--ignore\fR / \fR\fI--no-ignore\fR |  
  | \fR\fI--crlf\fR / \fR\fI--no-crlf\fR |  
  | \fR\fI--hidden\fR / \fR\fI--no-hidden\fR |  
 \fR\fI-E\fR | \fR\fI--encoding\fR | این گزینه توسط \fR\fIbat\fR پشتیبانی نمی‌شود، و ممکن است هنگام تلاش برای نمایش کدگذاری‌های پشتیبانی‌نشده اختلال ایجاد کند. 
 \fR\fI-g\fR | \fR\fI--glob\fR |  
 \fR\fI-t\fR | \fR\fI--type\fR |  
 \fR\fI-T\fR | \fR\fI--type-not\fR |  
 \fR\fI-m\fR | \fR\fI--max-count\fR |  
  | \fR\fI--max-depth\fR |  
  | \fR\fI--iglob\fR |  
  | \fR\fI--ignore-file\fR |  
.TE

.SH "هشدارها و نکات (CAVEATS)"
.P
\fR\fBتفاوت‌ها با ripgrep:\fR
.P
- گزینه \fR\fI--follow\fR به طور پیش‌فرض برای \fR\fIbatgrep\fR فعال است.
.P
- تمام گزینه‌های \fR\fIripgrep\fR پشتیبانی نمی‌شوند.