'\" t
.\"     Title: git-lfs-fetch
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "GIT\-LFS\-FETCH" "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-fetch \- بارگیری تمام فایل‌های Git LFS برای یک ارجاع (ref) مشخص
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.fam C
\fBgit lfs fetch\fP [\fIoptions\fP] [\fI<remote>\fP [\fI<ref>\fP...]]
\fBgit lfs fetch\fP [\fIoptions\fP] \fI<remote>\fP \fB\-\-stdin\fP
.fam
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
اشیای Git LFS را در ارجاع‌های (refs) مشخص‌شده از مخزن دوردست (remote) تعیین‌شده بارگیری می‌کند\&. برای بررسی آنچه در صورت عدم تعیین رخ می‌دهد، بخش‌های «مخزن دوردست پیش‌فرض (DEFAULT REMOTE)» و «ارجاع‌های پیش‌فرض (DEFAULT REFS)» را ببینید\&.
.sp
این دستور نسخهٔ کاری را به‌روزرسانی نمی‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
\f(CR\-I <paths>\fP, \f(CR\-\-include=<paths>\fP
.RS 4
تعیین مقدار \f(CRlfs.fetchinclude\fP صرفاً برای همین اجرا؛ بخش «شمول و عدم شمول (INCLUDE AND EXCLUDE)» را ببینید\&.
.RE
.sp
\f(CR\-X <paths>\fP, \f(CR\-\-exclude=<paths>\fP
.RS 4
تعیین مقدار \f(CRlfs.fetchexclude\fP صرفاً برای همین اجرا؛ بخش «شمول و عدم شمول (INCLUDE AND EXCLUDE)» را ببینید\&.
.RE
.sp
\f(CR\-r\fP, \f(CR\-\-recent\fP
.RS 4
بارگیری اشیایی که علاوه بر مواردی که در حالت معمول بارگیری می‌شدند، توسط شاخه‌ها و کامیت‌های اخیر ارجاع داده شده‌اند\&. بخش «تغییرات اخیر (RECENT CHANGES)» را ببینید\&.
.RE
.sp
\f(CR\-a\fP, \f(CR\-\-all\fP
.RS 4
بارگیری تمام اشیایی که توسط هر کامیتی که از ارجاع‌های داده‌شده به عنوان آرگومان قابل دسترسی است، ارجاع داده شده‌اند\&. اگر هیچ ارجاعی ارائه نشود، تمام ارجاع‌ها واکشی می‌شوند\&. این گزینه در درجهٔ اول برای مقاصد پشتیبان‌گیری و مهاجرت است\&. این گزینه نمی‌تواند با
\f(CR\-\-recent\fP
یا
\f(CR\-\-include\fP/\f(CR\-\-exclude\fP
ترکیب شود\&. برای اطمینان از بارگیری تمام اشیا، هرگونه مسیر شمول و عدم شمول که به صورت سراسری پیکربندی شده است نادیده گرفته می‌شود\&.
.RE
.sp
\f(CR\-\-stdin\fP
.RS 4
خواندن فهرستی از ارجاع‌های جداشده با خط جدید از ورودی استاندارد به جای خط فرمان\&.
.RE
.sp
\f(CR\-p\fP, \f(CR\-\-prune\fP
.RS 4
هرس کردن اشیای قدیمی و بدون ارجاع پس از واکشی، معادل اجرای دستور \f(CRgit lfs prune\fP پس از آن\&. برای جزئیات بیشتر به git\-lfs\-prune(1) مراجعه کنید\&.
.RE
.sp
\f(CR\-\-refetch\fP
.RS 4
واکشی مجدد اشیایی که از پیش به صورت محلی موجود هستند\&.
.RE
.sp
\f(CR\-d\fP, \f(CR\-\-dry\-run\fP
.RS 4
چاپ مواردی که واکشی خواهند شد، بدون اینکه عملاً چیزی واکشی شود\&.
.RE
.sp
\f(CR\-j\fP, \f(CR\-\-json\fP
.RS 4
در صورتی که دستور با موفقیت خارج شود، جزئیات تمام درخواست‌های انتقال اشیا را به صورت JSON در خروجی استاندارد (STDOUT) می‌نویسد\&. این گزینه برای تعامل با ابزارهای خارجی در نظر گرفته شده است\&. هنگامی که \f(CR\-\-dry\-run\fP نیز مشخص شده باشد، جزئیات انتقال‌هایی را می‌نویسد که در صورت واکشی اشیا انجام می‌شد\&.
.RE
.SH "شمول و عدم شمول (INCLUDE AND EXCLUDE)"
.sp
می‌توانید Git LFS را به‌گونه‌ای پیکربندی کنید که فقط اشیا را برای برآورده کردن ارجاع‌ها در مسیرهای خاصی از مخزن واکشی کند، و/یا مسیرهای خاصی از مخزن را مستثنی کنید، تا مدت زمانی که صرف بارگیری مواردی می‌کنید که استفاده نمی‌کنید کاهش یابد\&.
.sp
در پیکربندی گیت خود یا در یک فایل \f(CR.lfsconfig\fP، می‌توانید یکی یا هر دوی \f(CRlfs.fetchinclude\fP و \f(CRlfs.fetchexclude\fP را با فهرست‌هایی از مسیرها که با کاما از هم جدا شده‌اند مقداردهی کنید\&. اگر \f(CRlfs.fetchinclude\fP تعریف شده باشد، اشیای Git LFS تنها در صورتی واکشی می‌شوند که مسیر آن‌ها با یکی از مسیرهای آن فهرست مطابقت داشته باشد، و اگر \f(CRlfs.fetchexclude\fP تعریف شده باشد، اشیای Git LFS تنها در صورتی واکشی خواهند شد که مسیر آن‌ها با هیچ‌یک از مسیرهای آن فهرست مطابقت نداشته باشد\&. تطبیق مسیرها با استفاده از الگوهای وایلدکارد طبق gitignore(5) انجام می‌شود\&.
.sp
توجه داشته باشید که استفاده از گزینه‌های خط فرمان \f(CR\-I\fP و \f(CR\-X\fP بر تنظیمات پیکربندی مربوطه اولویت دارد\&. تنظیم هر یک از گزینه‌ها با یک رشتهٔ خالی مقدار آن را پاک می‌کند\&.
.SS "مثال‌ها (Examples)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRgit config lfs.fetchinclude "textures,images/foo*"\fP
.sp
این تنظیم فقط اشیای ارجاع داده شده در مسیرهای پوشهٔ textures و فایل‌های با نام *foo در پوشهٔ images را واکشی می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRgit config lfs.fetchinclude "\fB.jpg,\fP.png,*.tga"\fP\fR
.sp
فقط فایل‌های JPG/PNG/TGA در هر جای مخزن که باشند واکشی می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRgit config lfs.fetchexclude "media/reallybigfiles"\fP
.sp
هیچ یک از اشیای LFS ارجاع داده شده در پوشهٔ media/reallybigfiles را واکشی نمی‌کند، اما همهٔ موارد دیگر را واکشی می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRgit config lfs.fetchinclude "media"\fP
.br
\f(CRgit config lfs.fetchexclude "media/excessive"\fP
.sp
فقط اشیای LFS موجود در پوشهٔ \*(Aqmedia\*(Aq را واکشی می‌کند، اما اشیای موجود در یکی از زیرپوشه‌های آن را مستثنی می‌سازد\&.
.RE
.SH "مخزن دوردست پیش‌فرض (DEFAULT REMOTE)"
.sp
بدون آرگومان، دستور fetch از مخزن دوردست پیش‌فرض بارگیری می‌کند\&. مخزن دوردست پیش‌فرض همانند \f(CRgit fetch\fP است، یعنی در درجهٔ اول بر اساس شاخهٔ دوردستی که ردیابی می‌کنید، یا در غیر این صورت origin خواهد بود\&.
.SH "ارجاع‌های پیش‌فرض (DEFAULT REFS)"
.sp
اگر هیچ ارجاعی به عنوان آرگومان داده نشود، از ارجاع فعلی که تحویل گرفته شده (checked out) استفاده می‌شود\&. علاوه بر این، در صورت فعال بودن، ارجاع‌ها و کامیت‌های اخیراً تغییریافته نیز گنجانده می‌شوند\&. برای جزئیات به «تغییرات اخیر (RECENT CHANGES)» مراجعه کنید\&.
.SH "تغییرات اخیر (RECENT CHANGES)"
.sp
اگر گزینهٔ \f(CR\-\-recent\fP مشخص شده باشد، یا اگر گزینهٔ gitconfig به نام \f(CRlfs.fetchrecentalways\fP برابر با true باشد، آن‌گاه پس از واکشی ارجاع فعلی (یا موارد موجود در آرگومان‌ها)، برای تغییرات «اخیر» نیز جستجو می‌کنیم تا اشیای آن‌ها واکشی شوند، تا تحویل گرفتن یا ایجاد diff برای آن کامیت‌ها بدون تحمیل بارگیری‌های بیشتر راحت‌تر باشد\&.
.sp
اینکه چه تغییراتی «اخیر» محسوب می‌شوند بر اساس تعدادی از گزینه‌های gitconfig تعیین می‌گردد:
.sp
\f(CRlfs.fetchrecentrefsdays\fP
.RS 4
در صورت غیرصفر بودن، شاخه‌هایی را که دارای کامیت‌هایی در بازهٔ N روز از تاریخ فعلی هستند شامل می‌شود\&. تنها ارجاع‌های محلی گنجانده می‌شوند مگر آنکه lfs.fetchrecentremoterefs برابر با true باشد\&. مقدار پیش‌فرض 7 روز است\&.
.RE
.sp
\f(CRlfs.fetchrecentremoterefs\fP
.RS 4
اگر true باشد، ارجاع‌های دوردست (برای مخزن دوری که از آن واکشی می‌کنید) و همچنین ارجاع‌های محلی در پنجرهٔ اخیر را واکشی می‌کند\&. این قابلیت برای واکشی اشیا برای شاخه‌های دوردستی که ممکن است بعداً بخواهید تحویل بگیرید مفید است\&. مقدار پیش‌فرض true است؛ اگر آن را روی false تنظیم کنید، واکشی برای آن شاخه‌ها تنها زمانی رخ می‌دهد که یا آن‌ها را تحویل بگیرید (که مزیت fetch \-\-recent را از بین می‌برد)، یا یک شاخهٔ محلی ردیاب را به طور جداگانه ایجاد کرده و سپس دوباره واکشی را انجام دهید\&.
.RE
.sp
\f(CRlfs.fetchrecentcommitsdays\fP
.RS 4
علاوه بر واکشی در شاخه‌ها، تغییرات ایجادشده در بازهٔ N روز از آخرین کامیت روی شاخه را نیز واکشی می‌کند\&. اگر معمولاً تغییرات اخیر را بازبینی می‌کنید این گزینه مفید است\&. مقدار پیش‌فرض 0 است (بدون تغییرات قبلی)\&.
.RE
.sp
\f(CRlfs.fetchrecentalways\fP
.RS 4
همیشه به گونه‌ای رفتار می‌کند که گویی \-\-recent در خط فرمان مشخص شده است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی اشیای LFS برای ارجاع فعلی از مخزن دوردست پیش‌فرض
.sp
\f(CRgit lfs fetch\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی اشیای LFS برای ارجاع فعلی و تغییرات اخیر از مخزن دوردست پیش‌فرض
.sp
\f(CRgit lfs fetch \-\-recent\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی اشیای LFS برای ارجاع فعلی از یک مخزن دوردست ثانویه با نام \*(Aqupstream\*(Aq
.sp
\f(CRgit lfs fetch upstream\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی تمام اشیای LFS از مخزن دوردست پیش‌فرض که توسط هر کامیتی در شاخه‌های \f(CRmain\fP و \f(CRdevelop\fP ارجاع داده شده‌اند
.sp
\f(CRgit lfs fetch \-\-all origin main develop\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی اشیای LFS برای یک شاخه از origin
.sp
\f(CRgit lfs fetch origin mybranch\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
واکشی اشیای LFS برای ۲ شاخه و یک کامیت از origin
.sp
\f(CRgit lfs fetch origin main mybranch e445b45c1c9c6282614f201b62778e4c0688b5c8\fP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
git\-lfs\-checkout(1), git\-lfs\-pull(1), git\-lfs\-prune(1), gitconfig(5).
.sp
بخشی از مجموعهٔ git\-lfs(1)\&.