git-lfs-track - مشاهده
یا افزودن
مسیرهای Git LFS
به
ویژگی‌های
گیت (Git attributes)
git lfs track [options] [<pattern>...]
ردگیری
الگوی(های)
داده‌شده
را از طریق Git LFS
آغاز
می‌کند. این
آرگومان در
فایل .gitattributes
نوشته
می‌شود. اگر
هیچ مسیری
ارائه
نشود،
صرفاً
فهرست
مسیرهای در
حال ردگیری
فعلی نمایش
داده
می‌شود.
طبق
مستندات
gitattributes https://git-scm.com/docs/gitattributes
الگوها از
قوانین
الگوی gitignore
https://git-scm.com/docs/gitignore برای
تطبیق
مسیرها
استفاده
می‌کنند.
این بدان
معناست که
با الگوهای
حاوی ستاره
(*)، علامت
سؤال (?) و
نویسه‌های
براکت ([ و
])
به‌صورت
ویژه
برخورد
می‌شود؛
برای
غیرفعال
کردن این
رفتار و
برخورد
عینی با
آن‌ها، از
گزینهٔ
--filename
استفاده
کنید یا
نویسه را با
یک بک‌اسلش
اسکیپ
نمایید.
-v, --verbose
در صورت
فعال بودن،
باعث
می‌شود git lfs
track
فایل‌هایی
را که تحت
تأثیر قرار
خواهد داد
ثبت (log) کند.
به‌طور
پیش‌فرض
غیرفعال
است.
-d, --dry-run
در صورت
فعال بودن،
باعث
می‌شود
git lfs
track تمام
اقداماتی
را که
به‌طور
عادی انجام
می‌دهد
(افزودن
مدخل‌ها به
.gitattributes،
دستکاری
فایل‌ها
روی دیسک و
غیره) بدون
انجام
هرگونه
عملیات
تغییردهنده
روی دیسک،
گزارش کند.
دستور git lfs
track --dry-run [files]
همچنین
به‌طور
ضمنی رفتار
گزینهٔ
--verbose را
شبیه‌سازی
کرده و با
جزئیات
بیشتری
اقدامات
خود را ثبت
می‌کند.
به‌طور
پیش‌فرض
غیرفعال
است.
-j, --json
در صورت
خروج
موفقیت‌آمیز
دستور،
الگوهای
ردگیری‌شدهٔ
فعلی را در
قالب JSON در
خروجی
استاندارد
(STDOUT) می‌نویسد.
برای تعامل
با
ابزارهای
خارجی در
نظر گرفته
شده است.
نمی‌تواند
با هیچ‌یک
از
آرگومان‌های
<pattern>
ترکیب شود.
در صورت
ارائهٔ
هم‌زمان
گزینهٔ
--no-excluded، آن
گزینه هیچ
اثری
نخواهد
داشت.
--filename
با
آرگومان‌ها
به عنوان
نام‌های
واقعی فایل
رفتار
می‌کند، نه
به عنوان
الگو.
هرگونه
نویسهٔ
تطبیقی خاص
(glob) در نام
فایل هنگام
نوشتن در
پروندهٔ
.gitattributes
اسکیپ
می‌شود.
-l, --lockable
مسیرها
را «قابل
قفل شدن» ('lockable')
می‌کند، به
این معنی که
برای
ویرایش
آن‌ها باید
قفل شوند و
در صورت قفل
نبودن، در
نسخهٔ کاری
به‌صورت
فقط‌خواندنی
درمی‌آیند.
--not-lockable
نشان (flag)
قابل قفل
شدن را از
مسیرها حذف
می‌کند تا
دیگر در
صورت قفل
نبودن
به‌صورت
فقط‌خواندنی
نباشند.
--no-excluded
الگوهایی
را که در
خروجی
مستثنی
شده‌اند
فهرست
نمی‌کند؛
تنها
الگوهایی
را که
ردگیری
می‌شوند
فهرست
می‌کند.
--no-modify-attrs
مدخل‌های
مطابقت‌یافته
را از نظر
وضعیت کثیف
(stat-dirty) می‌کند تا
گیت بتواند
فایل‌هایی
را که مایل
به تبدیل به LFS
هستید
مجدداً
نمایه (re-index) کند.
هیچ فایل
.gitattributes را
تغییر
نمی‌دهد.
•فهرست
کردن
الگوهایی
که در حال
حاضر توسط Git LFS
ردگیری
می‌شوند:
git lfs track
•پیکربندی
Git LFS برای
ردگیری
فایل‌های GIF:
git lfs track "*.gif"
•پیکربندی
Git LFS برای
ردگیری
فایل‌های PSD و
قرار دادن
آن‌ها در
حالت
فقط‌خواندنی
مگر در صورت
قفل بودن:
git lfs track --lockable
"*.psd"
•پیکربندی
Git LFS برای
ردگیری
فایلی به
نام
project [1].psd:
git lfs track --filename "project
[1].psd"
git-lfs-untrack(1), git-lfs-install(1), gitattributes(5),
gitignore(5).
بخشی از
مجموعهٔ git-lfs(1).
