'\" t
.\"
.\" === DO NOT EDIT — generated from util/tspin.adoc by util/generate_man_pages.sh ===
.\"
.\"     Title: tspin
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-07-14
.\"    Manual: tailspin
.\"    Source: tailspin 7.0.0
.\"  Language: English
.\"
.TH "TSPIN" "1" "2026-07-14" "tailspin 7.0.0" "tailspin"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
tspin \- ابزاری برای برجسته‌سازی فایل‌های لاگ
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtspin\fP [\fIOPTION\fP].\|.\|. [\fIFILE\fP].\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه tailspin یک ابزار خط فرمانی برای برجسته‌سازی فایل‌های لاگ است.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fI\-f, \-\-follow\fP
.RS 4
دنبال کردن (tail) محتویات فایل.
هنگام استفاده از گزینه \fI\-\-exec\fP همیشه فعال است.
.RE
.sp
\fI\-p, \-\-print\fP
.RS 4
چاپ خروجی در stdout به‌جای مشاهده محتویات در صفحه‌بند \fIless\fP.
در صورت استفاده از stdin همیشه فعال است.
.RE
.sp
\fI\-\-theme\fP \fBPATH\fP
.RS 4
مشخص کردن مسیر فایل پوسته (theme) سفارشی.
در صورت تنظیم نشدن، پیش‌فرض \fBXDG_CONFIG_HOME/tailspin/theme.toml\fP یا \fB~/.config/tailspin/theme.toml\fP است.
در ویندوز، پیش‌فرض \fB%APPDATA%\(rstailspin\(rstheme.toml\fP است.
همچنین می‌تواند از طریق متغیر محیطی \fITAILSPIN_THEME\fP تنظیم شود.
.RE
.sp
\fI\-e, \-\-exec\fP \fBCOMMAND\fP
.RS 4
اجرای دستور و مشاهده خروجی در یک صفحه‌بند.
این دستور سیگنال وقفه (interrupt) را به دام می‌اندازد تا امکان لغو و ازسرگیری حالت دنبال‌کردن در داخل \fIless\fP فراهم باشد.
.sp
.B مثال:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin \-\-exec \*(Aqkubectl logs \-f pod_name\*(Aq
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-highlight\fP \fBCOLOR1\fP:\fIword1,word2,.\|.\|.\fP \fBCOLOR2\fP:\fIword3,word4,.\|.\|.\fP
.RS 4
برجسته‌سازی کلمات ارائه‌شده که با کاما از هم جدا شده‌اند با رنگ مشخص‌شده.
رنگ‌های ممکن عبارتند از black، red، green، yellow، blue، magenta، cyan و white، که می‌توانند به‌صورت اختیاری پیشوند bright_ داشته باشند (مانند bright_red).
.sp
.B مثال:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin logfile.txt \-\-highlight red:error,fail \-\-highlight green:success,ok
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-enable=[HIGHLIGHT_GROUP]\fP
.RS 4
غیرفعال کردن همه گروه‌های برجسته‌سازی به‌جز موارد مشخص‌شده.
فهرستی از گروه‌ها که با کاما از هم جدا شده‌اند.
نمی‌تواند همراه با \fB\-\-disable=[HIGHLIGHT_GROUP]\fP استفاده شود.
گروه‌های ممکن: numbers، urls، emails، pointers، dates، durations، paths، quotes، key\-value\-pairs، uuids، ipv4، processes، json، keywords.
.RE
.sp
\fI\-\-disable=[HIGHLIGHT_GROUP]\fP
.RS 4
غیرفعال کردن گروه‌های برجسته‌سازی مشخص‌شده.
فهرستی از گروه‌ها که با کاما از هم جدا شده‌اند.
نمی‌تواند همراه با \fB\-\-enable=[HIGHLIGHT_GROUP]\fP استفاده شود.
گروه \fIkeywords\fP کلمات کلیدی توکار (بولی‌ها، nullها، سطوح اهمیت لاگ و افعال رایج REST) را کنترل می‌کند؛ کلمات کلیدی موجود در فایل پیکربندی و گزینه \fB\-\-highlight\fP همیشه اعمال می‌شوند.
گروه‌های ممکن: numbers، urls، emails، pointers، dates، durations، paths، quotes، key\-value\-pairs، uuids، ipv4، processes، json، keywords.
.RE
.sp
\fI\-\-extras=[EXTRA]\fP
.RS 4
فعال‌سازی برجسته‌سازهای اضافی.
فهرستی از موارد اضافی که با کاما از هم جدا شده‌اند.
مقادیر ممکن: ipv6، jvm\-stack\-trace.
همچنین می‌تواند از طریق متغیر محیطی \fITAILSPIN_EXTRAS\fP تنظیم شود.
.RE
.sp
\fI\-\-pager\fP \fBCOMMAND\fP
.RS 4
جایگزین کردن دستور صفحه‌بند پیش‌فرض استفاده‌شده توسط tspin.
دستور باید شامل رشته \fI[FILE]\fP باشد که در داخل برنامه با مسیر فایل جایگزین خواهد شد.
.sp
.B مثال:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin logfile.txt \-\-pager "ov \-f [FILE]"
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-completions\fP \fBSHELL\fP
.RS 4
چاپ کامل‌کننده‌های پوسته (shell completions) در stdout.
مقادیر ممکن: bash، elvish، fish، powershell، zsh.
.RE
.sp
\fI\-\-generate\-default\-theme\fP
.RS 4
چاپ پوسته پیش‌فرض در قالب theme.toml در stdout.
تمام مقادیر در خروجی پیش‌فرض هستند: آن را در \fB~/.config/tailspin/theme.toml\fP کپی کرده و سبک‌هایی را که مایل به بازنویسی آن‌ها هستید ویرایش کنید.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fBTAILSPIN_PAGER\fP
.RS 4
متغیر محیطی \fITAILSPIN_PAGER\fP را برای بازنویسی صفحه‌بند پیش‌فرض تنظیم می‌کند.
معادل گزینه \fB\-\-pager\fP است.
دستور باید شامل رشته \fI[FILE]\fP باشد که در داخل برنامه با مسیر فایل جایگزین خواهد شد.
برای مثال، \fI"ov \-f [FILE]"\fP.
.RE
.sp
\fBTAILSPIN_EXTRAS\fP
.RS 4
فهرستی از موارد اضافی جداشده با کاما برای فعال‌سازی به‌صورت پیش‌فرض.
معادل گزینه \fB\-\-extras\fP است.
برای مثال، \fI"jvm\-stack\-trace"\fP یا \fI"ipv6,jvm\-stack\-trace"\fP.
.RE
.sp
\fBTAILSPIN_THEME\fP
.RS 4
مسیر فایل پوسته مورد استفاده.
معادل گزینه \fB\-\-theme\fP است.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBless\fP(1), \fBtail\fP(1)
.SH "درباره (ABOUT)"
.sp
Ben Sadeh (github.com/bensadeh/tailspin)
.sp
تحت مجوز MIT منتشر شده است.