.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.\" Define macros
.de Vb \" Begin verbatim text                                                                                                                                                       
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.TH LNAV "1" "April 2024"
.SH "نام (NAME)"
lnav \- نمایشگر فایل لاگ برای ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
.B lnav 
[گزینه‌ها] [logfile1 logfile2 ...]
.SH "توضیحات (DESCRIPTION)"
برنامه Logfile Navigator یا lnav، یک نمایشگر فایل لاگ برای محیط ترمینال است.
با دریافت مجموعه‌ای از فایل‌ها یا دایرکتوری‌ها، lnav کارهای زیر را انجام می‌دهد:
.TP
\- در صورت نیاز، آن‌ها را از حالت فشرده خارج می‌کند؛
.TP
\- فرمت (قالب) آن‌ها را تشخیص می‌دهد؛
.TP
\- فایل‌ها را بر اساس زمان با یکدیگر ادغام کرده و در یک نمای واحد نمایش می‌دهد؛
.TP
\- فایل‌ها را به‌صورت زنده دنبال می‌کند (tail)، تغییر نام‌ها را پیگیری کرده و فایل‌های جدید را در دایرکتوری‌ها پیدا می‌کند؛
.TP
\- نمایه‌ای از خطاها و هشدارها ایجاد می‌کند؛
.TP
\- خطوط JSON را به‌صورت خوانا و زیبا (pretty-print) قالب‌بندی می‌کند.
.SH "کلیدهای میان‌بر (KEY BINDINGS)"
.TP
?
مشاهده یا خروج از متن راهنمای آنلاین.
.TP
q
خروج از برنامه.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR
چاپ راهنما و خروج.
.TP
\fB\-H\fR
نمایش متن راهنمای داخلی.
.TP
\fB\-I\fR path
افزودن دایرکتوری پیکربندی مشخص‌شده به مسیر جستجو.
.TP
\fB\-W\fR
چاپ هشدارهای مربوط به پیکربندی lnav.
.TP
\fB\-u\fR
به‌روزرسانی فرمت‌های نصب‌شده از مخازن git.
.TP
\fB\-d\fR file
نوشتن پیام‌های اشکال‌زدایی (debug) در فایل مشخص‌شده.
.TP
\fB\-V\fR
چاپ اطلاعات نسخه.
.TP
\fB\-r\fR
بارگذاری بازگشتی فایل‌ها از دایرکتوری‌های مشخص‌شده.
.TP
\fB\-R\fR
بارگذاری فایل‌های لاگ چرخش‌یافته (rotated) قدیمی‌تر.
.TP
\fB\-c\fR cmd
اجرای یک دستور پس از بارگذاری کامل فایل‌ها.
.TP
\fB\-f\fR path
اجرای دستورات موجود در فایل مشخص‌شده.
.TP
\fB\-e\fR cmd
اجرای یک خط‌فرمان شل (shell).
.TP
\fB\-t\fR
افزودن برچسب‌های زمانی به ابتدای خطوط داده‌ای که از ورودی استاندارد خوانده می‌شوند.
.TP
\fB\-n\fR
اجرا بدون واسط کاربری curses (حالت بدون سر یا headless).
.TP
\fB\-N\fR
در صورتی که هیچ فایلی تعیین نشود، فایل syslog پیش‌فرض باز نشود.
.TP
\fB\-q\fR
حالت بی‌صدا. پس از اجرای تمام دستورات، پیام‌های لاگ چاپ نشوند.
.SS "آرگومان‌های اختیاری (Optional arguments):"
.TP
logfile1
فایل‌های لاگ یا دایرکتوری‌ها جهت مشاهده. اگر یک دایرکتوری داده شود، تمامی فایل‌های موجود در آن دایرکتوری بارگذاری خواهند شد.
.SH "گزینه‌های حالت مدیریت (MANAGEMENT-MODE OPTIONS)"
.TP
\fB\-i\fR
نصب فایل‌های فرمت ارائه‌شده در دایرکتوری $HOME/.lnav/formats/installed و خروج.
.TP
\fB\-m\fR
تغییر وضعیت به حالت خط‌فرمان مدیریتی. این حالت برای کار با پیکربندی lnav استفاده می‌شود.
.TP
\fB\-C\fR
بررسی پیکربندی و خروج. فایل‌های فرمت لاگ بارگذاری و بررسی خواهند شد. هر فایلی که در خط‌فرمان مشخص شده باشد نیز بارگذاری و بررسی می‌شود تا از تطابق آن با یک فرمت لاگ اطمینان حاصل گردد.
.SH "مثال‌ها (EXAMPLES)"
برای بارگذاری و دنبال کردن فایل syslog:
.PP
.Vb 1
\&    lnav
.Ve
.PP
برای بارگذاری تمامی فایل‌های موجود در مسیر /var/log:
.PP
.Vb 1
\&    lnav /var/log
.Ve
.PP
برای مشاهده خروجی دستور make به همراه برچسب‌های زمانی اضافه‌شده در ابتدای سطرها:
.PP
.Vb 1
\&    make 2>&1 | lnav \-t
.Ve
.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Salvatore Bonaccorso <carnil@debian.org> برای سیستم دبیان (Debian) نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).