'\" t .\" Title: tig .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026-06-13 .\" Manual: Tig Manual .\" Source: Tig 2.6.1 .\" Language: Persian .\" .TH "TIG" "1" "2026\-06\-13" "Tig 2\&.6\&.1" "Tig Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" tig \- رابط حالت متنی برای Git .SH "خلاصه دستور (SYNOPSIS)" .sp .nf tig [options] [revisions] [\-\-] [paths] tig log [options] [revisions] [\-\-] [paths] tig show [options] [revisions] [\-\-] [paths] tig reflog [options] [revisions] tig blame [options] [rev] [\-\-] path tig grep [options] [pattern] tig refs [options] tig stash [options] tig status tig < [Git command output] .fi .sp .SH "توضیحات (DESCRIPTION)" .sp برنامه Tig یک رابط حالت متنی مبتنی بر ncurses برای git(1) است\&. این ابزار عمدتاً به عنوان مرورگر مخزن Git عمل می‌کند، اما می‌تواند در آماده‌سازی تغییرات (staging) برای ثبت (commit) در سطح تکه‌کدها (chunk) نیز کمک کند و به عنوان صفحه‌بند (pager) برای خروجی دستورات گوناگون Git به کار رود\&. .SH "گزینه‌ها (OPTIONS)" .sp گزینه‌های خط فرمان شناخته‌شده توسط Tig شامل تمامی گزینه‌های معتبر git\-log(1) و git\-diff(1)، به همراه زیردستورها و گزینه‌های اختصاصی خودِ Tig است\&. اولین پارامتر خط فرمان که با «\-» آغاز نشود، به عنوان یک مشخصه نسخه (revision) یا یک مسیر تفسیر شده و به تجزیه گزینه‌ها پایان می‌دهد\&. تمام گزینه‌های اضافی به دستور Git زیرین ارسال خواهند شد\&. .sp توجه داشته باشید که این بدان معناست که هرگونه آرگومان مربوط به گزینه‌ها باید به صورت چسبیده مشخص شود\&. به عنوان مثال، به جای tig \-S foo از tig \-Sfoo، و به جای tig \-\-grep foo از tig \-\-grep=foo استفاده کنید؛ در غیر این صورت foo به جای یک آرگومان، به عنوان یک نسخه تفسیر خواهد شد\&. .PP show .RS 4 نمای diff را با استفاده از گزینه‌های ارائه‌شده برای git\-show(1) باز می‌کند\&. .RE .PP blame .RS 4 فایل مشخص‌شده را همراه با حاشیه‌نویسی کامیت‌ها نمایش می‌دهد\&. صفر یا چند گزینه از git\-blame(1) را می‌پذیرد\&. به صورت اختیاری می‌تواند از نسخه (revision) ارائه‌شده محدود شود\&. .RE .PP status .RS 4 در نمای وضعیت (status view) آغاز به کار می‌کند\&. .RE .PP log .RS 4 در نمای لاگ (log view) آغاز به کار کرده و خروجی git\-log(1) را نمایش می‌دهد\&. .RE .PP reflog .RS 4 در نمای reflog آغاز به کار می‌کند\&. .RE .PP refs .RS 4 در نمای refs آغاز به کار می‌کند\&. تمام مرجع‌ها نمایش داده می‌شوند مگر اینکه با استفاده از یکی از پارامترهای \fI\-\-branches\fR، \fI\-\-remotes\fR، یا \fI\-\-tags\fR محدود شده باشند\&. .RE .PP stash .RS 4 در نمای stash آغاز به کار می‌کند\&. .RE .PP grep .RS 4 نمای grep را باز می‌کند\&. از همان گزینه‌های git\-grep(1) پشتیبانی می‌کند\&. .RE .PP + .RS 4 نمای نخست را در حالی که سطر قابل مشاهده و انتخاب شده است نمایش می‌دهد\&. .RE .PP \-v, \-\-version .RS 4 اطلاعات نسخه را نمایش داده و خارج می‌شود\&. .RE .PP \-h, \-\-help .RS 4 پیام راهنما را نمایش داده و خارج می‌شود\&. .RE .PP \-C .RS 4 برنامه را طوری اجرا می‌کند که گویی Tig به جای دایرکتوری کاری فعلی، در مسیر آغاز شده است\&. .RE.SH "حالت صفحه‌بندی (PAGER MODE)" .sp هنگامی که ورودی از طریق stdin فراهم شود، Tig وارد حالت صفحه‌بندی (pager mode) می‌شود و از زیردستورها و گزینه‌های زیر پشتیبانی می‌کند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} هنگامی که زیردستور \fIshow\fR مشخص شده و گزینهٔ \fI\-\-stdin\fR داده شده باشد، فرض می‌شود که stdin فهرستی از شناسه کامیت‌ها است و به دستور git\-show(1) زیربنایی نمای diff فرستاده خواهد شد\&. برای مثال: .RE .sp .if n \{\ .RS 4 .\} .nf $ git rev\-list \-\-author=vivien HEAD | tig show \-\-stdin .fi .if n \{\ .RE .\} .sp .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} هنگامی که \fI\-\-stdin\fR داده شود، فرض می‌شود که stdin فهرستی از شناسه کامیت‌ها است و به دستور git\-log(1) زیربنایی نمای اصلی (main view) فرستاده خواهد شد\&. برای مثال: .RE .sp .if n \{\ .RS 4 .\} .nf $ tig \-\-no\-walk \-\-stdin < cherry\-picks\&.txt .fi .if n \{\ .RE .\} .sp .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} هنگامی که \fI\-\-pretty=raw\fR داده شود، فرض می‌شود که stdin خروجی قالب‌بندی‌شدهٔ \(lqpretty=raw\(rq مشابه با git\-log(1) است\&. برای مثال: .RE .sp .if n \{\ .RS 4 .\} .nf $ git reflog \-\-pretty=raw | tig \-\-pretty=raw .fi .if n \{\ .RE .\} .sp .sp هنگامی که هیچ زیردستور یا گزینه‌ای داده نشود، از نمای صفحه‌بندی (pager view) برای نمایش ورودی دستور Git که روی stdin داده شده است استفاده خواهد شد\&. نمای صفحه‌بندی فرض می‌کند که ورودی یا از git\-log(1) یا از git\-diff(1) است و آن را مشابه با نماهای log و diff برجسته خواهد کرد\&. برای مثال: .sp .if n \{\ .RS 4 .\} .nf $ git log \-Schange \-p \-\-raw | tig .fi .if n \{\ .RE .\} .sp.SH "مثال‌ها (EXAMPLES)" .sp نمایش فهرست کامیت‌های شاخهٔ جاری: .sp .if n \{\ .RS 4 .\} .nf $ tig .fi .if n \{\ .RE .\} .sp .sp نمایش کامیت‌ها از یک یا چند شاخه: .sp .if n \{\ .RS 4 .\} .nf $ tig test master .fi .if n \{\ .RE .\} .sp .sp شبیه‌سازی وضعیتی که گویی تمام ارجاع‌های درون refs/ در خط فرمان فهرست شده‌اند: .sp .if n \{\ .RS 4 .\} .nf $ tig \-\-all .fi .if n \{\ .RE .\} .sp .sp نمایش تفاوت‌های بین دو شاخه: .sp .if n \{\ .RS 4 .\} .nf $ tig test\&.\&.master .fi .if n \{\ .RE .\} .sp .sp نمایش تغییرات نگارش‌های زیرپیمانه (submodule): .sp .if n \{\ .RS 4 .\} .nf $ tig \-\-submodule .fi .if n \{\ .RE .\} .sp .sp نمایش تغییرات یک فایل منفرد: .sp .if n \{\ .RS 4 .\} .nf $ tig \-\- README .fi .if n \{\ .RE .\} .sp .sp نمایش محتوای فایل README در یک بازبینی مشخص: .sp .if n \{\ .RS 4 .\} .nf $ tig show tig\-0\&.8:README .fi .if n \{\ .RE .\} .sp .sp نمایش بازبینی‌های میان دو تاریخ مشخص برای یک فایل: .sp .if n \{\ .RS 4 .\} .nf $ tig \-\-after="2004\-01\-01" \-\-before="2006\-05\-16" \-\- README .fi .if n \{\ .RE .\} .sp .sp ردیابی سطرهای فایل (blame) با فعال‌سازی تشخیص کپی: .sp .if n \{\ .RS 4 .\} .nf $ tig blame \-C README .fi .if n \{\ .RE .\} .sp .sp نمایش فهرست ذخیره‌ها (stashes): .sp .if n \{\ .RS 4 .\} .nf $ tig stash .fi .if n \{\ .RE .\} .sp .sp جستجوی خطوط حاوی DEFINE_ENUM در تمام فایل‌ها: .sp .if n \{\ .RS 4 .\} .nf $ tig grep \-p DEFINE_ENUM .fi .if n \{\ .RE .\} .sp .sp نمایش ارجاع‌ها (شاخه‌ها، ریموت‌ها و برچسب‌ها): .sp .if n \{\ .RS 4 .\} .nf $ tig refs .fi .if n \{\ .RE .\} .sp .sp استفاده از تفاوت کلمه‌ای (word diff) در نمای تفاوت: .sp .if n \{\ .RS 4 .\} .nf $ tig \-\-word\-diff=plain .fi .if n \{\ .RE .\} .sp.SH "محیط (ENVIRONMENT)" .sp علاوه بر متغیرهای محیطی استفاده‌شده توسط Git (مانند GIT_DIR)، Tig متغیرهای زیر را نیز تعریف می‌کند\&. متغیرهای محیطی مرتبط با دستور از طریق متغیرهای جایگزین، مانند %(commit) و %(blob)، به وضعیت داخلی Tig دسترسی دارند\&. برای فهرست کامل به \fBtigrc\fR(5) مراجعه کنید\&. .PP TIGRC_USER .RS 4 مسیر فایل پیکربندی کاربر (پیش‌فرض آن ~/\&.tigrc یا $XDG_CONFIG_HOME/tig/config است)\&. .RE .PP TIGRC_SYSTEM .RS 4 مسیر فایل پیکربندی سراسری سیستم (پیش‌فرض آن {sysconfdir}/tigrc است)\&. برای استفاده از پیکربندی توکار، آن را با رشته‌ای خالی مقداردهی کنید\&. .RE .PP TIG_LS_REMOTE .RS 4 دستوری برای دریافت تمام مرجع‌های مخزن\&. خروجی این دستور باید قالبی یکسان با git\-ls\-remote(1) داشته باشد\&. .RE .PP TIG_DIFF_OPTS .RS 4 گزینه‌های diff برای استفاده در نمای diff\&. نمای diff از git\-show(1) برای قالب‌بندی استفاده می‌کند و همیشه \-\-patch\-with\-stat را ارسال می‌نماید\&. همچنین می‌توانید تنظیم diff\-options را در فایل پیکربندی تعیین کنید\&. .RE .PP TIG_TRACE .RS 4 مسیر فایل ردگیری (trace) که در آن اطلاعات مربوط به دستورهای Git ثبت می‌شوند\&. .RE .PP TIG_SCRIPT .RS 4 مسیر اسکریپتی که باید به‌طور خودکار هنگام راه‌اندازی اجرا شود\&. اگر مقدار این متغیر محیطی روی یک رشته خالی تنظیم شده باشد، اسکریپت از stdin خوانده می‌شود\&. این اسکریپت سطر به سطر تفسیر شده و می‌تواند شامل دستورهای اعلان خط فرمان (prompt) و نگاشت‌های کلید باشد\&. توجه داشته باشید که نویسه \fI<\fR درون اسکریپت باید به‌صورت \fI\fR کدگذاری شود\&. .sp .if n \{\ .RS 4 .\} .nf E\&.g\&. TIG_SCRIPT=<(echo :set main\-view\-commit\-title\-graph = no) tig .fi .if n \{\ .RE .\} .RE .PP TIG_NO_DISPLAY .RS 4 اجرای Tig بدون رندر کردن هیچ‌چیز در ترمینال\&. این متغیر Ncurses را وادار به نوشتن در /dev/null می‌کند\&. کاربرد اصلی آن برای آزمون‌های خودکار Tig است\&. .RE .PP TIG_EDITOR .RS 4 دستور ویرایشگری که هنگام مشاهده فایل‌ها استفاده می‌شود\&. این متغیر محیطی (به ترتیب اولویت) بر \fI$GIT_EDITOR\fR، پیکربندی \fIcore\&.editor\fR، \fI$VISUAL\fR و \fI$EDITOR\fR مقدم است؛ بنابراین امکان استفاده از ویرایشگری متفاوت با ویرایشگر مورداستفاده Git را فراهم می‌کند\&. مقدار این متغیر هنگام استفاده، توسط پوسته (shell) تفسیر می‌شود\&. .RE .SH "فایل‌ها (FILES)" .PP \fI$XDG_CONFIG_HOME/tig/config\fR, \fI~/\&.config/tig/config\fR, \fI~/\&.tigrc\fR .RS 4 فایل پیکربندی کاربر Tig به‌صورت زیر بارگذاری می‌شود\&. اگر $XDG_CONFIG_HOME تنظیم شده باشد، پیکربندی کاربر از $XDG_CONFIG_HOME/tig/config خوانده می‌شود\&. اگر $XDG_CONFIG_HOME خالی یا تعریف‌نشده باشد، پیکربندی کاربر در صورت وجود از ~/\&.config/tig/config خوانده می‌شود و در صورت عدم وجود به ~/\&.tigrc رجوع می‌شود\&. برای مثال‌ها به \fBtigrc\fR(5) مراجعه کنید\&. .RE .PP \fI/etc/tigrc\fR .RS 4 فایل پیکربندی سراسری سیستم\&. .RE .PP \fI$GIT_DIR/config\fR, \fI~/\&.gitconfig\fR, \fI/etc/gitconfig\fR .RS 4 فایل‌های پیکربندی Git\&. هنگام راه‌اندازی به کمک git\-config(1) خوانده می‌شوند\&. .RE .PP \fI$XDG_DATA_HOME/tig/history\fR, \fI~/\&.local/share/tig/history\fR, \fI~/\&.tig_history\fR .RS 4 هنگامی که با پشتیبانی از readline کامپایل شده باشد، Tig تاریخچه‌ای ماندگار از دستورها و جستجوها را ذخیره می‌کند\&. مکان فایل تاریخچه به‌صورت زیر تعیین می‌شود\&. اگر $XDG_DATA_HOME تنظیم شده باشد و $XDG_DATA_HOME/ موجود باشد، در صورت نیاز $XDG_DATA_HOME/tig/ ایجاد شده و تاریخچه در $XDG_DATA_HOME/tig/history ذخیره می‌شود\&. اگر $XDG_DATA_HOME خالی یا تعریف‌نشده باشد، تاریخچه در صورت وجود دایرکتوری ~/\&.local/share/tig/ در ~/\&.local/share/tig/history ذخیره می‌شود، و در صورت عدم وجود به ~/\&.tig_history رجوع می‌شود\&. .RE.SH "گزارش باگ‌ها (BUGS)" .sp لطفاً برای کسب اطلاعات دربارهٔ نسخه‌های جدید و نحوهٔ گزارش باگ‌ها یا درخواست قابلیت‌ها، از \m[blue]\fBصفحهٔ اصلی\fR\m[]\&\s-2\u[1]\d\s+2 Tig دیدن کنید\&. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .sp کپی‌رایت (c) 2006\-2026 Jonas Fonseca <\m[blue]\fBjonas\&.fonseca@gmail\&.com\fR\m[]\&\s-2\u[2]\d\s+2> .sp این برنامه یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط «پروانهٔ عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد؛ نسخهٔ ۲ پروانه، یا (به انتخاب خودتان) هر نسخهٔ بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBtigrc\fR(5), \fBtigmanual\fR(7), git(7) .SH "نکات (NOTES)" .IP " 1." 4 صفحهٔ اصلی .RS 4 \%https://github.com/jonas/tig .RE .IP " 2." 4 jonas.fonseca@gmail.com .RS 4 \%mailto:jonas.fonseca@gmail.com .RE