GIT-LFS-TRACK(1)                                              GIT-LFS-TRACK(1)

نام (NAME)
       git-lfs-track - مشاهده یا افزودن مسیرهای Git LFS به ویژگی‌های گیت (Git
       attributes)

خلاصه دستور (SYNOPSIS)
       git lfs track [options] [<pattern>...]

توضیحات (DESCRIPTION)
       ردگیری الگوی(های) داده‌شده را از طریق Git LFS آغاز می‌کند. این آرگومان در
       فایل .gitattributes نوشته می‌شود. اگر هیچ مسیری ارائه نشود، صرفاً فهرست
       مسیرهای در حال ردگیری فعلی نمایش داده می‌شود.

       طبق مستندات gitattributes <https://git-scm.com/docs/gitattributes>
       الگوها از قوانین الگوی gitignore <https://git-scm.com/docs/gitignore>
       برای تطبیق مسیرها استفاده می‌کنند. این بدان معناست که با الگوهای حاوی
       ستاره (*)، علامت سؤال (?) و نویسه‌های براکت ([ و ]) به‌صورت ویژه برخورد
       می‌شود؛ برای غیرفعال کردن این رفتار و برخورد عینی با آن‌ها، از گزینهٔ
       --filename استفاده کنید یا نویسه را با یک بک‌اسلش اسکیپ نمایید.

گزینه‌ها (OPTIONS)
       -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 را تغییر نمی‌دهد.

مثال‌ها (EXAMPLES)
       •   فهرست کردن الگوهایی که در حال حاضر توسط 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"

همچنین ببینید (SEE ALSO)
       git-lfs-untrack(1), git-lfs-install(1), gitattributes(5), gitignore(5).

       بخشی از مجموعهٔ git-lfs(1).

                                                              GIT-LFS-TRACK(1)