'\" t .\" Title: tigrc .\" 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: English .\" .TH "TIGRC" "5" "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)" tigrc \- پرونده پیکربندی Tig .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fBset\fR \fIvariable\fR \fB=\fR \fIvalue\fR \fBbind\fR \fIkeymap\fR \fIkey\fR \fIaction\fR \fBcolor\fR \fIarea\fR \fIfgcolor\fR \fIbgcolor\fR \fI[attributes]\fR \fBsource\fR \fIpath\fR .fi .sp .SH "توضیحات (DESCRIPTION)" .sp شما می‌توانید با قرار دادن یک گزینه در پرونده ~/\&.tigrc آن را به طور دائمی تنظیم کنید\&. این پرونده از مجموعه‌ای از \fIدستورات\fR تشکیل شده است\&. هر خط از پرونده فقط می‌تواند شامل یک دستور باشد\&. اگر انتهای هر خط با نویسه بک‌اسلش (\fI\e\fR) خاتمه یابد، دستورات می‌توانند در چند خط ادامه یابند\&. .sp علامت هش (\fI#\fR) به عنوان نویسه \fIتوضیحات (کامنت)\fR استفاده می‌شود\&. تمام متن پس از نویسه توضیح تا انتهای خط نادیده گرفته می‌شود\&. می‌توانید از توضیحات برای یادداشت‌گذاری در پرونده مقداردهی اولیه خود استفاده کنید\&. .sp برخی از گزینه‌ها را می‌توان در زمان اجرا از طریق منوی گزینه‌ها دستکاری کرد\&. علاوه بر این، گزینه‌ها را می‌توان با دستور اعلان :toggle یا با وارد کردن دستور پیکربندی در خط فرمان تغییر وضعیت داد\&. .sp در برخی محیط‌ها، پیکربندی کاربر در مکان جایگزین $XDG_CONFIG_HOME/tig/config ذخیره می‌شود\&. برای اختصار، در این سند فقط به ~/\&.tigrc اشاره خواهد شد\&. .SH "پیکربندی گیت (GIT CONFIGURATION)" .sp به عنوان جایگزینی برای استفاده از ~/\&.tigrc، می‌توان گزینه‌های Tig را با قرار دادن آن‌ها در یکی از پرونده‌های پیکربندی گیت (Git) تنظیم کرد که در زمان راه‌اندازی توسط Tig خوانده می‌شوند\&. برای آگاهی از اینکه از چه پرونده‌هایی استفاده کنید، به \fIgit\-config(1)\fR مراجعه نمایید\&. مثال زیر نحو پایه مورد استفاده برای تنظیمات، کلیدها و رنگ‌ها را نشان می‌دهد\&. .sp .if n \{\ .RS 4 .\} .nf [tig] show\-changes = true [tig "color"] cursor = yellow red bold [tig "bind"] generic = P parent .fi .if n \{\ .RE .\} .sp .sp علاوه بر گزینه‌های خاص tig، گزینه‌های گیت زیر نیز از پیکربندی گیت خوانده می‌شوند: .PP \fIcolor\&.*\fR .RS 4 رنگ‌ها برای انواع مختلف رابط کاربری\&. می‌تواند از طریق تنظیم \fIgit\-colors\fR پیکربندی شود\&. .RE .PP \fIcore\&.abbrev\fR .RS 4 طول شناسه کامیت\&. همچنین گزینه \fIid\-width\fR را ببینید\&. .RE .PP \fIcore\&.editor\fR .RS 4 دستور ویرایشگر متن\&. می‌تواند با تنظیم TIG_EDITOR یا GIT_EDITOR بازنویسی شود\&. .RE .PP \fIcore\&.worktree\fR .RS 4 مسیر ریشه درخت کاری (working tree)\&. .RE .PP \fIgui\&.encoding\fR .RS 4 کدگذاری مورد استفاده برای نمایش محتوای فایل\&. .RE .PP \fIi18n\&.commitencoding\fR .RS 4 کدگذاری مورد استفاده برای کامیت‌ها\&. پیش‌فرض UTF\-8 است\&. .RE .SH "دستور SET (SET COMMAND)" .sp تعدادی از متغیرهای انتخابی را می‌توان از طریق دستور set پیکربندی کرد\&. نحو دستور به این صورت است: .sp .if n \{\ .RS 4 .\} .nf \fBset\fR variables \fB=\fR value .fi .if n \{\ .RE .\} .sp .sp از \fB+=\fR برای الحاق مقدار به یک متغیر رشته‌ای استفاده کنید\&. .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf set commit\-order = topo # مرتب‌سازی توپولوژیکی کامیت‌ها set git\-colors = no # عدم خواندن تنظیمات رنگ گیت set horizontal\-scroll = 33% # پیمایش ۳۳٪ از عرض نما set blame\-options = \-C \-C \-C # انتساب خطوط از فایل‌های دیگر set log\-options += \-\-minimal # استفاده از الگوریتم diff کمینه # قرار دادن نام شاخه‌ها درون () و تگ‌ها درون <> set reference\-format = (branch) # پیکربندی ستون‌های نمای blame با استفاده از دستوری که در چند خط ادامه دارد\&. set blame\-view = \e date:default \e author:abbreviated \e committer:abbreviated \e file\-name:auto \e id:yes,color \e line\-number:yes,interval=5 text .fi .if n \{\ .RE .\} .sp .sp یا در پرونده‌های پیکربندی گیت: .sp .if n \{\ .RS 4 .\} .nf [tig] line\-graphics = no # غیرفعال کردن نویسه‌های گرافیکی tab\-size = 8 # تعداد فاصله‌ها به ازای هر تب .fi .if n \{\ .RE .\} .sp .sp نوع متغیرها می‌تواند بولی (bool)، عدد صحیح (int)، رشته (string) یا ترکیبی (mixed) باشد\&. .PP مقادیر بولی معتبر .RS 4 برای تنظیم یک متغیر بولی روی true از "1"، "true" یا "yes" استفاده کنید\&. هر مقدار دیگری متغیر را روی false تنظیم می‌کند\&. .RE .PP مقادیر صحیح معتبر .RS 4 یک عدد صحیح غیرمنفی\&. .RE .PP مقادیر رشته‌ای معتبر .RS 4 یک رشته از نویسه‌ها\&. به صورت اختیاری، از \*(Aq یا " به عنوان جداکننده استفاده کنید\&. .RE .PP مقادیر ترکیبی معتبر .RS 4 این مقادیر ترکیبی از انواع بالا هستند\&. مقادیر معتبر در توضیحات مشخص شده‌اند\&. .RE .SS "متغیرها (Variables)" .sp متغیرهای زیر قابل تنظیم هستند: .PP \fIdiff\-options\fR (string) .RS 4 رشته‌ای جداشده با فاصله از گزینه‌های diff برای استفاده در نمای diff\&. دستور git\-show(1) برای قالب‌بندی استفاده می‌شود و همیشه \-\-patch\-with\-stat را ارسال می‌کند\&. می‌تواند نمایش متادیتای سربرگ کامیت را با ارسال گزینه \-\-format کنترل کند\&. این گزینه هر گزینه‌ای را که در متغیر محیطی TIG_DIFF_OPTS (توضیح داده شده در \fBtig\fR(1)) مشخص شده باشد لغو می‌کند، اما خودش توسط فلگ‌های diff داده‌شده در فراخوانی خط فرمان بازنویسی می‌شود\&. .RE .PP \fIblame\-options\fR (string) .RS 4 رشته‌ای جداشده با فاصله از گزینه‌های پیش‌فرض blame\&. می‌تواند برای تعیین نحوه تشخیص منشأ خطوط به git\-blame(1) استفاده شود\&. این گزینه‌ها زمانی که Tig در حالت blame شروع شده و گزینه‌های blame در خط فرمان به آن داده شود، نادیده گرفته می‌شوند\&. .RE .PP \fIlog\-options\fR (string) .RS 4 رشته‌ای جداشده با فاصله از گزینه‌های پیش‌فرض که باید به دستور git\-log(1) استفاده‌شده توسط نمای log ارسال شوند\&. گزینه‌ها می‌توانند توسط گزینه‌های خط فرمان بازنویسی شوند\&. به صورت داخلی برای لغو تنظیمات سفارشی \(oqpretty\&.format\(cq که نمای log را مختل می‌کنند استفاده می‌شود\&. .RE .PP \fImain\-options\fR (string) .RS 4 رشته‌ای جداشده با فاصله از گزینه‌های پیش‌فرض که باید به دستور git\-log(1) استفاده‌شده توسط نمای main ارسال شوند\&. گزینه‌ها می‌توانند توسط گزینه‌های خط فرمان بازنویسی شوند\&. .RE .PP \fIreference\-format\fR (string) .RS 4 رشته‌ای جداشده با فاصله از رشته‌های قالب‌بندی مورد استفاده برای قالب‌بندی نام‌های ارجاع (refs)\&. نام نوع ارجاع را با نویسه‌هایی که می‌خواهید برای قالب‌بندی استفاده کنید احاطه کنید، به عنوان مثال [tag] و \&. اگر هیچ قالبی برای local\-tag مشخص نشده باشد، قالب tag استفاده می‌شود\&. به طور مشابه، اگر قالبی برای tracked\-remote مشخص نشده باشد، قالب remote استفاده می‌شود، و اگر قالبی برای هر نوع ارجاع دیگری مشخص نشده باشد، قالب branch استفاده می‌شود\&. پیشوند hide: را اضافه کنید تا آن نوع ارجاع نمایش داده نشود، به عنوان مثال hide:remote\&. انواع ارجاع پشتیبانی‌شده عبارتند از: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} head : مقدار فعلی HEAD\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} tag : یک تگ حاشیه‌نویسی‌شده (annotated tag)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} local\-tag : یک تگ سبک (lightweight tag)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} remote : یک مخزن ریموت (دوردست)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} tracked\-remote : ریموت ردیابی‌شده توسط HEAD فعلی\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} replace : یک ارجاع جایگزین‌شده (replaced reference)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} branch : یک شاخه (branch)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} stash : فضای ذخیره موقت (stash)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} note : یادداشت‌ها (Notes)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} prefetch : ارجاع‌های از پیش دریافت شده توسط git maintenance\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} other : هر ارجاع دیگر\&. .RE .RE .PP \fIline\-graphics\fR (mixed) [ascii|default|utf\-8|auto|] .RS 4 نوع نویسه‌های گرافیکی برای رسم خطوط\&. مقدار "auto" در صورت پشتیبانی لوکال از UTF\-8 به معنی "utf\-8" است، و در غیر این صورت "default"\&. .RE .PP \fItruncation\-delimiter\fR (mixed) [utf\-8|] .RS 4 یک نویسه تکی برای رسم در جایی که ستون‌ها کوتاه شده‌اند\&. پیش‌فرض "~" است\&. مقدار ویژه "utf\-8" به نویسه "\&..." ("سه نقطه افقی خط وسط") اشاره دارد\&. .RE .PP \fIhorizontal\-scroll\fR (mixed) .RS 4 بازه پیمایش افقی در هر مرحله\&. می‌تواند به عنوان تعداد ستون‌ها مشخص شود، مثلاً \fI5\fR، یا به عنوان درصدی از عرض نما، مثلاً \fI33%\fR، که حداکثر آن 100% است\&. برای درصدها همیشه اطمینان حاصل می‌شود که حداقل یک ستون پیمایش شود\&. مقدار پیش‌فرض پیمایش \fI50%\fR از عرض نما است\&. .RE .PP \fIgit\-colors\fR (list) .RS 4 فهرستی جداشده با فاصله از جفت‌های "key=value" که در آن کلید نام رنگ گیت و مقدار نام رنگ Tig است، مثلاً "branch\&.current=main\-head" و "grep\&.filename=grep\&.file"\&. برای غیرفعال کردن روی "no" تنظیم کنید\&. .RE .PP \fIshow\-notes\fR (mixed) [|] .RS 4 آیا یادداشت‌ها برای یک کامیت نمایش داده شوند یا خیر\&. هنگام تنظیم روی یک ارجاع یادداشت، آن ارجاع به git show \-\-notes=\& ارسال می‌شود\&. یادداشت‌ها به طور پیش‌فرض فعال هستند\&. .RE .PP \fIshow\-changes\fR (bool) .RS 4 آیا تغییرات مرحله‌بندی‌شده (staged) و مرحله‌بندی‌نشده (unstaged) در نمای اصلی (main) نمایش داده شوند یا خیر\&. .RE .PP \fIshow\-untracked\fR (bool) .RS 4 آیا تغییرات پیگیری‌نشده (untracked) نیز در نمای اصلی نمایش داده شوند یا خیر\&. .RE .PP \fIvertical\-split\fR (mixed) [auto|] .RS 4 آیا نما به صورت افقی یا عمودی تقسیم شود\&. مقدار "auto" (که پیش‌فرض است) به این معنی است که به ابعاد پنجره بستگی دارد\&. مقدار true جهت‌گیری عمودی و false جهت‌گیری افقی را تنظیم می‌کند\&. .RE .PP \fIsplit\-view\-height\fR (mixed) .RS 4 ارتفاع نمای پایین در یک نمایش افقی تقسیم‌شده\&. می‌تواند به عنوان تعداد ردیف‌ها، مثلاً \fI5\fR، یا به عنوان درصدی از ارتفاع نما، مثلاً \fI80%\fR، مشخص شود که حداکثر آن 100% است\&. همیشه اطمینان حاصل می‌شود که نمای کوچک‌تر حداقل چهار ردیف ارتفاع داشته باشد\&. پیش‌فرض \fI67%\fR است\&. .RE .PP \fIsplit\-view\-width\fR (mixed) .RS 4 عرض راست‌ترین نما در یک نمایش عمودی تقسیم‌شده\&. می‌تواند به عنوان تعداد ستون‌ها، مثلاً \fI5\fR، یا به عنوان درصدی از عرض نما، مثلاً \fI80%\fR، مشخص شود که حداکثر آن 100% است\&. همیشه اطمینان حاصل می‌شود که نمای کوچک‌تر حداقل چهار ستون عرض داشته باشد\&. پیش‌فرض \fI50%\fR است\&. .RE .PP \fIstatus\-show\-untracked\-dirs\fR (bool) .RS 4 نمایش محتوای دایرکتوری‌های پیگیری‌نشده در نمای وضعیت (مشابه گزینه git ls\-files \-\-directory)\&. به طور پیش‌فرض فعال است\&. .RE .PP \fIstatus\-show\-untracked\-files\fR (bool) .RS 4 نمایش فایل‌های پیگیری‌نشده در نمای وضعیت (منعکس‌کننده گزینه status\&.showUntrackedFiles گیت)\&. به طور پیش‌فرض فعال است\&. .RE .PP \fItab\-size\fR (int) .RS 4 تعداد فاصله‌ها به ازای هر تب (tab)\&. مقدار پیش‌فرض ۸ فاصله است\&. .RE .PP \fIdiff\-context\fR (int) .RS 4 تعداد خطوط زمینه‌ای که برای diffها نمایش داده می‌شود\&. .RE .PP \fIword\-diff\fR (bool) .RS 4 نمایش diff کلمه‌ای (word diff)\&. فقط حالت متنی ساده پشتیبانی می‌شود\&. به طور پیش‌فرض غیرفعال است\&. .RE .PP \fIdiff\-highlight\fR (mixed) .RS 4 آیا diffها با استفاده از برنامه \fIdiff\-highlight\fR گیت برجسته شوند یا خیر\&. پیش‌فرض false است\&. در صورت تنظیم روی true، برنامه \fIdiff\-highlight\fR استفاده می‌شود، در غیر این صورت مقدار گزینه به عنوان مسیر برنامه در نظر گرفته می‌شود\&. هنگامی که این گزینه فعال است، بخش‌های برجسته‌شده توسط color diff\-add\-highlight و color diff\-del\-highlight کنترل می‌شوند\&. .RE .PP \fIdiff\-indicator\fR (bool) .RS 4 نمایش علامت‌های +/\- در نمای diff\&. به طور پیش‌فرض فعال است\&. .RE .PP \fIignore\-space\fR (mixed) [no|all|some|at\-eol|] .RS 4 نادیده گرفتن تغییرات فاصله‌های خالی در نمای diff\&. به طور پیش‌فرض هیچ تغییر فاصله‌ای نادیده گرفته نمی‌شود\&. تغییر این مقدار به "all"، "some" یا "at\-eol" به ترتیب معادل ارسال "\-\-ignore\-all\-space"، "\-\-ignore\-space" یا "\-\-ignore\-space\-at\-eol" به git diff یا git show است\&. .sp .PP \fBهشدار:\fR هنگامی که ignore\-space روی some، all یا at\-eol تنظیم شده باشد، ممکن است \fBstatus\-update\fR و \fBstatus\-revert\fR هنگام به‌روزرسانی یا بازگرداندن قطعاتی که شامل خطوطی با تغییرات فاصله هستند با شکست مواجه شوند\&. به طور مشابه، \fBstage\-update\-line\fR ممکن است هنگام به‌روزرسانی خطی مجاور خطی با تغییرات فاصله با شکست مواجه شود\&. .RE .PP \fIcommit\-order\fR (enum) [auto|default|topo|date|author\-date|reverse] .RS 4 ترتیب‌بندی کامیت‌ها با استفاده از ترتیب پیش‌فرض (زمانی معکوس)، ترتیب توپولوژیکی، ترتیب تاریخ یا ترتیب معکوس\&. هنگام تنظیم روی "auto" (که پیش‌فرض است)، در صورت فعال بودن گراف کامیت، ترتیب توپولوژیکی به طور خودکار در نمای اصلی استفاده می‌شود\&. در مخازنی با تاریخچه طولانی کامیت‌ها، توصیه می‌شود این گزینه را روی "default" تنظیم کنید تا بارگذاری نمای اصلی سریع‌تر شود\&. .RE .PP \fIignore\-case\fR (enum) [no|yes|smart\-case] .RS 4 نادیده گرفتن بزرگی و کوچکی حروف در جستجوها\&. مقدار "smart\-case" در صورتی که رشته جستجو شامل هیچ حرف بزرگی نباشد بزرگی و کوچکی را نادیده می‌گیرد\&. به طور پیش‌فرض، جستجو به بزرگی و کوچکی حروف حساس است\&. .RE .PP \fImailmap\fR (bool) .RS 4 خواندن نام استاندارد و آدرس‌های ایمیل برای نویسندگان و کامیت‌کنندگان از \&.mailmap\&. به طور پیش‌فرض غیرفعال است\&. به git\-shortlog(1) مراجعه کنید\&. .RE .PP \fIwrap\-lines\fR (bool) .RS 4 شکستن خطوط طولانی (پیچیدن متن)\&. به طور پیش‌فرض، خطوط شکسته نمی‌شوند\&. با شماره‌گذاری خطوط سازگار نیست\&. .RE .PP \fIwrap\-search\fR (bool) .RS 4 چرخش به بالا/پایین نما هنگام جستجو در صورت رسیدن به ابتدا یا انتها\&. به طور پیش‌فرض فعال است\&. .RE .PP \fIfocus\-child\fR (bool) .RS 4 آیا نمای فرزند هنگام باز شدن فوکوس شود یا خیر\&. در صورت غیرفعال بودن، فوکوس در نمای والد باقی می‌ماند و از بارگذاری مجدد نمای فرزند هنگام پیمایش در نمای والد جلوگیری می‌کند\&. به طور پیش‌فرض true است\&. .RE .PP \fIsend\-child\-enter\fR (bool) .RS 4 آیا فشردن کلید "enter" به نمای فرزند ارسال شود، حتی اگر نمای والد فعال باشد یا خیر\&. در صورت غیرفعال بودن، نمای فرزند باید صریحاً فوکوس شود تا کلیدهای "enter" را دریافت کند\&. در عمل فقط زمانی اهمیت دارد که set focus\-child = no\&. به طور پیش‌فرض true است\&. .RE .PP \fIeditor\-line\-number\fR (bool) .RS 4 آیا شماره خط انتخاب‌شده به دستور ویرایشگر ارسال شود یا خیر\&. شماره خط به صورت + قبل از نام فایل ارسال می‌شود\&. مثال: vim +10 tig\&.c .RE .PP \fIhistory\-size\fR (int) .RS 4 اندازه فایل ماندگار ~/\&.tig_history در هنگام کامپایل با پشتیبانی از readline\&. پیش‌فرض 500 است\&. برای غیرفعال کردن روی 0 تنظیم کنید\&. .RE .PP \fImouse\fR (bool) .RS 4 آیا پشتیبانی از ماوس فعال شود یا خیر\&. به طور پیش‌فرض غیرفعال است زیرا انتخاب متن از ترمینال را کمتر شهودی می‌کند\&. در صورت فعال بودن، کلید Shift (یا Option در مک) را برای انتخاب متن نگه دارید\&. پشتیبانی از ماوس مستلزم آن است که خود ncurses از رویدادهای ماوس پشتیبانی کند\&. .RE .PP \fImouse\-scroll\fR (int) .RS 4 بازه پیمایش به بالا یا پایین با استفاده از ماوس\&. پیش‌فرض ۳ خط است\&. پشتیبانی از ماوس مستلزم آن است که ncurses از رویدادهای ماوس پشتیبانی کند و شما پشتیبانی از ماوس را در ~/\&.tigrc با set mouse = true فعال کرده باشید\&. .RE .PP \fImouse\-wheel\-cursor\fR (bool) .RS 4 آیا هنگام استفاده از چرخ ماوس، حرکت مکان‌نما به پیمایش نما ترجیح داده شود یا خیر\&. به طور پیش‌فرض غیرفعال است\&. به خوبی با set mouse\-scroll = 1 ترکیب می‌شود\&. پشتیبانی از ماوس مستلزم آن است که ncurses از رویدادهای ماوس پشتیبانی کند و پشتیبانی از ماوس در ~/\&.tigrc با set mouse = true فعال شده باشد\&. .RE .PP \fIpager\-autoscroll\fR (bool) .RS 4 آیا نمای صفحه‌بندی (pager) هنگام بارگذاری به صورت خودکار پیمایش شود یا خیر\&. مکان‌نما را از آخرین خط خارج کنید تا پیمایش متوقف شود و برای از سرگیری دوباره آن را برگردانید\&. .RE .PP \fIrecurse\-tree\fR (bool) .RS 4 آیا همه فایل‌ها به صورت بازگشتی در نمای درختی نمایش داده شوند یا خیر\&. .RE .PP \fIpgrp\fR (bool) .RS 4 تبدیل tig به سرگروه فرایندها (process\-group leader) هنگام شروع و پاکسازی تمام فرآیندها هنگام خروج\&. به طور پیش‌فرض غیرفعال است\&. اگر از نسخه Zsh متأثر از zsh\-workers/43379 استفاده می‌کنید این گزینه را فعال نکنید\&. دستور xclip را با setsid اجرا کنید تا محتوای کلیپ‌بورد پس از خروج از tig حفظ شود\&. اگر از کمکی git\-credential\-cache استفاده می‌کنید، گزینه credentialCache\&.ignoreSIGHUP را تنظیم کنید\&. .RE .PP \fIstart\-on\-head\fR (bool) .RS 4 شروع با مکان‌نما بر روی کامیت HEAD\&. .RE .PP \fIrefresh\-mode\fR (mixed) [manual|auto|after\-command|periodic|] .RS 4 نحوه بازخوانی نماها را بر اساس تغییرات فایل‌های تحت نظر در مخزن پیکربندی می‌کند\&. هنگامی که روی \fImanual\fR تنظیم شده باشد، هیچ چیزی به طور خودکار بازخوانی نمی‌شود\&. هنگامی که روی \fIauto\fR تنظیم شده باشد، با تشخیص تغییر در نمای دیگر، نماها بازخوانی می‌شوند\&. هنگامی که روی \fIafter\-command\fR تنظیم شود فقط پس از بازگشت از یک دستور خارجی بازخوانی انجام می‌شود\&. هنگامی که روی \fIperiodic\fR تنظیم شود، نماهای قابل مشاهده به صورت دوره‌ای با استفاده از \fIrefresh\-interval\fR بازخوانی می‌شوند\&. .RE .PP \fIrefresh\-interval\fR (int) .RS 4 فاصله بر حسب ثانیه بین بررسی‌های به‌روزرسانی بازخوانی نما هنگامی که \fIrefresh\-mode\fR روی \fIperiodic\fR تنظیم شده باشد\&. .RE .PP \fIfile\-args\fR (args) .RS 4 آرگومان‌های خط فرمان که به فایل‌ها اشاره دارند\&. این موارد با استفاده از git\-rev\-parse(1) فیلتر می‌شوند\&. .RE .PP \fIrev\-args\fR (args) .RS 4 آرگومان‌های خط فرمان که به بازبینی‌ها (revisions) اشاره دارند\&. این موارد با استفاده از git\-rev\-parse(1) فیلتر می‌شوند\&. .RE .SS "تنظیمات نما (View settings)" .sp تنظیمات نما ترتیب و گزینه‌های ستون‌های مختلف یک نما را مشخص می‌کنند\&. هر تنظیم نما انتظار فهرستی جداشده با فاصله از مشخصات ستون‌ها را دارد\&. مشخصات ستون با نوع ستون شروع می‌شود و به صورت اختیاری می‌تواند یک دونقطه (:) و فهرستی از گزینه‌های ستون به دنبال آن بیاید\&. به عنوان مثال، مشخصه ستون زیر یک ستون \fIauthor\fR (نویسنده) را تعریف می‌کند که ایمیل نویسنده را با عرض ثابت ۲۰ نویسه نمایش می‌دهد: author:email,width=20\&. .sp اولین مقدار گزینه در یک مشخصه ستون همیشه گزینه \fIdisplay\fR است\&. هنگامی که هیچ مقداری برای \fIdisplay\fR داده نشود، مقدار \fIyes\fR فرض می‌شود\&. برای گزینه‌های \fIdisplay\fR که انتظار یک مقدار شمارشی دارند، این مقدار به طور خودکار به مقدار شمارشی پیش‌فرض تبدیل می‌شود\&. به عنوان مثال، تنظیم \fIdisplay\fR برای file\-name به طور خودکار به \fIauto\fR تبدیل خواهد شد\&. .sp مشخصات را می‌توان برای یک ستون واحد نیز ارائه داد، به عنوان مثال برای بازنویسی پیش‌فرض‌ها در پرونده tigrc سیستم\&. برای بازنویسی یک ستون واحد، از نام ستون به عنوان پسوند پس از نام تنظیمات نما استفاده کنید، مثلاً main\-view\-date امکان تنظیم تاریخ در نمای اصلی (main) را فراهم می‌کند\&. .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf # فعال کردن هم شناسه و هم شماره خطوط در نمای blame set blame\-view = date:default author:full committer:no file\-name:auto \e id:yes,color line\-number:yes,interval=5 text # تغییر نمای grep به شکلی مشابه با قالب `git grep` set grep\-view = file\-name:yes line\-number:yes,interval=1 text # نمایش اندازه فایل‌ها به صورت واحد set tree\-view = line\-number:no,interval=5 mode author:full committer:no \e file\-size:units date:default id:no file\-name # نمایش شماره خطوط به ازای هر ۱۰ خط در نمای صفحه‌بندی set pager\-view = line\-number:yes,interval=10 text # میان‌برهایی برای تغییر تنظیمات نما برای ستونی که قبلاً تعریف شده است set main\-view\-date = custom set main\-view\-date\-format = "%Y\-%m\-%d %H:%M" set blame\-view\-line\-number = no # استفاده از ترتیب کامیت پیش‌فرض گیت، حتی در صورت فعال بودن گراف کامیت\&. set commit\-order = default .fi .if n \{\ .RE .\} .sp .sp فهرست زیر تنظیمات نمای موجود و انواع ستون‌های پشتیبانی‌شده توسط آن‌ها را نشان می‌دهد: .PP blob\-view, diff\-view, log\-view, pager\-view, stage\-view .RS 4 line\-number, text .RE .PP blame\-view .RS 4 author, committer, date, file\-name, id, line\-number, text .RE .PP grep\-view .RS 4 file\-name, line\-number, text .RE .PP main\-view, reflog\-view .RS 4 author, committer, date, commit\-title, id, line\-number, ref .RE .PP refs\-view .RS 4 author, committer, date, commit\-title, id, line\-number, ref .RE .PP stash\-view .RS 4 author, date, commit\-title, id, line\-number .RE .PP status\-view .RS 4 file\-name, line\-number, status .RE .PP tree\-view .RS 4 author, committer, date, id, file\-name, file\-size, line\-number, mode .RE .sp انواع ستون‌های پشتیبانی‌شده و گزینه‌های مربوط به هر ستون: .PP author, committer .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (mixed) [full|abbreviated|email|email\-user|]: نحوه نمایش نام‌های نویسنده/کامیت‌کننده\&. اگر روی "abbreviated" تنظیم شود، حروف اول نام نویسنده/کامیت‌کننده نمایش داده خواهد شد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون\&. هنگامی که روی مقداری بین ۱ تا ۱۰ تنظیم شود، نام نویسنده/کامیت‌کننده به حروف اول نام او کوتاه می‌شود\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fImaxwidth\fR (int): حداکثر عرض ستون\&. اجازه اندازه‌بندی خودکار محتوا را تا این حد می‌دهد\&. می‌تواند به عنوان تعداد ستون‌ها، مثلاً \fI15\fR، یا به عنوان درصدی از عرض نما، مثلاً \fI20%\fR، مشخص شود که حداکثر آن 100% است\&. .RE .RE .PP commit\-title .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIgraph\fR (mixed) [no|v2|v1]: آیا گراف بازبینی در نمای اصلی هنگام راه‌اندازی نمایش داده شود یا خیر\&. مقدار "v1" به رندر گراف قدیمی اشاره دارد که دقت کمتری دارد اما سریع‌تر است و بنابراین در مخازن بزرگ توصیه می‌شود\&. همچنین گزینه‌های \fIline\-graphics\fR را ببینید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIrefs\fR (bool): آیا ارجاع‌ها (شاخه‌ها، تگ‌ها و ریموت‌ها) در نمای اصلی نمایش داده شوند یا خیر\&. قابل تغییر وضعیت است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIoverflow\fR (bool or int): آیا متنی در عنوان کامیت که از عرض مشخصی فراتر می‌رود برجسته شود یا خیر\&. در صورت تنظیم روی مقدار بولی، برجسته‌سازی با عرض پیش‌فرض ۵۰ نویسه فعال یا غیرفعال می‌شود\&. در صورت تنظیم روی عدد صحیح، مقدار اختصاص‌داده‌شده به عنوان حداکثر عرض نویسه‌ها استفاده می‌شود\&. .RE .RE .PP date .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (mixed) [relative|relative\-compact|custom|default|]: نحوه نمایش تاریخ‌ها\&. اگر روی "relative" یا "relative\-compact" تنظیم شود، از تاریخ نسبی استفاده می‌شود، مثلاً "2 minutes ago" یا "2m"\&. اگر روی "custom" تنظیم شود، قالب رشته strftime(3) مشخص‌شده در گزینه "format" استفاده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIuse\-author\fR (bool): آیا به جای تاریخ کامیت‌کننده، تاریخ نویسنده نمایش داده شود یا خیر\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIlocal\fR (bool): در صورت true بودن، از localtime(3) برای تبدیل به منطقه زمانی محلی استفاده کنید\&. توجه داشته باشید که تاریخ‌های نسبی همیشه از آفست‌های محلی استفاده می‌کنند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIformat\fR (string): رشته قالب برای ارسال به strftime(3) هنگامی که حالت نمایش \fIcustom\fR انتخاب شده باشد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .RE .PP file\-name .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (mixed) [auto|always|]: زمان نمایش نام پرونده‌ها\&. اگر روی "auto" تنظیم شود، نام پرونده‌ها فقط در صورت نیاز نمایش داده می‌شوند، مثلاً هنگام اجرای: tig blame \-C \&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ستون\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fImaxwidth\fR (int): حداکثر عرض ستون\&. اجازه اندازه‌بندی خودکار محتوا را تا این حد می‌دهد\&. می‌تواند به عنوان تعداد ستون‌ها، مثلاً \fI15\fR، یا به عنوان درصدی از عرض نما، مثلاً \fI20%\fR، مشخص شود که حداکثر آن 100% است\&. .RE .RE .PP file\-size .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (mixed) [default|units|]: نحوه نمایش اندازه پرونده‌ها\&. هنگامی که روی "units" تنظیم شود، اندازه‌ها با استفاده از پیشوندهای باینری نمایش داده می‌شوند، مثلاً 12524 بایت به صورت "12\&.2K" نمایش داده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون نام پرونده\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .RE .PP id .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (bool): آیا شناسه‌های کامیت در نمای اصلی نمایش داده شوند یا خیر\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int) : عرض ثابت برای ستون شناسه کامیت\&. در صورت تنظیم نشدن، Tig در صورت وجود از مقدار \fIcore\&.abbrev\fR استفاده خواهد کرد\&. برای نحوه تنظیم \fIcore\&.abbrev\fR به git\-config(1) مراجعه کنید\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوای شناسه‌های reflog (مثلاً ref/stash@{4}) اندازه می‌شود و در غیر این صورت به طور پیش‌فرض ۷ خواهد بود\&. .RE .RE .PP line\-number .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (bool): آیا شماره خطوط نمایش داده شوند یا خیر\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIinterval\fR (int): فاصله بین شماره خطوط\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .RE .PP mode .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (bool): آیا حالت‌های پرونده (دسترسی‌ها/مجوزها) نمایش داده شوند یا خیر\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .RE .PP ref .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (bool): آیا نام ارجاع نمایش داده شود یا خیر\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIwidth\fR (int): عرض ثابت برای ستون\&. هنگامی که روی صفر تنظیم شود، عرض به طور خودکار متناسب با محتوا اندازه می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fImaxwidth\fR (int): حداکثر عرض ستون\&. اجازه اندازه‌بندی خودکار محتوا را تا این حد می‌دهد\&. می‌تواند به عنوان تعداد ستون‌ها، مثلاً \fI15\fR، یا به عنوان درصدی از عرض نما، مثلاً \fI20%\fR، مشخص شود که حداکثر آن 100% است\&. .RE .RE .PP status .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIdisplay\fR (mixed) [no|short|long|]: نحوه نمایش برچسب وضعیت\&. .RE .RE .PP text .RS 4 .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIcommit\-title\-overflow\fR (bool or int): آیا عناوین کامیت که از عرض مشخصی در نمای diff فراتر می‌روند برجسته شوند یا خیر\&. در صورت تنظیم روی مقدار بولی، برجسته‌سازی با عرض پیش‌فرض ۵۰ نویسه فعال یا غیرفعال می‌شود\&. در صورت تنظیم روی عدد صحیح، مقدار اختصاص‌داده‌شده به عنوان حداکثر عرض نویسه‌ها استفاده می‌شود\&. .RE .RE .sp تمام گزینه‌های ستون قابل تغییر وضعیت هستند\&. برای گزینه‌های \fIdisplay\fR، از نام گزینه به عنوان پیشوند همراه با یک خط تیره و نام ستون استفاده کنید\&. مثلاً :toggle author\-display گزینه \fIdisplay\fR را در ستون \fIauthor\fR تغییر وضعیت می‌دهد\&. برای تمام گزینه‌های دیگر از نام ستون به همراه یک خط تیره و سپس نام گزینه به عنوان پسوند استفاده کنید\&. مثلاً :toggle commit\-title\-graph گزینه \fIgraph\fR را در ستون \fIcommit\-title\fR تغییر وضعیت می‌دهد\&. همچنین می‌توانید از منوی گزینه‌ها برای تغییر گزینه‌ها استفاده کنید\&. .SH "دستور BIND (BIND COMMAND)" .sp با استفاده از دستورات bind، کلیدها می‌توانند در صورت فشردن در یک نگاشت کلید معین به یک عملیات نگاشت شوند\&. نحو دستور به این صورت است: .sp .if n \{\ .RS 4 .\} .nf \fBbind\fR \fIkeymap\fR \fIkey\fR \fIaction\fR .fi .if n \{\ .RE .\} .sp .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf # افزودن کلید میانبر برای پرش سریع به قطعه diff بعدی در نمای stage bind stage :/^@@ # غیرفعال کردن نگاشت پیش‌فرض برای اجرای git\-gc bind generic G none # دستور خارجی تعریف‌شده توسط کاربر برای اصلاح آخرین کامیت bind status + !git commit \-\-amend # دستور داخلی تعریف‌شده توسط کاربر برای بارگذاری مجدد ~/\&.tigrc bind generic S :source ~/\&.tigrc # نویسه‌های با کدگذاری UTF8 می‌توانند به عنوان مقادیر کلید استفاده شوند\&. bind generic \(/o @sh \-c "printf \*(Aq%s\*(Aq %(commit) | pbcopy" .fi .if n \{\ .RE .\} .sp .sp یا در پرونده‌های پیکربندی گیت: .sp .if n \{\ .RS 4 .\} .nf [tig "bind"] # لغو انتساب کلید پیش‌فرض خروج generic = Q none # چری‌پیک کامیت فعلی روی شاخه فعلی main = C !git cherry\-pick %(commit) .fi .if n \{\ .RE .\} .sp .sp کلیدها ابتدا با جستجو در کلیدهای میانبر نمای فعلی، سپس کلیدهای میانبر نگاشت کلید \fBgeneric\fR، و در نهایت کلیدهای میانبر پیش‌فرض نگاشت می‌شوند\&. بنابراین، کلیدهای میانبر نما کلیدهای میانبر generic را بازنویسی می‌کنند که خود کلیدهای میانبر توکار را بازنویسی می‌کنند\&. .sp حذف کلید میانبر (unbind) از تمام نگاشت‌های کلید به طور همزمان با دستور bind \fBgeneric\fR \fIkey\fR \fBnone\fR انجام می‌شود\&. .sp کلیدهای میانبر در خط فرمان معمولاً توسط کتابخانه readline اداره می‌شوند و به طور جداگانه در ~/\&.inputrc پیکربندی می‌شوند\&. به \fIreadline(1)\fR مراجعه کنید\&. برنامه Tig بخش $if tig را در ~/\&.inputrc به رسمیت می‌شناسد اما الزامی به وجود آن ندارد\&. .PP نگاشت‌های کلید (Keymaps) .RS 4 نگاشت‌های کلید معتبر عبارتند از: \fBmain\fR, \fBdiff\fR, \fBlog\fR, \fBreflog\fR, \fBhelp\fR, \fBpager\fR, \fBstatus\fR, \fBstage\fR, \fBtree\fR, \fBblob\fR, \fBblame\fR, \fBrefs\fR, \fBstash\fR, \fBgrep\fR و \fBgeneric\fR\&. از \fBgeneric\fR برای تنظیم نگاشت کلید در تمام نگاشت‌های کلید استفاده کنید (که همچنان ممکن است توسط یک کلید میانبر خاص در یک نما بازنویسی شود)\&. از \fBsearch\fR برای تعیین کلیدها جهت پیمایش نتایج جستجو در حین جستجو استفاده کنید\&. .RE .PP مقادیر کلید (Key values) .RS 4 مقادیر کلید هرگز نباید داخل علامت نقل‌قول قرار گیرند\&. از یک نویسه اسکی یا با کدگذاری UTF8 یا یکی از نام‌های کلید نمادین زیر استفاده کنید\&. نام‌های کلید نمادین به بزرگی و کوچکی حروف حساس نیستند و با "<" شروع شده و با ">" پایان می‌یابند\&. از \fB\fR برای اتصال به کلید # استفاده کنید، زیرا علامت هش به عنوان نویسه توضیح استفاده می‌شود\&. از \fB\fR برای اتصال به کلید < استفاده کنید\&. .RE .sp \fB\fR, \fB\fR, \fB\fR, \fB\fR, \fB\fR or \fB\fR, \fB\fR, \fB\fR, \fB\fR, \fB\fR, \fB\fR or \fB\fR, \fB\fR or \fB\fR, \fB\fR, \fB\fR or \fB\fR, \fB\fR, \fB\fR, \fB\fR or \fB\fR, \fB\fR or \fB\fR, \fB\fR or \fB\fR, \fB\fR or \fB\fR, \fB\fR or \fB\fR, \fB\fR, \fB\fR, \fB\fR or \fB\fR, \fB\fR, \fB\fR, \fB\fR, \fB\fR, \fB\fR \&... \fB\fR .sp برای تعریف نگاشت‌های کلید با کلید Ctrl، از استفاده کنید\&. علاوه بر این، ترکیب‌های کلیدی شامل کلید Escape اولیه به همراه یک مقدار کلید عادی را می‌توان با استفاده از key مقید کرد\&. .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf bind main R refresh bind main next bind main scroll\-page\-down bind main o options bind main parent .fi .if n \{\ .RE .\} .sp .sp نکات (Notes) .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برنامه Tig فشردن کلیدها را از طریق ncurses می‌خواند و مشمول محدودیت‌های مختلفی است\&. به \fIncurses(3x)\fR و \fIterminfo(5)\fR (یا termcap) مراجعه کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ctrl\-m و Ctrl\-i نمی‌توانند مقید شوند زیرا به ترتیب با \fIEnter\fR و \fITab\fR تداخل دارند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} تفاوت بزرگی و کوچکی حروف در دنباله‌های کنترلی مانند Ctrl\-f و Ctrl\-F قابل تشخیص نیست\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ctrl\- معمولاً به Ctrl\-@ ترجمه می‌شود که برای مقیدسازی در دسترس است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} تنها زیرمجموعه‌ای از کلیدهای نمادین خاص مانند در هر شبیه‌ساز ترمینال معین در دسترس خواهد بود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} ترکیب Ctrl\-z به طور خودکار برای کنترل فرایند استفاده می‌شود و باعث تعلیق Tig و باز شدن یک زیرپوسته می‌شود (از fg برای ورود مجدد به Tig استفاده کنید)\&. .PP عملیات‌ها (Actions) .RS 4 عملیات‌ها یا به عنوان دستورات تعریف‌شده توسط کاربر (خارجی یا داخلی) یا با استفاده از نام‌های عملیات همان‌طور که در بخش‌های بعدی توضیح داده شده است مشخص می‌شوند\&. .RE .RE .SS "دستورات خارجی تعریف‌شده توسط کاربر (External user\-defined command)" .sp این عملیات‌ها با یک یا چند مورد از فلگ‌های گزینه‌ای زیر شروع می‌شوند که پس از آن‌ها دستور مورد نظر برای اجرا قرار می‌گیرد\&. .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp ! T}:T{ .sp اجرای دستور در پیش‌زمینه همراه با نمایش خروجی\&. T} T{ .sp @ T}:T{ .sp اجرای دستور در پس‌زمینه بدون هیچ خروجی\&. T} T{ .sp + T}:T{ .sp اجرای همگام دستور، و چاپ خط اول خروجی در نوار وضعیت\&. T} T{ .sp ? T}:T{ .sp درخواست تایید از کاربر پیش از اجرای دستور\&. T} T{ .sp < T}:T{ .sp خروج از Tig پس از اجرای دستور\&. T} T{ .sp > T}:T{ .sp بازگشایی مجدد و فوری Tig در آخرین نمای نمایش‌داده‌شده پس از اجرای دستور\&. T} .TE .sp 1 .sp مگر اینکه طور دیگری مشخص شده باشد، دستورات در پیش‌زمینه همراه با نمایش خروجی کنسول اجرا می‌شوند (همانند حالتی که \fI!\fR مشخص شده باشد)\&. هنگامی که چندین گزینه دستور مشخص شده باشند رفتار آن‌ها با یکدیگر ترکیب می‌شود، برای مثال "?\*(Aq قرار دهید\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBمتغیرهای وضعیت مرور (Browsing state variables)\fR .RS 4 .sp دستورات تعریف‌شده توسط کاربر می‌توانند به صورت اختیاری با استفاده از نام‌های متغیر زیر به وضعیت درونی Tig ارجاع دهند، که قبل از اجرای دستورات جایگزین می‌شوند: .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp %(head) T}:T{ .sp شناسه \fIhead\fR که هم‌اکنون مشاهده می‌شود\&. مقدار پیش‌فرض HEAD است\&. T} T{ .sp %(commit) T}:T{ .sp شناسه کامیت انتخاب‌شده فعلی\&. T} T{ .sp %(blob) T}:T{ .sp شناسه blob انتخاب‌شده فعلی\&. T} T{ .sp %(branch) T}:T{ .sp نام شاخه انتخاب‌شده فعلی\&. T} T{ .sp %(remote) T}:T{ .sp نام مخزن دوردست (remote) انتخاب‌شده فعلی\&. برای شاخه‌های دوردست %(branch) حاوی نام شاخه خواهد بود\&. T} T{ .sp %(tag) T}:T{ .sp نام تگ انتخاب‌شده فعلی\&. T} T{ .sp %(refname) T}:T{ .sp نام مرجع انتخاب‌شده فعلی شامل نام مخزن دوردست برای شاخه‌های دوردست\&. T} T{ .sp %(stash) T}:T{ .sp نام stash انتخاب‌شده فعلی\&. T} T{ .sp %(directory) T}:T{ .sp مسیر دایرکتوری جاری در نمای درخت یا "\&." در صورت تعریف‌نشده بودن\&. T} T{ .sp %(file) T}:T{ .sp فایل انتخاب‌شده فعلی\&. T} T{ .sp %(file_old) T}:T{ .sp نام پیشین فایل انتخاب‌شده فعلی\&. T} T{ .sp %(lineno) T}:T{ .sp شماره خط انتخاب‌شده فعلی\&. مقدار پیش‌فرض 0 است\&. T} T{ .sp %(lineno_old) T}:T{ .sp شماره خط انتخاب‌شده فعلی، پیش از اعمال diff\&. مقدار پیش‌فرض 0 است\&. T} T{ .sp %(status) T}:T{ .sp وضعیت استیج خط انتخاب‌شده فعلی\&. T} T{ .sp %(ref) T}:T{ .sp مرجع ارائه‌شده به blame، یا HEAD در صورت تعریف‌نشده بودن\&. T} T{ .sp %(revargs) T}:T{ .sp آرگومان‌های بازبینی (revision) ارائه‌شده در خط فرمان\&. T} T{ .sp %(fileargs) T}:T{ .sp آرگومان‌های فایل ارائه‌شده در خط فرمان\&. T} T{ .sp %(cmdlineargs) T}:T{ .sp تمام گزینه‌های دیگر ارائه‌شده در خط فرمان\&. T} T{ .sp %(diffargs) T}:T{ .sp گزینه‌های حاصل از \fIdiff\-options\fR یا \fITIG_DIFF_OPTS\fR مورد استفاده در نمای diff و stage\&. T} T{ .sp %(blameargs) T}:T{ .sp گزینه‌های حاصل از \fIblame\-options\fR مورد استفاده در نمای blame\&. T} T{ .sp %(logargs) T}:T{ .sp گزینه‌های حاصل از \fIlog\-options\fR مورد استفاده در نمای log\&. T} T{ .sp %(mainargs) T}:T{ .sp گزینه‌های حاصل از \fImain\-options\fR مورد استفاده در نمای main\&. T} T{ .sp %(prompt) T}:T{ .sp درخواست مقدار آرگومان از کاربر\&. به صورت اختیاری می‌توانید با "%(prompt Enter branch name: )" یک اعلان سفارشی تعیین کنید\&. T} T{ .sp %(text) T}:T{ .sp ستون متنی خط انتخاب‌شده فعلی\&. T} T{ .sp %(repo:head) T}:T{ .sp نام شاخه بررسی‌شده (checked out)، برای مثال master T} T{ .sp %(repo:head\-id) T}:T{ .sp شناسه کامیت شاخه بررسی‌شده\&. T} T{ .sp %(repo:remote) T}:T{ .sp نام مخزن دوردست مرتبط با شاخه بررسی‌شده، برای مثال origin\&. T} T{ .sp %(repo:upstream) T}:T{ .sp شاخه بالادست (upstream) مرتبط با شاخه بررسی‌شده، برای مثال origin/master\&. T} T{ .sp %(repo:cdup) T}:T{ .sp مسیر تغییر دایرکتوری به ریشه مخزن، برای مثال \&.\&./ T} T{ .sp %(repo:prefix) T}:T{ .sp پیشوند مسیر دایرکتوری کاری فعلی، برای مثال subdir/\&. T} T{ .sp %(repo:git\-dir) T}:T{ .sp مسیر دایرکتوری گیت، برای مثال /src/repo/\&.git\&. T} T{ .sp %(repo:worktree) T}:T{ .sp مسیر درخت کاری (worktree)، در صورت تعریف شدن\&. T} T{ .sp %(repo:is\-inside\-work\-tree) T}:T{ .sp اینکه آیا Tig درون یک درخت کاری اجرا می‌شود یا خیر (true یا false)\&. T} .TE .sp 1 .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf # ذخیره کامیت فعلی به عنوان یک فایل پچ هنگامی که کاربر یک کامیت را # در نمای اصلی انتخاب کرده و کلید \*(AqS\*(Aq را فشار می‌دهد\&. bind main S !git format\-patch \-1 %(commit) # ایجاد و بررسی یک شاخه جدید؛ همراه با تعیین اعلان سفارشی bind main B ?git checkout \-b "%(prompt Enter new branch name: )" # نمایش آمار کامیت برای نویسنده زیر مکان‌نما bind main U +sh \-c \*(Aqgit \-\-\no\-pager shortlog \-s \-\-\author="$(git show \-s \-\-\format=%aE %(commit))" !git publish .fi .if n \{\ .RE .\} .sp .RE .SS "دستورات داخلی تعریف‌شده توسط کاربر (Internal user\-defined commands)" .sp عملیاتی که با یک \fI:\fR آغاز می‌شوند به عنوان دستورات داخلی اجرا و تفسیر شده و مانند دستورات اجراشده از طریق اعلان خط فرمان Tig عمل می‌کنند\&. دستورات داخلی معتبر شامل گزینه‌های فایل پیکربندی (همان‌طور که در این سند شرح داده شده است) و دستورات نمای صفحه‌بند (pager view) هستند\&. مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf # بارگذاری مجدد ~/\&.tigrc هنگام فشرده شدن \*(AqS\*(Aq bind generic S :source \&.tigrc # تغییر نمای diff برای نمایش تمام تغییرات کامیت بدون در نظر گرفتن محدودیت‌های فایل bind diff F :set diff\-options = \-\-\full\-diff # نمایش خروجی git-reflog(1) در نمای صفحه‌بند bind generic W :!git reflog # جستجو برای تکه (chunk) قبلی diff و سربرگ بعدی diff bind stage 2 :?^@@ bind stage D :/^diff \-\-(git|cc) bind main I :toggle id # نمایش/پنهان‌سازی ستون شناسه (ID) bind diff D :toggle diff\-options \-\-\minimal # استفاده از الگوریتم diff کمینه bind diff [ :toggle diff\-context \-3 # کاهش متن زمینه (آرگومان \-U) bind diff ] :toggle diff\-context +3 # افزایش متن زمینه bind generic V :toggle split\-view\-height \-10% # کاهش ارتفاع نمای دو نیم‌شده .fi .if n \{\ .RE .\} .sp .sp مشابه دستورات خارجی، دستورات نمای صفحه‌بند می‌توانند حاوی نام‌های متغیری باشند که قبل از اجرای دستور جایگزین می‌شوند\&. .SS "نام عملیات‌ها (Action names)" .sp نام‌های معتبر عملیات در ادامه شرح داده شده‌اند\&. توجه داشته باشید که تمامی نام‌های عملیات به حروف بزرگ و کوچک حساس نیستند، و می‌توانید از \fI\-\fR، \fI_\fR و \fI\&.\fR به جای یکدیگر استفاده کنید؛ برای مثال "view\-main"، "View\&.Main" و "VIEW_MAIN" یکسان هستند\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBتعویض نما (View switching)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp view\-main T}:T{ .sp نمایش نمای اصلی (main view) T} T{ .sp view\-diff T}:T{ .sp نمایش نمای diff T} T{ .sp view\-log T}:T{ .sp نمایش نمای لاگ (log view) T} T{ .sp view\-reflog T}:T{ .sp نمایش نمای reflog T} T{ .sp view\-tree T}:T{ .sp نمایش نمای درخت (tree view) T} T{ .sp view\-blob T}:T{ .sp نمایش نمای blob T} T{ .sp view\-blame T}:T{ .sp نمایش نمای blame T} T{ .sp view\-refs T}:T{ .sp نمایش نمای مراجع (refs view) T} T{ .sp view\-status T}:T{ .sp نمایش نمای وضعیت (status view) T} T{ .sp view\-stage T}:T{ .sp نمایش نمای استیج (stage view) T} T{ .sp view\-stash T}:T{ .sp نمایش نمای stash T} T{ .sp view\-grep T}:T{ .sp نمایش نمای grep T} T{ .sp view\-pager T}:T{ .sp نمایش نمای صفحه‌بند (pager view) T} T{ .sp view\-help T}:T{ .sp نمایش نمای راهنما (help view) T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBدستکاری نما (View manipulation)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp enter T}:T{ .sp ورود و باز کردن خط انتخاب‌شده T} T{ .sp back T}:T{ .sp بازگشت به وضعیت قبلی نما T} T{ .sp next T}:T{ .sp رفتن به مورد بعدی T} T{ .sp previous T}:T{ .sp رفتن به مورد قبلی T} T{ .sp parent T}:T{ .sp رفتن به والد T} T{ .sp view\-next T}:T{ .sp انتقال تمرکز به نمای بعدی T} T{ .sp refresh T}:T{ .sp بارگذاری مجدد و نوسازی نما T} T{ .sp maximize T}:T{ .sp بزرگ‌نمایی نمای فعلی به اندازه تمام صفحه T} T{ .sp view\-close T}:T{ .sp بستن نمای فعلی T} T{ .sp view\-close\-no\-quit T}:T{ .sp بستن نمای فعلی بدون خروج از برنامه T} T{ .sp quit T}:T{ .sp بستن تمامی نماها و خروج از برنامه T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBعملیات‌های ویژه نما (View-specific actions)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp status\-update T}:T{ .sp استیج/آن‌استیج کردن تغییرات تکه (chunk) یا فایل T} T{ .sp status\-revert T}:T{ .sp بازگردانی تغییرات تکه (chunk) یا فایل T} T{ .sp status\-merge T}:T{ .sp ادغام فایل با استفاده از ابزار خارجی T} T{ .sp stage\-update\-line T}:T{ .sp استیج/آن‌استیج کردن یک خط منفرد T} T{ .sp stage\-update\-part T}:T{ .sp استیج/آن‌استیج کردن بخشی از یک تکه T} T{ .sp stage\-split\-chunk T}:T{ .sp تقسیم تکه فعلی diff T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBپیمایش مکان‌نما (Cursor navigation)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp move\-up T}:T{ .sp حرکت مکان‌نما یک خط به بالا T} T{ .sp move\-down T}:T{ .sp حرکت مکان‌نما یک خط به پایین T} T{ .sp move\-page\-up T}:T{ .sp حرکت مکان‌نما یک صفحه به بالا T} T{ .sp move\-page\-down T}:T{ .sp حرکت مکان‌نما یک صفحه به پایین T} T{ .sp move\-half\-page\-up T}:T{ .sp حرکت مکان‌نما نیم‌صفحه به بالا T} T{ .sp move\-half\-page\-down T}:T{ .sp حرکت مکان‌نما نیم‌صفحه به پایین T} T{ .sp move\-first\-line T}:T{ .sp حرکت مکان‌نما به خط اول T} T{ .sp move\-last\-line T}:T{ .sp حرکت مکان‌نما به خط آخر T} T{ .sp move\-next\-merge T}:T{ .sp حرکت مکان‌نما به کامیت ادغام بعدی T} T{ .sp move\-prev\-merge T}:T{ .sp حرکت مکان‌نما به کامیت ادغام قبلی T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBپیمایش صفحه (Scrolling)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp scroll\-line\-up T}:T{ .sp پیمایش یک خط به بالا T} T{ .sp scroll\-line\-down T}:T{ .sp پیمایش یک خط به پایین T} T{ .sp scroll\-page\-up T}:T{ .sp پیمایش یک صفحه به بالا T} T{ .sp scroll\-page\-down T}:T{ .sp پیمایش یک صفحه به پایین T} T{ .sp scroll\-half\-page\-up T}:T{ .sp پیمایش نیم‌صفحه به بالا T} T{ .sp scroll\-half\-page\-down T}:T{ .sp پیمایش نیم‌صفحه به پایین T} T{ .sp scroll\-first\-col T}:T{ .sp پیمایش به ستون‌های آغازین خط T} T{ .sp scroll\-left T}:T{ .sp پیمایش دو ستون به چپ T} T{ .sp scroll\-right T}:T{ .sp پیمایش دو ستون به راست T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBجستجو (Searching)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt. T{ .sp search T}:T{ .sp جستجو در نما T} T{ .sp search\-back T}:T{ .sp جستجو به عقب در نما T} T{ .sp find\-next T}:T{ .sp یافتن مورد منطبق بعدی در جستجو T} T{ .sp find\-prev T}:T{ .sp یافتن مورد منطبق قبلی در جستجو T} .TE .sp 1 .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBمتفرقه (Misc)\fR .RS 4 .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp edit T}:T{ .sp باز کردن در ویرایشگر T} T{ .sp prompt T}:T{ .sp باز کردن اعلان خط فرمان T} T{ .sp options T}:T{ .sp باز کردن منوی گزینه‌ها T} T{ .sp screen\-redraw T}:T{ .sp بازترسیم صفحه T} T{ .sp stop\-loading T}:T{ .sp توقف بارگذاری تمامی نماها T} T{ .sp show\-version T}:T{ .sp نمایش اطلاعات نسخه T} T{ .sp none T}:T{ .sp هیچ کاری انجام نده T} .TE .sp 1 .RE .SH "دستور رنگ (COLOR COMMAND)" .sp دستورات رنگ، برجسته‌سازی و سبک‌های رابط کاربری را کنترل می‌کنند\&. اگر ترمینال شما از رنگ پشتیبانی می‌کند و متغیر محیطی NO_COLOR تنظیم نشده یا خالی باشد، این دستورات را می‌توان برای اختصاص ترکیب رنگ‌های پیش‌زمینه و پس‌زمینه به نواحی مشخص به کار برد\&. به صورت اختیاری، یک صفت می‌تواند به عنوان آخرین پارامتر تعیین شود\&. ساختار دستور به این صورت است: .sp .if n \{\ .RS 4 .\} .nf \fBcolor\fR \fIarea\fR \fIfgcolor\fR \fIbgcolor\fR \fI[attributes]\fR .fi .if n \{\ .RE .\} .sp .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf # بازنویسی رنگ‌های پیش‌فرض ترمینال به سفید روی سیاه\&. color default white black # رنگ‌های Diff color diff\-header yellow default color diff\-index blue default color diff\-chunk magenta default color "Reported\-by:" green default # رنگ ویژه نما color tree\&.date black cyan bold # رنگ سفارشی color "/(note|warning|error):/" yellow default bold .fi .if n \{\ .RE .\} .sp .sp یا در فایل‌های پیکربندی گیت: .sp .if n \{\ .RS 4 .\} .nf [tig "color"] # یک خط مکان‌نمای با ظاهر غیرمعمول cursor = red default underline # رنگ‌های رابط کاربری title\-blur = white blue title\-focus = white blue bold # رنگ ویژه نما [tig "color\&.tree"] date = cyan default bold .fi .if n \{\ .RE .\} .sp .PP نام‌های ناحیه (Area names) .RS 4 می‌تواند یک نام ناحیه توکار یا یک رشته نقل‌قول‌شده سفارشی باشد\&. رشته سفارشی اجازه می‌دهد قواعد رنگ دلخواه برای خطوطی که با رشته داخل نقل‌قول مطابقت دارند اضافه شود\&. رشته‌هایی به صورت "/\&.../" به عنوان عبارات باقاعده تفسیر می‌شوند\&. نام‌های معتبر نواحی توکار در ادامه شرح داده شده‌اند\&. توجه داشته باشید که تمامی نام‌ها به حروف بزرگ و کوچک حساس نیستند، و می‌توانید از \fI\-\fR و \fI_\fR به جای یکدیگر استفاده کنید؛ برای مثال "Diff\-Header" و "DIFF_HEADER" یکسان هستند\&. رنگ‌های ویژه هر نما را می‌توان با اضافه کردن نام نما به عنوان پیشوند به نام ناحیه تعریف کرد؛ برای مثال "stage\&.diff\-chunk" و "diff\&.diff\-chunk"\&. .RE .PP نام‌های رنگ (Color names) .RS 4 رنگ‌های معتبر عبارتند از: \fBwhite\fR، \fBblack\fR، \fBgreen\fR، \fBmagenta\fR، \fBblue\fR، \fBcyan\fR، \fByellow\fR، \fBred\fR، \fBdefault\fR\&. از \fBdefault\fR برای اشاره به رنگ‌های پیش‌فرض ترمینال استفاده کنید؛ برای مثال جهت شفاف نگه‌داشتن پس‌زمینه در حالتی که از ترمینالی با پس‌زمینه شفاف استفاده می‌کنید\&. .sp رنگ‌ها را می‌توان با استفاده از کلیدواژه‌های \fBcolor0\fR، \fBcolor1\fR، \&...، \fBcolorN\-1\fR نیز مشخص کرد (که در آن \fBN\fR تعداد رنگ‌های پشتیبانی‌شده توسط ترمینال شما است)\&. این امر زمانی مفید است که رنگ‌ها را برای نمایشگر خود بازنگاشت کرده‌اید یا می‌خواهید از رنگ‌های ارائه‌شده توسط ترمینال‌های ۸۸ رنگی و ۲۵۶ رنگی بهره ببرید\&. توجه داشته باشید که پیشوند \fIcolor\fR اختیاری است\&. در صورت تمایل می‌توانید همانند فایل‌های پیکربندی گیت، رنگ‌ها را مستقیماً با شماره‌های \fB0\fR، \fB1\fR، \&...، \fBN\-1\fR مشخص کنید\&. .RE .PP نام‌های صفت (Attribute names) .RS 4 صفت‌های معتبر عبارتند از: \fBnormal\fR، \fBblink\fR، \fBbold\fR، \fBdim\fR، \fBreverse\fR، \fBstandout\fR و \fBunderline\fR\&. توجه داشته باشید که ممکن است همه صفت‌ها توسط ترمینال پشتیبانی نشوند\&. .RE .SS "رنگ‌های رابط کاربری (UI colors)" .sp رنگ‌ها و صفت‌هایی که باید برای متن‌های فاقد برجسته‌سازی استفاده شوند یا مواردی که استفاده از رنگ‌های پیش‌فرض ترمینال را مشخص می‌کنند، می‌توان با تنظیم گزینه رنگ \fBdefault\fR کنترل کرد\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .B جدول\ \&۱.\ \&عمومی (General) .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp default T}:T{ .sp بازنویسی رنگ‌های پیش‌فرض ترمینال (به توضیحات بالا مراجعه کنید)\&. T} T{ .sp cursor T}:T{ .sp خط مکان‌نما برای نمای جاری\&. T} T{ .sp cursor\-blur T}:T{ .sp خط مکان‌نمای هر نمایی که در پس‌زمینه قرار دارد\&. T} T{ .sp status T}:T{ .sp پنجره وضعیت که پیام‌های اطلاع‌رسانی را نشان می‌دهد\&. T} T{ .sp title\-focus T}:T{ .sp پنجره عنوان برای نمای جاری\&. T} T{ .sp title\-blur T}:T{ .sp پنجره عنوان هر نمایی که در پس‌زمینه قرار دارد\&. T} T{ .sp search\-result T}:T{ .sp نتیجه برجسته‌شده جستجو\&. T} T{ .sp delimiter T}:T{ .sp جداکننده نمایش‌داده‌شده برای خطوط کوتاه‌شده\&. T} T{ .sp header T}:T{ .sp خطوط سربرگ نما\&. از \fIstatus\&.header\fR برای رنگ‌آمیزی بخش‌های استیج‌شده، استیج‌نشده و ردگیری‌نشده در نمای وضعیت استفاده کنید\&. از \fIhelp\&.header\fR برای رنگ‌آمیزی بخش‌های نگاشت کلید در نمای راهنما استفاده کنید\&. T} T{ .sp line\-number T}:T{ .sp شماره خطوط\&. T} T{ .sp id T}:T{ .sp شناسه کامیت\&. T} T{ .sp date T}:T{ .sp تاریخ ثبت‌کننده یا تاریخ نویسنده\&. T} T{ .sp author T}:T{ .sp نویسنده کامیت\&. T} T{ .sp committer T}:T{ .sp ثبت‌کننده کامیت\&. T} T{ .sp mode T}:T{ .sp حالت فایل شامل دسترسی‌ها و نوع آن\&. T} T{ .sp overflow T}:T{ .sp سرریز متن عنوان\&. T} T{ .sp directory T}:T{ .sp نام دایرکتوری\&. T} T{ .sp file T}:T{ .sp نام فایل\&. T} T{ .sp file\-size T}:T{ .sp اندازه فایل\&. T} .TE .sp 1 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .B جدول\ \&۲.\ \&رنگ‌های نمای اصلی (Main view colors) .TS tab(:); lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt lt. T{ .sp graph\-commit T}:T{ .sp نقطه کامیت در نمودار بازبینی‌ها\&. T} T{ .sp palette\-[0\-13] T}:T{ .sp ۱۴ رنگ مختلف، مورد استفاده برای متمایز کردن شاخه‌ها یا کامیت‌ها\&. به صورت پیش‌فرض، پالت از رنگ‌های اسکی استفاده می‌کند که نیمه دوم آن‌ها صفت بولد را برای ایجاد رنگی درخشان‌تر فعال دارند\&. مثال: palette\-0 = red T} T{ .sp main\-commit T}:T{ .sp توضیحات کامیت\&. T} T{ .sp main\-annotated T}:T{ .sp توضیحات کامیت برای یک کامیت حاشیه‌نویسی‌شده\&. T} T{ .sp main\-head T}:T{ .sp برچسب شاخه جاری\&. T} T{ .sp main\-remote T}:T{ .sp برچسب یک مخزن دوردست\&. T} T{ .sp main\-tracked T}:T{ .sp برچسب مخزن دوردستی که توسط شاخه جاری ردگیری می‌شود\&. T} T{ .sp main\-tag T}:T{ .sp برچسب یک تگ امضاشده\&. T} T{ .sp main\-local\-tag T}:T{ .sp برچسب یک تگ محلی\&. T} T{ .sp main\-ref T}:T{ .sp برچسب یک شاخه\&. T} T{ .sp main\-replace T}:T{ .sp برچسب مرجع جایگزین‌شده\&. T} T{ .sp main\-stash T}:T{ .sp برچسب stash\&. T} T{ .sp main\-note T}:T{ .sp برچسب یادداشت‌ها (notes)\&. T} T{ .sp main\-prefetch T}:T{ .sp برچسب مرجع پیش‌واکشی‌شده توسط git maintenance\&. T} T{ .sp main\-other T}:T{ .sp برچسب هر مرجع دیگر\&. T} .TE .sp 1 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .B جدول\ \&۳.\ \&نمای وضعیت (Status view) .TS tab(:); lt lt lt lt lt lt lt lt. T{ .sp stat\-none T}:T{ .sp برچسب وضعیت خالی\&. T} T{ .sp stat\-staged T}:T{ .sp فلگ وضعیت فایل‌های استیج‌شده\&. T} T{ .sp stat\-unstaged T}:T{ .sp فلگ وضعیت فایل‌های استیج‌نشده\&. T} T{ .sp stat\-untracked T}:T{ .sp فلگ وضعیت فایل‌های ردگیری‌نشده\&. T} .TE .sp 1 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .B جدول\ \&۴.\ \&نمای راهنما (Help view) .TS tab(:); lt lt lt lt. T{ .sp help\-group T}:T{ .sp نام گروه راهنما\&. T} T{ .sp help\-action T}:T{ .sp نام عملیات راهنما\&. T} .TE .sp 1 .SS "برجسته‌سازی (Highlighting)" .PP علامت‌گذاری Diff (Diff markup) .RS 4 گزینه‌های مربوط به شروع diff، تکه‌ها و خطوط اضافه‌شده و حذف‌شده\&. .RE .sp \fBdiff\-header\fR, \fBdiff\-chunk\fR, \fBdiff\-stat\fR, \fBdiff\-add\fR, \fBdiff\-add2\fR, \fBdiff\-del\fR, \fBdiff\-del2\fR, \fBdiff\-add\-highlight\fR, \fBdiff\-del\-highlight\fR .PP علامت‌گذاری پیشرفته Diff گیت (Enhanced Git diff markup) .RS 4 اطلاعات اضافی diff ارائه‌شده توسط سازوکار diff گیت، مانند تغییرات حالت، تشخیص تغییر نام و شباهت\&. .RE .sp \fBdiff\-oldmode\fR, \fBdiff\-newmode\fR, \fBdiff\-copy\-from\fR, \fBdiff\-copy\-to\fR, \fBdiff\-similarity\fR, \fBdiff\-index\fR .PP قالب‌بندی زیبای سربرگ‌های کامیت (Pretty print commit headers) .RS 4 تغییرات کامیت و لاگ‌های بازبینی معمولاً با استفاده از سربرگ‌های قالب‌بندی‌شده زیبا نمایش داده می‌شوند، مگر اینکه \-\-\pretty=raw تعیین شده باشد\&. این شامل خطوطی مانند اطلاعات ادغام، شناسه کامیت، و تاریخ نویسنده و ثبت‌کننده می‌شود\&. .RE .sp \fBpp\-refs\fR, \fBpp\-reflog\fR, \fBpp\-reflogmsg\fR, \fBpp\-merge\fR .PP سربرگ خام کامیت (Raw commit header) .RS 4 معمولاً هنگامی نشان داده می‌شود که \-\-\pretty=raw داده شده باشد، با این حال \fIcommit\fR تقریباً همه‌جا حاضر است\&. .RE .sp \fBcommit\fR, \fBparent\fR, \fBtree\fR, \fBauthor\fR, \fBcommitter\fR .PP پیام کامیت (Commit message) .RS 4 بیشتر خطوط دنباله متداول (مانند Signed\-off\-by) رنگ‌آمیزی می‌شوند\&. نویسه‌های عنوان کامیت که از عرض از پیش تعریف‌شده فراتر روند می‌توانند برجسته شوند\&. .RE .PP علامت‌گذاری درخت (Tree markup) .RS 4 رنگ‌ها برای اطلاعات نمای درخت\&. .RE .sp \fBtree\-dir\fR, \fBtree\-file\fR .SH "دستور SOURCE (SOURCE COMMAND)" .sp دستورات source خواندن فایل‌های پیکربندی اضافی را امکان‌پذیر می‌سازند\&. فایل‌های خوانده‌شده به صورت درجا گنجانده می‌شوند، بدین معنی که هنگام مواجهه با یک دستور \fIsource\fR، فایل بلافاصله خوانده خواهد شد\&. هر دستوری که بعداً در فایل پیکربندی فعلی بیاید اولویت خواهد داشت\&. .sp اگر مسیر داده‌شده وجود نداشته باشد، tig همراه با یک هشدار به کار خود ادامه می‌دهد\&. برای نادیده گرفتن این هشدار، پارامتر \-q را مشخص کنید\&. .sp ساختار دستور به این صورت است: .sp .if n \{\ .RS 4 .\} .nf \fBsource\fR \fI[\-q]\fR \fIpath\fR .fi .if n \{\ .RE .\} .sp .sp مثال‌ها: .sp .if n \{\ .RS 4 .\} .nf source ~/\&.tig/colorscheme\&.tigrc source ~/\&.tig/keybindings\&.tigrc .fi .if n \{\ .RE .\} .sp .SH "حق نشر (COPYRIGHT)" .sp Copyright (c) 2006\-2026 Jonas Fonseca <\m[blue]\fBjonas\&.fonseca@gmail\&.com\fR\m[]\&\s-2\u[1]\d\s+2> .sp این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط اجازه‌نامه عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBtig\fR(1), \fBtigmanual\fR(7), git(7), git\-config(1) .SH "نکات (NOTES)" .IP " 1." 4 jonas.fonseca@gmail.com .RS 4 \%mailto:jonas.fonseca@gmail.com .RE