'\" t
.\"     Title: git-check-ignore
.\"    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 "GIT\-CHECK\-IGNORE" "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)"
git-check-ignore \- اشکال‌زدایی فایل‌های gitignore / exclude
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit check\-ignore\fR [<options>] <pathname>\&...
\fIgit check\-ignore\fR [<options>] \-\-stdin
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
به ازای هر نام مسیر داده‌شده از طریق خط فرمان یا از طریق یک فایل با \fB\-\-stdin\fR، بررسی می‌کند که آیا فایل توسط \&.gitignore (یا سایر فایل‌های ورودی به سازوکار مستثنی‌سازی) نادیده گرفته شده است یا خیر و در صورت مستثنی بودن، مسیر را در خروجی چاپ می‌کند\&.
.sp
به طور پیش‌فرض، فایل‌های ردگیری‌شده (tracked) اصلاً نمایش داده نمی‌شوند زیرا مشمول قوانین مستثنی‌سازی نیستند؛ اما \(oq\-\-no\-index\(cq را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-q, \-\-quiet
.RS 4
هیچ خروجی تولید نمی‌کند، فقط وضعیت خروج را تنظیم می‌کند\&. این گزینه فقط همراه با یک نام مسیر معتبر است\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
به جای چاپ صرف مسیرهایی که مستثنی شده‌اند، برای هر مسیری که با یک الگوی استثنا مطابقت دارد، الگوی استثنا را همراه با مسیر چاپ می‌کند\&. (تطبیق با یک الگوی استثنا معمولاً به این معنی است که مسیر نادیده گرفته می‌شود، اما اگر الگو با «!» شروع شود، یک الگوی نفی‌شده است و تطابق با آن به این معنی است که مسیر نادیده گرفته *نمی‌شود*)\&.
.sp
برای قوانین حق تقدم درون و میان منابع استثنا،
\fBgitignore\fR(5)
را ببینید\&.
.RE
.PP
\-\-stdin
.RS 4
نام مسیرها را به جای خط فرمان، از ورودی استاندارد (یک نام مسیر در هر خط) می‌خواند\&.
.RE
.PP
\-z
.RS 4
قالب خروجی را به شکلی تغییر می‌دهد که برای ماشین قابل تجزیه باشد (پایین را ببینید)\&. اگر
\fB\-\-stdin\fR
نیز داده شود، مسیرهای ورودی به جای نویسه خط جدید با نویسه NUL جدا می‌شوند\&.
.RE
.PP
\-n, \-\-non\-matching
.RS 4
مسیرهای داده‌شده‌ای را که با هیچ الگویی مطابقت ندارند نشان می‌دهد\&. این گزینه تنها زمانی کاربرد دارد که
\fB\-\-verbose\fR
فعال باشد، در غیر این صورت تشخیص مسیرهایی که با یک الگو مطابقت دارند از آن‌هایی که تطابق ندارند ممکن نخواهد بود\&.
.RE
.PP
\-\-no\-index
.RS 4
هنگام انجام بررسی‌ها، در نمایه (index) جستجو نمی‌کند\&. این گزینه می‌تواند برای اشکال‌زدایی این که چرا یک مسیر مثلاً توسط
\fBgit\fR
\fBadd\fR
\&. ردگیری شده و بر خلاف انتظار کاربر توسط قوانین نادیده گرفته نشده است، یا هنگام توسعه الگوهای حاوی نفی برای تطبیق با مسیری که پیش‌تر با
\fBgit\fR
\fBadd\fR
\fB\-f\fR
اضافه شده، استفاده شود\&.
.RE
.SH "خروجی (OUTPUT)"
.sp
به طور پیش‌فرض، هر یک از نام مسیرهای داده‌شده که با یک الگوی نادیده‌گیری مطابقت داشته باشند، در هر خط یکی در خروجی چاپ می‌شوند\&. اگر هیچ الگویی با یک مسیر داده‌شده مطابقت نداشته باشد، چیزی برای آن مسیر در خروجی چاپ نخواهد شد؛ این بدان معناست که آن مسیر نادیده گرفته نخواهد شد\&.
.sp
اگر \fB\-\-verbose\fR مشخص شود، خروجی به صورت مجموعه‌ای از خطوط با قالب زیر خواهد بود:
.sp
<source> <COLON> <linenum> <COLON> <pattern> <HT> <pathname>
.sp
<pathname> مسیر فایل مورد پرس‌وجو، <pattern> الگوی تطبیق‌یافته، <source> فایل منبع الگو، و <linenum> شماره خط الگو در آن منبع است\&. اگر الگو دارای پیشوند «!» یا پسوند «\fB/\fR» باشد، در خروجی حفظ خواهد شد\&. هنگامی که <source> به فایل پیکربندی‌شده توسط \fBcore\&.excludesFile\fR اشاره کند، یک مسیر مطلق خواهد بود، یا هنگام اشاره به \fB\&.git/info/exclude\fR یا یک فایل استثنای درون هر دایرکتوری، نسبت به ریشه مخزن خواهد بود\&.
.sp
اگر \fB\-z\fR مشخص شود، نام مسیرها در خروجی با نویسه null جدا می‌شوند؛ اگر \fB\-\-verbose\fR نیز مشخص شده باشد، به جای دونقطه و تب سخت (hard tab) نیز از نویسه‌های null استفاده می‌شود:
.sp
<source> <NULL> <linenum> <NULL> <pattern> <NULL> <pathname> <NULL>
.sp
اگر \fB\-n\fR یا \fB\-\-non\-matching\fR مشخص شوند، نام مسیرهای نامنطبق نیز در خروجی چاپ خواهند شد، که در این حالت تمام فیلدها در هر رکورد خروجی به جز <pathname> خالی خواهند بود\&. این می‌تواند هنگام اجرای غیرتعاملی مفید باشد، به طوری که فایل‌ها را می‌توان به صورت تدریجی به STDIN یک فرآیند طولانی‌مدت check\-ignore هدایت کرد، و به ازای هر یک از این فایل‌ها، STDOUT مشخص خواهد کرد که آیا آن فایل با الگویی مطابقت داشته است یا خیر\&. (بدون این گزینه، تشخیص این که آیا نبود خروجی برای یک فایل معین به معنی عدم تطابق با هرگونه الگو بوده، یا این که خروجی هنوز تولید نشده است، غیرممکن خواهد بود)\&.
.sp
بافرسازی همان‌طور که ذیل گزینه \fBGIT_FLUSH\fR در \fBgit\fR(1) مستند شده است انجام می‌شود\&. فراخواننده مسئول جلوگیری از بن‌بست‌های ناشی از پر شدن بیش از حد بافر ورودی یا خواندن از بافر خروجی خالی است\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
0
.RS 4
یک یا چند مورد از مسیرهای ارائه‌شده نادیده گرفته شده‌اند (مستثنی هستند)\&.
.RE
.PP
1
.RS 4
هیچ‌یک از مسیرهای ارائه‌شده نادیده گرفته نشده‌اند\&.
.RE
.PP
128
.RS 4
یک خطای مهلک رخ داد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgitignore\fR(5) \fBgit-config\fR(1) \fBgit-ls-files\fR(1)
.SH "GIT"
.sp
بخشی از مجموعه \fBgit\fR(1)