'\" t
.\"     Title: git-lfs-track
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GIT\-LFS\-TRACK" "1" "" "\ \&" "\ \&"
.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)"
git-lfs-track \- مشاهده یا افزودن مسیرهای Git LFS به ویژگی‌های گیت (Git attributes)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.fam C
\fBgit lfs track\fP [\fIoptions\fP] [\fI<pattern>\fP...]
.fam
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
ردگیری الگوی(های) داده‌شده را از طریق Git LFS آغاز می‌کند\&. این آرگومان در فایل \f(CR.gitattributes\fP نوشته می‌شود\&. اگر هیچ مسیری ارائه نشود، صرفاً فهرست مسیرهای در حال ردگیری فعلی نمایش داده می‌شود\&.
.sp
طبق
.URL "https://git\-scm.com/docs/gitattributes" "مستندات gitattributes"
الگوها از
.URL "https://git\-scm.com/docs/gitignore" "قوانین الگوی gitignore" ""
برای تطبیق مسیرها استفاده می‌کنند\&. این بدان معناست که با الگوهای حاوی ستاره (\f(CR*\fP)، علامت سؤال (\f(CR?\fP) و نویسه‌های براکت (\f(CR[\fP و \f(CR]\fP) به‌صورت ویژه برخورد می‌شود؛ برای غیرفعال کردن این رفتار و برخورد عینی با آن‌ها، از گزینهٔ \f(CR\-\-filename\fP استفاده کنید یا نویسه را با یک بک‌اسلش اسکیپ نمایید\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
\f(CR\-v\fP, \f(CR\-\-verbose\fP
.RS 4
در صورت فعال بودن، باعث می‌شود \f(CRgit lfs track\fP فایل‌هایی را که تحت تأثیر قرار خواهد داد ثبت (log) کند\&. به‌طور پیش‌فرض غیرفعال است\&.
.RE
.sp
\f(CR\-d\fP, \f(CR\-\-dry\-run\fP
.RS 4
در صورت فعال بودن، باعث می‌شود \f(CRgit lfs track\fP تمام اقداماتی را که به‌طور عادی انجام می‌دهد (افزودن مدخل‌ها به \f(CR.gitattributes\fP، دستکاری فایل‌ها روی دیسک و غیره) بدون انجام هرگونه عملیات تغییردهنده روی دیسک، گزارش کند\&.
.sp
دستور \f(CRgit lfs track \-\-dry\-run [files]\fP همچنین به‌طور ضمنی رفتار گزینهٔ \f(CR\-\-verbose\fP را شبیه‌سازی کرده و با جزئیات بیشتری اقدامات خود را ثبت می‌کند\&.
.sp
به‌طور پیش‌فرض غیرفعال است\&.
.RE
.sp
\f(CR\-j\fP, \f(CR\-\-json\fP
.RS 4
در صورت خروج موفقیت‌آمیز دستور، الگوهای ردگیری‌شدهٔ فعلی را در قالب JSON در خروجی استاندارد (STDOUT) می‌نویسد\&. برای تعامل با ابزارهای خارجی در نظر گرفته شده است\&. نمی‌تواند با هیچ‌یک از آرگومان‌های \f(CR<pattern>\fP ترکیب شود\&. در صورت ارائهٔ هم‌زمان گزینهٔ \f(CR\-\-no\-excluded\fP، آن گزینه هیچ اثری نخواهد داشت\&.
.RE
.sp
\f(CR\-\-filename\fP
.RS 4
با آرگومان‌ها به عنوان نام‌های واقعی فایل رفتار می‌کند، نه به عنوان الگو\&. هرگونه نویسهٔ تطبیقی خاص (glob) در نام فایل هنگام نوشتن در پروندهٔ \f(CR.gitattributes\fP اسکیپ می‌شود\&.
.RE
.sp
\f(CR\-l\fP, \f(CR\-\-lockable\fP
.RS 4
مسیرها را «قابل قفل شدن» (\*(Aqlockable\*(Aq) می‌کند، به این معنی که برای ویرایش آن‌ها باید قفل شوند و در صورت قفل نبودن، در نسخهٔ کاری به‌صورت فقط‌خواندنی درمی‌آیند\&.
.RE
.sp
\f(CR\-\-not\-lockable\fP
.RS 4
نشان (flag) قابل قفل شدن را از مسیرها حذف می‌کند تا دیگر در صورت قفل نبودن به‌صورت فقط‌خواندنی نباشند\&.
.RE
.sp
\f(CR\-\-no\-excluded\fP
.RS 4
الگوهایی را که در خروجی مستثنی شده‌اند فهرست نمی‌کند؛ تنها الگوهایی را که ردگیری می‌شوند فهرست می‌کند\&.
.RE
.sp
\f(CR\-\-no\-modify\-attrs\fP
.RS 4
مدخل‌های مطابقت‌یافته را از نظر وضعیت کثیف (stat\-dirty) می‌کند تا گیت بتواند فایل‌هایی را که مایل به تبدیل به LFS هستید مجدداً نمایه (re\-index) کند\&. هیچ فایل \f(CR.gitattributes\fP را تغییر نمی‌دهد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
فهرست کردن الگوهایی که در حال حاضر توسط Git LFS ردگیری می‌شوند:
.sp
\f(CRgit lfs track\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
پیکربندی Git LFS برای ردگیری فایل‌های GIF:
.sp
\f(CRgit lfs track "*.gif"\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
پیکربندی Git LFS برای ردگیری فایل‌های PSD و قرار دادن آن‌ها در حالت فقط‌خواندنی مگر در صورت قفل بودن:
.sp
\f(CRgit lfs track \-\-lockable "*.psd"\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
پیکربندی Git LFS برای ردگیری فایلی به نام \f(CRproject [1].psd\fP:
.sp
\f(CRgit lfs track \-\-filename "project [1].psd"\fP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
git\-lfs\-untrack(1), git\-lfs\-install(1), gitattributes(5), gitignore(5).
.sp
بخشی از مجموعهٔ git\-lfs(1)\&.