'\" t
.\"     Title: git-lfs-checkout
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GIT\-LFS\-CHECKOUT" "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-checkout \- به‌روزرسانی نسخه کاری با محتوای فایل‌ها در صورت موجود بودن
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.fam C
\fBgit lfs checkout\fP [\fI<glob\-pattern>\fP...]
\fBgit lfs checkout \-\-to\fP \fI<file>\fP {\fB\-\-base\fP|\fB\-\-ours\fP|\fB\-\-theirs\fP} \fI<conflict\-obj\-path>\fP
.fam
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
تلاش می‌کند تا اطمینان حاصل کند که رونوشت کاری (working copy) حاوی محتوای فایل‌های اشیاء Git LFS برای ارجاع (ref) جاری است، در صورتی که داده‌های شیء در دسترس باشند. این دستور هیچ محتوایی را دانلود نمی‌کند؛ برای این منظور به git\-lfs\-fetch(1) مراجعه کنید.
.sp
دستور Checkout ارجاع جاری را برای تمام اشیاء LFS مورد نیاز بررسی می‌کند؛ سپس در جاهایی که یک فایل در نسخه کاری وجود ندارد یا شامل محتوای اشاره‌گر موقت با همان شناسه SHA است، در صورتی که شیء در مخزن محلی موجود باشد محتوای واقعی فایل نوشته می‌شود. فایل‌های تغییریافته هرگز بازنویسی نخواهند شد.
.sp
می‌توان یک یا چند آرگومان \f(CR<glob\-pattern>\fP را برای محدود کردن مجموعه فایل‌هایی که به‌روزرسانی می‌شوند مشخص کرد. الگوهای گلوب مطابق با ساختار شرح‌داده‌شده در gitignore(5) تطبیق داده می‌شوند.
.sp
هنگامی که همراه با \f(CR\-\-to\fP استفاده شود و درخت کاری به دلیل ادغام در وضعیت تداخل باشد، این گزینه یکی از سه مرحله شیء دارای تداخل Git LFS را در یک فایل جداگانه (که می‌تواند خارج از درخت کاری باشد) استخراج می‌کند. این ویژگی استفاده از ابزارهای diff را برای بررسی و حل تداخل ادغام‌ها آسان‌تر می‌سازد. مسیر فایل یک شیء منفرد Git LFS باید در \f(CR<conflict\-obj\-path>\fP ارائه شود. اگر \f(CR<file>\fP از قبل وجود داشته باشد (چه به صورت فایل معمولی، پیوند نمادین، یا دایرکتوری)، حذف و جایگزین خواهد شد، مگر اینکه یک پوشه غیرخالی باشد یا امکان حذف آن وجود نداشته باشد.
.sp
اگر نسخه گیت نصب‌شده حداقل 2.42.0 باشد، این دستور به‌طور پیش‌فرض اشیاء Git LFS را برای فایل‌ها فقط در صورتی استخراج می‌کند که در ایندکس گیت حضور داشته باشند و با صفت فیلتر Git LFS از فایل \f(CR.gitattributes\fP موجود در ایندکس یا درخت کاری فعلی مطابقت داشته باشند (یا طبق معمول، اگر با یک صفت فیلتر Git LFS در یک فایل محلی \f(CRgitattributes\fP مانند \f(CR$GIT_DIR/info/attributes\fP تطابق داشته باشند). این محدودیت‌ها در نسخه‌های پیشین گیت اعمال نمی‌شوند.
.sp
بنابراین در مخزنی با شبیه‌سازی جزئی یا checkout تنک (sparse)، در صورت نصب بودن Git نسخه 2.42.0 یا جدیدتر، توصیه می‌شود پیش از استفاده از این دستور، تمامی فایل‌های \f(CR.gitattributes\fP را از \f(CRHEAD\fP دریافت و استخراج کنید. از طرف دیگر، متغیر محیطی \f(CRGIT_ATTR_SOURCE\fP می‌تواند بر روی \f(CRHEAD\fP تنظیم شود که موجب می‌شود گیت مشخصه‌ها را منحصراً از فایل‌های \f(CR.gitattributes\fP در \f(CRHEAD\fP بخواند و موارد موجود در ایندکس یا درخت کاری را نادیده بگیرد.
.sp
در یک مخزن خام (bare)، این دستور هیچ اثری ندارد. در نسخه‌های آینده، ممکن است این دستور در صورت اجرا در یک مخزن bare با خطا خارج شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\f(CR\-\-base\fP
.RS 4
پایه ادغام (merge base) فایل مشخص‌شده را استخراج می‌کند.
.RE
.sp
\f(CR\-\-ours\fP
.RS 4
سمت ما (مربوط به شاخه جاری) از تداخل را برای فایل مشخص‌شده استخراج می‌کند.
.RE
.sp
\f(CR\-\-theirs\fP
.RS 4
سمت آن‌ها (مربوط به شاخه دیگر) از تداخل را برای فایل مشخص‌شده استخراج می‌کند.
.RE
.sp
\f(CR\-\-to <path>\fP
.RS 4
اگر درخت کاری در وضعیت تداخل باشد، بخشی از تداخل را که توسط \f(CR\-\-base\fP، \f(CR\-\-ours\fP یا \f(CR\-\-theirs\fP مشخص شده است در مسیر داده‌شده استخراج می‌کند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
استخراج تمامی فایل‌های مفقود یا دارای اشاره‌گر موقت:
.RE
.sp
.if n .RS 4
.nf
.fam C
$ git lfs checkout
.fam
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
استخراج چند فایل مشخص:
.RE
.sp
.if n .RS 4
.nf
.fam C
$ git lfs checkout path/to/file1.png path/to.file2.png
.fam
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
استخراج مسیر دارای تداخل ادغام در فایل‌های مجزا:
.RE
.sp
.if n .RS 4
.nf
.fam C
# تلاش برای ادغام با شاخه‌ای که تداخل ادغام دارد
$ git merge conflicting\-branch
CONFLICT (content): Merge conflict in path/to/conflicting/file.dat

# استخراج نسخه‌های فایل متداخل در فایل‌های موقت
$ git lfs checkout \-\-to ours.dat \-\-ours path/to/conflicting/file.dat
$ git lfs checkout \-\-to theirs.dat \-\-theirs path/to/conflicting/file.dat

# مقایسه نسخه‌های متداخل در ours.dat و theirs.dat،
# سپس حل تداخل (مثلاً با انتخاب یک نسخه یا ساخت نسخه جدید)

# پاک‌سازی و ادامه ادغام
$ rm ours.dat theirs.dat
$ git add path/to/conflicting/file.dat
$ git merge \-\-continue
.fam
.fi
.if n .RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
git\-lfs\-fetch(1), git\-lfs\-pull(1), gitattributes(5), gitignore(5).
.sp
بخشی از مجموعه ابزارهای git\-lfs(1).