'\" t
.\"     Title: gitk
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GITK" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git 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)"
gitk \- مرورگر مخزن گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgitk\fR [<options>] [<revision\-range>] [\-\-] [<path>\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
تغییرات موجود در یک مخزن یا مجموعه‌ای انتخاب‌شده از کامیت‌ها را نمایش می‌دهد\&. این شامل مصورسازی نمودار کامیت‌ها، نمایش اطلاعات مربوط به هر کامیت و فایل‌های موجود در درخت هر نسخه است\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای کنترل این‌که کدام نسخه‌ها نمایش داده شوند، gitk از بیشتر گزینه‌های قابل اعمال بر دستور \fIgit rev\-list\fR پشتیبانی می‌کند\&. همچنین از چند گزینهٔ قابل اعمال بر دستورات \fIgit diff\-*\fR برای کنترل چگونگی نمایش تغییرات معرفی‌شده توسط هر کامیت پشتیبانی می‌کند\&. در نهایت، از برخی گزینه‌های مختص به gitk نیز پشتیبانی می‌نماید\&.
.sp
به دلیل محدودیت‌های تجزیه‌کنندهٔ خط فرمان، gitk عموماً تنها گزینه‌هایی را متوجه می‌شود که آرگومان‌های آن‌ها در فرم متصل یا چسبیده (\fIstuck\fR) باشند (به \fBgitcli\fR(7) مراجعه کنید)\&.
.SS "گزینه‌ها و آرگومان‌های rev\-list"
.sp
این صفحهٔ راهنما تنها پرکاربردترین گزینه‌ها را شرح می‌دهد\&. برای فهرست کامل به \fBgit-rev-list\fR(1) مراجعه کنید\&.
.PP
\-\-all
.RS 4
نمایش تمام ارجاع‌ها (شاخه‌ها، تگ‌ها و غیره)\&.
.RE
.PP
\-\-branches[=<pattern>], \-\-tags[=<pattern>], \-\-remotes[=<pattern>]
.RS 4
مانند این رفتار می‌کند که گویی تمام شاخه‌ها (به ترتیب: تگ‌ها، شاخه‌های ریموت) در خط فرمان به عنوان
\fI<commit>\fR
ذکر شده‌اند\&. اگر
\fI<pattern>\fR
مشخص شود، ارجاع‌ها را به مواردی که با الگوی گلوب پوسته مطابقت دارند محدود می‌کند\&. اگر الگو فاقد
\fI?\fR،
\fI*\fR یا
\fI[\fR
باشد، وجود
\fI/*\fR
در انتهای آن فرض می‌شود\&.
.RE
.PP
\-\-since=<date>
.RS 4
نمایش کامیت‌های جدیدتر از یک تاریخ مشخص\&.
.RE
.PP
\-\-until=<date>
.RS 4
نمایش کامیت‌های قدیمی‌تر از یک تاریخ مشخص\&.
.RE
.PP
\-\-date\-order
.RS 4
مرتب‌سازی کامیت‌ها بر اساس تاریخ در صورت امکان\&.
.RE
.PP
\-\-merge
.RS 4
پس از توقف عملیات ادغام به دلیل وجود تداخل، کامیت‌هایی از تاریخچهٔ بین دو شاخه (یعنی HEAD و MERGE_HEAD) را نمایش می‌دهد که فایل‌های دارای تداخل را تغییر داده‌اند و در تمام سرهای در حال ادغام وجود ندارند\&.
.RE
.PP
\-\-left\-right
.RS 4
مشخص می‌کند که یک کامیت از کدام سمت تفاضل متقارن قابل دسترسی است\&. کامیت‌های سمت چپ با نماد < و کامیت‌های سمت راست با نماد > پیشوند می‌خورند\&.
.RE
.PP
\-\-full\-history
.RS 4
هنگام فیلتر کردن تاریخچه با
\fI<path>\&...\fR،
بخش‌هایی از تاریخچه را هرس نمی‌کند\&. (برای توضیح دقیق‌تر به بخش "ساده‌سازی تاریخچه" در
\fBgit-log\fR(1)
مراجعه کنید)\&.
.RE
.PP
\-\-simplify\-merges
.RS 4
گزینه‌ای مکمل برای
\fB\-\-full\-history\fR
جهت حذف برخی ادغام‌های غیرضروری از تاریخچهٔ حاصل، در حالتی که هیچ کامیت انتخاب‌شده‌ای در آن ادغام نقش نداشته باشد\&. (برای توضیح دقیق‌تر به بخش "ساده‌سازی تاریخچه" در
\fBgit-log\fR(1)
مراجعه کنید)\&.
.RE
.PP
\-\-ancestry\-path
.RS 4
هنگامی که بازه‌ای از کامیت‌ها برای نمایش داده می‌شود (مثلاً
\fIcommit1\&.\&.commit2\fR
یا
\fIcommit2 ^commit1\fR)،
تنها کامیت‌هایی را نمایش می‌دهد که مستقیماً در زنجیرهٔ نیاکانیِ میان
\fIcommit1\fR
و
\fIcommit2\fR
قرار دارند؛ یعنی کامیت‌هایی که هم نوادهٔ
\fIcommit1\fR
و هم نیاکانِ
\fIcommit2\fR
هستند\&. (برای توضیح دقیق‌تر به بخش "ساده‌سازی تاریخچه" در
\fBgit-log\fR(1)
مراجعه کنید)\&.
.RE
.PP
\fB\-L\fR\fI<start>\fR\fB,\fR\fI<end>\fR\fB:\fR\fI<file>\fR, \fB\-L:\fR\fI<funcname>\fR\fB:\fR\fI<file>\fR
.RS 4
ردیابی سیر تکاملی بازهٔ سطرهای داده‌شده با
\fI<start>\fR\fB,\fR\fI<end>\fR
یا با عبارت باقاعدهٔ نام تابع
\fI<funcname>\fR
درون
\fI<file>\fR\&.
شما مجاز به تعیین محدودکننده‌های pathspec نیستید\&. این گزینه در حال حاضر به پیمایشی با شروع از یک نسخهٔ منفرد محدود است؛ یعنی تنها می‌توانید صفر یا یک آرگومان نسخهٔ مثبت بدهید، و
\fI<start>\fR
و
\fI<end>\fR
(یا
\fI<funcname>\fR)
باید در نسخهٔ آغازین وجود داشته باشند\&. می‌توانید این گزینه را بیش از یک‌بار مشخص کنید\&. این گزینه متضمن
\fB\-\-patch\fR
است\&. خروجی وصله (patch) را می‌توان با استفاده از
\fB\-\-no\-patch\fR
سرکوب کرد\&. قالب‌های diff غیروصله‌ای
\fB\-\-raw\fR،
\fB\-\-name\-only\fR،
\fB\-\-name\-status\fR
و
\fB\-\-summary\fR
پشتیبانی می‌شوند\&. قالب‌های آماری تفاضل (\fB\-\-stat\fR،
\fB\-\-numstat\fR،
\fB\-\-shortstat\fR،
\fB\-\-dirstat\fR)
در حال حاضر پیاده‌سازی نشده‌اند\&.
.sp
گزینه‌های قالب‌بندی وصله مانند
\fB\-\-word\-diff\fR،
\fB\-\-color\-moved\fR،
\fB\-\-no\-prefix\fR
و گزینه‌های فاصلهٔ خالی (\fB\-w\fR،
\fB\-b\fR)
پشتیبانی می‌شوند، همان‌طور که گزینه‌های pickaxe (\fB\-S\fR،
\fB\-G\fR)
و
\fB\-\-diff\-filter\fR
پشتیبانی می‌گردند\&.
.sp
\fI<start>\fR
و
\fI<end>\fR
می‌توانند یکی از این شکل‌ها را داشته باشند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI<number>\fR
.sp
اگر
\fI<start>\fR
یا
\fI<end>\fR
یک عدد باشد، شماره سطر مطلق را مشخص می‌کند (شمارش سطرها از ۱ آغاز می‌شود)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB/\fR\fI<regex>\fR\fB/\fR
.sp
این شکل از نخستین سطری که با عبارت باقاعدهٔ POSIX داده‌شده با
\fI<regex>\fR
مطابقت داشته باشد استفاده می‌کند\&. اگر
\fI<start>\fR
یک عبارت باقاعده باشد، جستجو از پایان بازهٔ
\fB\-L\fR
قبلی (در صورت وجود)، و در غیر این صورت از ابتدای فایل آغاز می‌شود\&. اگر
\fI<start>\fR
به صورت
\fB^/\fR\fI<regex>\fR\fB/\fR
باشد، جستجو از ابتدای فایل انجام می‌شود\&. اگر
\fI<end>\fR
یک عبارت باقاعده باشد، جستجو با شروع از سطر تعیین‌شده توسط
\fI<start>\fR
انجام می‌پذیرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB+\fR\fI<offset>\fR
یا
\fB\-\fR\fI<offset>\fR
.sp
این شکل تنها برای
\fI<end>\fR
معتبر است و تعدادی سطر قبل یا بعد از سطر مشخص‌شده توسط
\fI<start>\fR
را تعیین می‌کند\&.
.RE
.sp
اگر
\fB:\fR\fI<funcname>\fR
به جای
\fI<start>\fR
و
\fI<end>\fR
داده شود، یک عبارت باقاعده است که بازه را از نخستین سطر نام تابعی که با
\fI<funcname>\fR
مطابقت دارد تا سطر نام تابع بعدی مشخص می‌کند\&.
\fB:\fR\fI<funcname>\fR
از پایان بازهٔ
\fB\-L\fR
قبلی (در صورت وجود) و در غیر این صورت از آغاز فایل جستجو می‌کند\&.
\fB^:\fR\fI<funcname>\fR
از آغاز فایل جستجو را انجام می‌دهد\&. نام‌های توابع به همان شیوه‌ای تعیین می‌شوند که
\fBgit\fR
\fBdiff\fR
هدرهای قطعهٔ وصله (patch hunk headers) را محاسبه می‌کند (به
\fIDefining a custom hunk\-header\fR
در
\fBgitattributes\fR(5)
مراجعه کنید)\&.
.RE
.PP
<revision range>
.RS 4
محدود کردن نسخه‌های قابل نمایش\&. این می‌تواند یک نسخهٔ منفرد باشد به معنای نمایش از آن نسخه به عقب، یا می‌تواند بازه‌ای به شکل "\fI<from>\fR\&.\&.\fI<to>\fR" باشد برای نمایش تمام نسخه‌های بین
\fI<from>\fR
و بازگشت به
\fI<to>\fR\&.
توجه داشته باشید که انتخاب پیشرفته‌تر نسخه‌ها نیز می‌تواند اعمال شود\&. برای فهرست کامل‌تری از روش‌های نگارش نام اشیا، به
\fBgitrevisions\fR(7)
مراجعه کنید\&.
.RE
.PP
<path>\&...
.RS 4
محدود کردن کامیت‌ها به مواردی که به فایل‌های موجود در مسیرهای مشخص‌شده دست می‌زنند\&. توجه داشته باشید که برای جلوگیری از ابهام در رابطه با نام نسخه‌ها، از "\-\-" برای جدا کردن مسیرها از گزینه‌های قبلی استفاده کنید\&.
.RE
.SS "گزینه‌های ویژهٔ gitk"
.PP
\-\-argscmd=<command>
.RS 4
دستوری که هر بار gitk نیاز به تعیین بازهٔ نسخه‌ها برای نمایش دارد اجرا می‌شود\&. انتظار می‌رود این دستور در خروجی استاندارد خود فهرستی از نسخه‌های اضافی برای نمایش را، در هر سطر یک نسخه، چاپ کند\&. اگر مجموعهٔ کامیت‌ها برای نمایش بین تازه‌سازی‌ها متغیر است، از این گزینه به جای مشخص کردن صریح
\fI<revision\-range>\fR
استفاده کنید\&.
.RE
.PP
\-\-select\-commit=<ref>
.RS 4
انتخاب کامیت مشخص‌شده پس از بارگیری گراف\&. رفتار پیش‌فرض معادل تعیین
\fI\-\-select\-commit=HEAD\fR
است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
gitk v2\&.6\&.12\&.\&. include/scsi drivers/scsi
.RS 4
نمایش تغییرات از نسخهٔ
\fIv2\&.6\&.12\fR
به بعد که هر فایلی را در زیرپوشه‌های include/scsi یا drivers/scsi تغییر داده‌اند
.RE
.PP
gitk \-\-since="2 weeks ago" \-\- gitk
.RS 4
نمایش تغییرات دو هفتهٔ گذشته روی فایل
\fIgitk\fR\&.
استفاده از "\-\-" برای جلوگیری از اشتباه گرفتن با
\fBشاخهٔ\fR
به نام
\fIgitk\fR
لازم است
.RE
.PP
gitk \-\-max\-count=100 \-\-all \-\- Makefile
.RS 4
نمایش حداکثر ۱۰۰ تغییر ایجادشده روی فایل
\fIMakefile\fR\&.
به جای جستجوی تغییرات فقط در شاخهٔ فعلی، در تمام شاخه‌ها جستجو می‌کند\&.
.RE
.SH "فایل‌ها (FILES)"
.sp
پیکربندی و ترجیحات کاربر در این مسیرها ذخیره می‌شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$XDG_CONFIG_HOME/git/gitk\fR
در صورت وجود، در غیر این صورت
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$HOME/\&.gitk\fR
در صورت وجود
.RE
.sp
اگر هیچ‌کدام از موارد بالا وجود نداشته باشد، به طور پیش‌فرض \fB$XDG_CONFIG_HOME/git/gitk\fR ایجاد و استفاده می‌شود\&. اگر \fI$XDG_CONFIG_HOME\fR تنظیم نشده باشد، در تمام موارد مقدار پیش‌فرض آن \fB$HOME/\&.config\fR است\&.
.SH "تاریخچه (HISTORY)"
.sp
نرم‌افزار Gitk نخستین مرورگر گرافیکی مخزن بود که توسط Paul Mackerras با Tcl/Tk نوشته شد\&.
.sp
برنامهٔ \fIgitk\fR در واقع به عنوان پروژه‌ای مستقل نگهداری می‌شود، اما نسخه‌های پایدار آن برای راحتی کاربران نهایی به عنوان بخشی از مجموعهٔ Git توزیع می‌شوند\&.
.sp
پروژهٔ \fBgitk\-git/\fR از پروژهٔ gitk متعلق به Johannes Sixt می‌آید:
.sp
.if n \{\
.RS 4
.\}
.nf
https://github\&.com/j6t/gitk
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fIqgit(1)\fR
.RS 4
یک مرورگر مخزن نوشته‌شده با C++ و استفاده از Qt\&.
.RE
.PP
\fItig(1)\fR
.RS 4
مرورگر مینیمال مخزن و برجسته‌کنندهٔ خروجی ابزار Git که به زبان C و با استفاده از Ncurses نوشته شده است\&.
.RE
.SH "GIT"
.sp
بخشی از مجموعهٔ \fBgit\fR(1)