'\" t
.\"     Title: git-clone
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-CLONE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-clone \- کلون کردن یک مخزن درون یک دایرکتوری جدید
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBclone\fR [\fB\-\-template=\fR\fI<template\-directory>\fR]
          [\fB\-l\fR] [\fB\-s\fR] [\fB\-\-no\-hardlinks\fR] [\fB\-q\fR] [\fB\-n\fR] [\fB\-\-bare\fR] [\fB\-\-mirror\fR]
          [\fB\-o\fR \fI<name>\fR] [\fB\-b\fR \fI<name>\fR] [\fB\-u\fR \fI<upload\-pack>\fR] [\fB\-\-reference\fR \fI<repository>\fR]
          [\fB\-\-dissociate\fR] [\fB\-\-separate\-git\-dir\fR \fI<git\-dir>\fR]
          [\fB\-\-depth\fR \fI<depth>\fR] [\fB\-\-\fR[\fBno\-\fR]\fBsingle\-branch\fR] [\fB\-\-\fR[\fBno\-\fR]\fBtags\fR]
          [\fB\-\-recurse\-submodules\fR[\fB=\fR\fI<pathspec>\fR]] [\fB\-\-\fR[\fBno\-\fR]\fBshallow\-submodules\fR]
          [\fB\-\-\fR[\fBno\-\fR]\fBremote\-submodules\fR] [\fB\-\-jobs\fR \fI<n>\fR] [\fB\-\-sparse\fR] [\fB\-\-\fR[\fBno\-\fR]\fBreject\-shallow\fR]
          [\fB\-\-filter=\fR\fI<filter\-spec>\fR [\fB\-\-also\-filter\-submodules\fR]] [\fB\-\-\fR] \fI<repository>\fR
          [\fI<directory>\fR]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
یک مخزن را درون یک دایرکتوری تازه‌ساخته‌شده کلون می‌کند، برای هر شاخه در مخزن کلون‌شده شاخه‌های ردگیری دوردست (قابل مشاهده با \fBgit\fR \fBbranch\fR \fB\-\-remotes\fR) می‌سازد، و یک شاخه اولیه منشعب‌شده از شاخه فعال فعلی مخزن کلون‌شده را ایجاد و دریافت (checkout) می‌کند\&.
.sp
پس از انجام کلون، یک دستور ساده \fBgit\fR \fBfetch\fR بدون آرگومان تمام شاخه‌های ردگیری دوردست را به‌روزرسانی می‌کند، و یک دستور \fBgit\fR \fBpull\fR بدون آرگومان علاوه بر آن، در صورت وجود شاخه اصلی (master/main) دوردست، آن را با شاخه اصلی محلی فعلی ادغام می‌کند (هنگامی که گزینه \fB\-\-single\-branch\fR داده شود این امر صادق نیست؛ در ادامه را ببینید)\&.
.sp
این پیکربندی پیش‌فرض با ایجاد مراجعی به سرشاخه‌های دوردست در زیرمسیر \fBrefs/remotes/origin\fR و با مقداردهی اولیه متغیرهای پیکربندی \fBremote\&.origin\&.url\fR و \fBremote\&.origin\&.fetch\fR حاصل می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-l\fR, \fB\-\-local\fR
.RS 4
هنگامی که مخزن مورد نظر برای کلون روی ماشین محلی قرار دارد، این فلگ سازوکار معمول انتقال «آگاه از گیت» را دور می‌زند و مخزن را با ایجاد کپی از
\fBHEAD\fR
و هر آنچه در زیر دایرکتوری‌های objects و refs قرار دارد کلون می‌کند\&. فایل‌های زیر دایرکتوری
\fB\&.git/objects/\fR
در صورت امکان برای صرفه‌جویی در فضا پیوند سخت (hardlink) می‌شوند\&.
.sp
اگر مخزن به‌صورت یک مسیر محلی مشخص شود (مانند
\fB/path/to/repo\fR)،
این حالت پیش‌فرض است و گزینه
\fB\-\-local\fR
اساساً اثری ندارد (no\-op)\&. اگر مخزن به‌صورت یک نشانی (URL) مشخص شده باشد، این فلگ نادیده گرفته می‌شود (و ما هرگز از بهینه‌سازی‌های محلی استفاده نمی‌کنیم)\&. مشخص کردن
\fB\-\-no\-local\fR
هنگام ارائه مسیر
\fB/path/to/repo\fR
حالت پیش‌فرض را لغو می‌کند و در عوض از سازوکار انتقال معمول گیت استفاده می‌نماید\&.
.sp
اگر
\fB$GIT_DIR/objects\fR
مخزن حاوی پیوندهای نمادین باشد یا خود یک پیوند نمادین باشد، کلون با شکست مواجه خواهد شد\&. این یک اقدام امنیتی برای جلوگیری از کپی ناخواسته فایل‌ها با دنبال کردن پیوندهای نمادین است\&.
.sp
این گزینه به دلایل امنیتی روی مخازنی که متعلق به سایر کاربران هستند کار نمی‌کند، و برای اینکه عملیات کلون با موفقیت انجام شود، باید گزینه
\fB\-\-no\-local\fR
مشخص گردد\&.
.sp
\fBنکته\fR: این عملیات ممکن است با اصلاحات هم‌زمان در مخزن مبدأ دچار شرایط رقابتی (race) شود، درست مانند اجرای دستور
\fBcp\fR
\fB\-r\fR
\fI<src>\fR
\fI<dst>\fR
در حالی که
\fI<src>\fR
در حال تغییر است\&.
.RE
.PP
\fB\-\-no\-hardlinks\fR
.RS 4
فرآیند کلون از یک مخزن روی سامانه فایل محلی را وادار می‌کند تا فایل‌های زیر دایرکتوری
\fB\&.git/objects\fR
را به جای استفاده از پیوندهای سخت کپی کند\&. این کار در صورتی که در تلاش برای تهیه نسخه پشتیبان از مخزن خود باشید می‌تواند مفید باشد\&.
.RE
.PP
\fB\-s\fR, \fB\-\-shared\fR
.RS 4
هنگامی که مخزن مورد نظر برای کلون روی ماشین محلی قرار دارد، به جای استفاده از پیوندهای سخت، به‌طور خودکار فایل
\fB\&.git/objects/info/alternates\fR
را برای به اشتراک‌گذاری اشیاء با مخزن مبدأ تنظیم می‌کند\&. مخزن حاصل در ابتدا هیچ شیء اختصاصی از خود ندارد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
این یک عملیات بالقوه خطرناک است؛ از آن استفاده
\fBنکنید\fR
مگر اینکه کاملاً متوجه کارکرد آن باشید\&. اگر مخزن خود را با این گزینه کلون کنید و سپس در مخزن مبدأ شاخه‌هایی را حذف کنید (یا هر دستور گیت دیگری را اجرا کنید که هر کامیت موجودی را بدون ارجاع کند)، ممکن است برخی از اشیاء بدون ارجاع (یا آویزان) شوند\&. این اشیاء ممکن است توسط عملیات عادی گیت (مانند
\fBgit\fR
\fBcommit\fR)
که به‌طور خودکار دستور
\fBgit\fR
\fBmaintenance\fR
\fBrun\fR
\fB\-\-auto\fR
را فراخوانی می‌کنند حذف شوند\&. (نگاه کنید به
\fBgit-maintenance\fR(1)\&.)
اگر این اشیاء حذف شوند و توسط مخزن کلون‌شده ارجاع داده شده باشند، مخزن کلون‌شده آسیب دیده و خراب خواهد شد\&.
.sp .5v
.RE
توجه داشته باشید که اجرای دستور
\fBgit\fR
\fBrepack\fR
بدون گزینه
\fB\-\-local\fR
در مخزنی که با
\fB\-\-shared\fR
کلون شده است، اشیاء را از مخزن مبدأ درون یک بسته (pack) در مخزن کلون‌شده کپی می‌کند و صرفه‌جویی فضای دیسک ناشی از
\fBclone\fR
\fB\-\-shared\fR
را خنثی می‌سازد\&. با این حال، اجرای دستور
\fBgit\fR
\fBgc\fR
که به‌طور پیش‌فرض از گزینه
\fB\-\-local\fR
استفاده می‌کند، ایمن است\&.
.sp
اگر می‌خواهید وابستگی مخزنی را که با
\fB\-\-shared\fR
کلون شده به مخزن مبدأ آن قطع کنید، می‌توانید به سادگی دستور
\fBgit\fR
\fBrepack\fR
\fB\-a\fR
را اجرا کنید تا تمام اشیاء از مخزن مبدأ به درون یک بسته در مخزن کلون‌شده کپی شوند\&.
.RE
.PP
\fB\-\-reference=\fR\fI<repository>\fR, \fB\-\-reference\-if\-able=\fR\fI<repository>\fR
.RS 4
اگر مخزن مرجع
\fI<repository>\fR
روی ماشین محلی باشد، به‌طور خودکار فایل
\fB\&.git/objects/info/alternates\fR
را برای دریافت اشیاء از مخزن مرجع
\fI<repository>\fR
تنظیم می‌کند\&. استفاده از یک مخزن موجود به‌عنوان جایگزین، به کپی شدن اشیاء کمتری از مخزن در حال کلون نیاز خواهد داشت و هزینه‌های شبکه و فضای ذخیره‌سازی محلی را کاهش می‌دهد\&. هنگام استفاده از
\fB\-\-reference\-if\-able\fR،
در صورت عدم وجود دایرکتوری، به جای متوقف کردن عملیات کلون، صرفاً با یک هشدار از آن صرف‌نظر می‌شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
نکته مربوط به گزینه
\fB\-\-shared\fR
و همچنین گزینه
\fB\-\-dissociate\fR
را ببینید\&.
.sp .5v
.RE
.RE
.PP
\fB\-\-dissociate\fR
.RS 4
اشیاء را از مخازن مرجع مشخص‌شده با گزینه‌های
\fB\-\-reference\fR
تنها به منظور کاهش انتقال داده‌های شبکه قرض می‌گیرد، و پس از اتمام کلون با ایجاد کپی‌های محلی لازم از اشیاء قرض‌گرفته‌شده، قرض گرفتن از آن‌ها را متوقف می‌کند\&. این گزینه همچنین می‌تواند هنگام کلون محلی از مخزنی استفاده شود که خود اشیاء را از مخزن دیگری قرض می‌گیرد \(em مخزن جدید اشیاء را از همان مخزن قرض خواهد گرفت، و این گزینه می‌تواند برای متوقف کردن این قرض‌گیری به کار رود\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
عملیات را بدون سر و صدا انجام می‌دهد\&. وضعیت پیشرفت به جریان خطای استاندارد گزارش نمی‌شود\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
با جزئیات کامل اجرا می‌شود\&. تأثیری بر گزارش وضعیت پیشرفت در جریان خطای استاندارد ندارد\&.
.RE
.PP
\fB\-\-progress\fR
.RS 4
هنگامی که خروجی به یک ترمینال متصل باشد، وضعیت پیشرفت به‌طور پیش‌فرض در جریان خطای استاندارد گزارش می‌شود، مگر اینکه
\fB\-\-quiet\fR
مشخص شده باشد\&. این فلگ نمایش وضعیت پیشرفت را حتی اگر جریان خطای استاندارد به ترمینال هدایت نشده باشد اجباری می‌کند\&.
.RE
.PP
\fB\-\-server\-option=\fR\fI<option>\fR
.RS 4
هنگام برقراری ارتباط با استفاده از نسخه ۲ پروتکل، رشته داده‌شده را به سرور منتقل می‌کند\&. رشته ارائه‌شده نباید حاوی نویسه
\fINUL\fR
یا
\fILF\fR
باشد\&. نحوه رفتار سرور با گزینه‌های سرور، از جمله گزینه‌های ناشناخته، وابسته به سرور است\&. هنگامی که چند گزینه
\fB\-\-server\-option=\fR\fI<option>\fR
داده شود، همگی به ترتیبی که در خط فرمان ذکر شده‌اند به طرف دیگر ارسال می‌شوند\&. هنگامی که هیچ
\fB\-\-server\-option=\fR\fI<option>\fR
در خط فرمان مشخص نشده باشد، در عوض مقادیر متغیر پیکربندی
\fBremote\&.\fR\fI<name>\fR\fB\&.serverOption\fR
به کار می‌روند\&.
.RE
.PP
\fB\-n\fR, \fB\-\-no\-checkout\fR
.RS 4
پس از اتمام کلون،
\fBHEAD\fR
را دریافت (checkout) نمی‌کند\&.
.RE
.PP
\fB\-\-no\-reject\-shallow\fR, \fB\-\-reject\-shallow\fR
.RS 4
اگر مخزن مبدأ یک مخزن کم‌عمق باشد، عملیات با شکست مواجه می‌شود\&. از متغیر پیکربندی
\fBclone\&.rejectShallow\fR
می‌توان برای تعیین حالت پیش‌فرض استفاده کرد\&.
.RE
.PP
\fB\-\-bare\fR
.RS 4
یک مخزن گیت لخت یا تهی (\fIbare\fR) ایجاد می‌کند\&. بدین معنا که به جای ایجاد دایرکتوری
\fI<directory>\fR
و قرار دادن فایل‌های مدیریتی در
\fI<directory>\fR\fB/\&.git\fR،
خود
\fI<directory>\fR
را به
\fB$GIT_DIR\fR
تبدیل می‌کند\&. این گزینه آشکارا متضمن
\fB\-\-no\-checkout\fR
است زیرا جایی برای دریافت درخت کاری وجود ندارد\&. همچنین سرشاخه‌ها در سرور دوردست مستقیماً در سرشاخه‌های محلی متناظر کپی می‌شوند، بدون اینکه به
\fBrefs/remotes/origin/\fR
نگاشت شوند\&. هنگام استفاده از این گزینه، نه شاخه‌های ردگیری دوردست و نه متغیرهای پیکربندی مرتبط ایجاد نمی‌شوند\&.
.RE
.PP
\fB\-\-sparse\fR
.RS 4
از دریافت تنک (sparse\-checkout) استفاده می‌کند، به طوری که در ابتدا تنها فایل‌های موجود در بالاترین سطح دایرکتوری حضور دارند\&. از دستور
\fBgit-sparse-checkout\fR(1)
می‌توان برای گسترش دایرکتوری کاری بر حسب نیاز استفاده کرد\&.
.RE
.PP
\fB\-\-filter=\fR\fI<filter\-spec>\fR
.RS 4
از قابلیت کلون جزئی (partial clone) بهره می‌گیرد و درخواست می‌کند که سرور زیرمجموعه‌ای از اشیاء قابل دسترس را بر اساس یک فیلتر اشیاء داده‌شده ارسال کند\&. هنگام استفاده از
\fB\-\-filter\fR،
مقدار مشخص‌شده در
\fI<filter\-spec>\fR
برای فیلتر کلون جزئی استفاده می‌شود\&.
.sp
اگر
\fB\-\-filter=auto\fR
استفاده شود، مشخصات فیلتر به‌طور خودکار از طریق پروتکل
\fIpromisor\-remote\fR
(نگاه کنید به
\fBgitprotocol-v2\fR(5))
با ترکیب مشخصات فیلتر اعلام‌شده توسط سرور برای مخازن دوردست ضامن (promisor remotes) که کلاینت می‌پذیرد (گزینه پیکربندی
\fBpromisor\&.acceptFromServer\fR
در
\fBgit-config\fR(1)
را ببینید) تعیین می‌گردد\&. این به سرور اجازه می‌دهد تا فیلتر بهینه را برای مخازن دوردست ضامن موجود پیشنهاد دهد\&.
.sp
مانند سایر مشخصات فیلتر، مقدار "auto" در پیکربندی ذخیره و ماندگار می‌شود\&. این تضمین می‌کند که واکشی‌های آینده همچنان با پیشنهاد فعلی سرور سازگار شوند\&.
.sp
برای جزئیات مربوط به تمام مشخصات فیلتر موجود، گزینه
\fB\-\-filter=\fR\fI<filter\-spec>\fR
در
\fBgit-rev-list\fR(1)
را ببینید\&.
.sp
برای نمونه،
\fB\-\-filter=blob:none\fR
تمام blobها (محتویات فایل‌ها) را تا زمانی که گیت به آن‌ها نیاز پیدا کند فیلتر می‌کند\&. همچنین،
\fB\-\-filter=blob:limit=\fR\fI<size>\fR
تمام blobهای با اندازه دست‌کم
\fI<size>\fR
را فیلتر می‌کند\&.
.RE
.PP
\fB\-\-also\-filter\-submodules\fR
.RS 4
فیلتر کلون جزئی را روی تمامی زیرماژول‌های موجود در مخزن نیز اعمال می‌کند\&. نیازمند
\fB\-\-filter\fR
و
\fB\-\-recurse\-submodules\fR
است\&. این گزینه می‌تواند با تنظیم گزینه پیکربندی
\fBclone\&.filterSubmodules\fR
به‌طور پیش‌فرض فعال شود\&.
.RE
.PP
\fB\-\-mirror\fR
.RS 4
یک آینه (mirror) از مخزن مبدأ راه‌اندازی می‌کند\&. این گزینه متضمن
\fB\-\-bare\fR
است\&. در مقایسه با
\fB\-\-bare\fR،
گزینه
\fB\-\-mirror\fR
نه تنها شاخه‌های محلی مبدأ را به شاخه‌های محلی مقصد نگاشت می‌کند، بلکه تمامی مراجع (شامل شاخه‌های ردگیری دوردست، یادداشت‌ها و غیره) را نگاشت کرده و یک پیکربندی refspec را تنظیم می‌کند به طوری که تمام این مراجع با یک دستور
\fBgit\fR
\fBremote\fR
\fBupdate\fR
در مخزن مقصد بازنویسی شوند\&.
.RE
.PP
\fB\-o\fR\fI<name>\fR, \fB\-\-origin=\fR\fI<name>\fR
.RS 4
به جای استفاده از نام دوردست
\fBorigin\fR
برای ردگیری مخزن بالادست، از
\fI<name>\fR
استفاده می‌کند\&. مقدار
\fBclone\&.defaultRemoteName\fR
را از پیکربندی لغو می‌نماید\&.
.RE
.PP
\fB\-b\fR\fI<name>\fR, \fB\-\-branch=\fR\fI<name>\fR
.RS 4
اشاره‌گر
\fBHEAD\fR
تازه‌ساخته‌شده را به جای شاخه‌ای که
\fBHEAD\fR
مخزن کلون‌شده به آن اشاره می‌کند، به شاخه
\fI<name>\fR
اشاره می‌دهد\&. در یک مخزن غیرتهی (non\-bare)، این شاخه‌ای است که دریافت (checkout) خواهد شد\&. گزینه
\fB\-\-branch\fR
همچنین می‌تواند تگ‌ها را بپذیرد و در مخزن حاصل
\fBHEAD\fR
را روی آن کامیت جدا (detach) کند\&.
.RE
.PP
\fB\-\-revision=\fR\fI<rev>\fR
.RS 4
یک مخزن جدید ایجاد می‌کند، و تاریخچه منتهی به بازنگری (revision) داده‌شده
\fI<rev>\fR
(و هیچ چیز دیگری) را بدون ساختن هیچ شاخه ردگیری دوردست و بدون ساختن هیچ شاخه محلی واکشی می‌کند، و
\fBHEAD\fR
را روی
\fI<rev>\fR
جدا (detach) می‌سازد\&. آرگومان می‌تواند یک نام مرجع (مانند
\fBrefs/heads/main\fR
یا
\fBrefs/tags/v1\&.0\fR)
باشد که به یک کامیت ختم شود، یا یک نام شیء هگزادسیمال باشد\&. این گزینه با گزینه‌های
\fB\-\-branch\fR
و
\fB\-\-mirror\fR
ناسازگار است\&.
.RE
.PP
\fB\-u\fR\fI<upload\-pack>\fR, \fB\-\-upload\-pack=\fR\fI<upload\-pack>\fR
.RS 4
هنگامی که دسترسی به مخزن مبدأ از طریق ssh انجام می‌شود، یک مسیر غیرپیش‌فرض برای دستوری که در سمت دیگر اجرا می‌شود مشخص می‌کند\&.
.RE
.PP
\fB\-\-template=\fR\fI<template\-directory>\fR
.RS 4
دایرکتوری‌ای را مشخص می‌کند که الگوها (templates) از آن استفاده خواهند شد؛ (بخش "TEMPLATE DIRECTORY" در
\fBgit-init\fR(1)
را ببینید\&.)
.RE
.PP
\fB\-c\fR\fI<key>\fR\fB=\fR\fI<value>\fR, \fB\-\-config=\fR\fI<key>\fR\fB=\fR\fI<value>\fR
.RS 4
یک متغیر پیکربندی را در مخزن تازه‌ساخته‌شده تنظیم می‌کند؛ این امر بلافاصله پس از مقداردهی اولیه مخزن، اما پیش از واکشی تاریخچه دوردست یا دریافت (checkout) فایل‌ها اثر می‌گذارد\&. کلید
\fI<key>\fR
در همان قالبی است که توسط
\fBgit-config\fR(1)
انتظار می‌رود (برای مثال،
\fBcore\&.eol=true\fR)\&.
اگر مقادیر متعددی برای یک کلید داده شود، هر مقدار در فایل پیکربندی نوشته خواهد شد\&. این امر برای نمونه افزودن refspecهای واکشی اضافی به مبدأ origin را ایمن می‌سازد\&.
.sp
به دلیل محدودیت‌های پیاده‌سازی فعلی، برخی متغیرهای پیکربندی تا پس از واکشی و checkout اولیه اثر نمی‌گذارند\&. متغیرهای پیکربندی شناخته‌شده‌ای که اثر نمی‌گذارند عبارتند از:
\fBremote\&.\fR\fI<name>\fR\fB\&.mirror\fR
و
\fBremote\&.\fR\fI<name>\fR\fB\&.tagOpt\fR\&.
به جای آن‌ها از گزینه‌های متناظر
\fB\-\-mirror\fR
و
\fB\-\-no\-tags\fR
استفاده کنید\&.
.RE
.PP
\fB\-\-depth=\fR\fI<depth>\fR
.RS 4
یک کلون کم‌عمق (\fIshallow\fR) با تاریخچه‌ای کوتاه شده به تعداد مشخص‌شده از کامیت‌ها ایجاد می‌کند\&. متضمن
\fB\-\-single\-branch\fR
است مگر اینکه
\fB\-\-no\-single\-branch\fR
داده شود تا تاریخچه‌های نزدیک به سر تمام شاخه‌ها واکشی شوند\&. اگر می‌خواهید زیرماژول‌ها را نیز به‌صورت کم‌عمق کلون کنید، گزینه
\fB\-\-shallow\-submodules\fR
را نیز پاس دهید\&.
.RE
.PP
\fB\-\-shallow\-since=\fR\fI<date>\fR
.RS 4
یک کلون کم‌عمق با تاریخچه‌ای پس از زمان مشخص‌شده ایجاد می‌کند\&.
.RE
.PP
\fB\-\-shallow\-exclude=\fR\fI<ref>\fR
.RS 4
یک کلون کم‌عمق با تاریخچه‌ای که کامیت‌های قابل دسترس از یک شاخه دوردست یا تگ مشخص در آن مستثنی شده‌اند ایجاد می‌کند\&. این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-single\-branch\fR, \fB\-\-no\-single\-branch\fR
.RS 4
تنها تاریخچه منتهی به نوک یک شاخه منفرد را کلون می‌کند، که یا با گزینه
\fB\-\-branch\fR
مشخص شده است یا شاخه اصلی است که
\fBHEAD\fR
مخزن دوردست به آن اشاره دارد\&. واکشی‌های بعدی به مخزن حاصل تنها شاخه ردگیری دوردست را برای شاخه‌ای به‌روزرسانی می‌کنند که این گزینه برای کلون اولیه آن استفاده شده بود\&. اگر هنگام انجام کلون با
\fB\-\-single\-branch\fR
اشاره‌گر
\fBHEAD\fR
در سرور دوردست به هیچ شاخه‌ای اشاره نمی‌کرد، هیچ شاخه ردگیری دوردستی ایجاد نمی‌شود\&.
.RE
.PP
\fB\-\-tags\fR, \fB\-\-no\-tags\fR
.RS 4
کنترل می‌کند که آیا تگ‌ها کلون شوند یا خیر\&. هنگامی که
\fB\-\-no\-tags\fR
داده شود، این گزینه با تنظیم پیکربندی
\fBremote\&.\fR\fI<remote>\fR\fB\&.tagOpt=\-\-no\-tags\fR
دائمی خواهد شد\&. این امر تضمین می‌کند که دستورات بعدی
\fBgit\fR
\fBpull\fR
و
\fBgit\fR
\fBfetch\fR
هیچ تگی را دنبال نکنند\&. واکشی‌های صریح بعدی تگ همچنان کار خواهند کرد (نگاه کنید به
\fBgit-fetch\fR(1)\&.)
.sp
به‌طور پیش‌فرض، تگ‌ها کلون می‌شوند و ارسال
\fB\-\-tags\fR
بنابراین معمولاً اثری ندارد (no\-op)، مگر اینکه گزینه قبلی
\fB\-\-no\-tags\fR
را خنثی کند\&.
.sp
می‌تواند همراه با
\fB\-\-single\-branch\fR
استفاده شود تا شاخه‌ای بدون هیچ مرجع دیگری غیر از یک شاخه کلون‌شده نگهداری و اداره شود\&. این موضوع برای نمونه برای نگهداری کلون‌های کمینه از شاخه پیش‌فرض یک مخزن به منظور نمایه‌سازی جستجو مفید است\&.
.RE
.PP
\fB\-\-recurse\-submodules\fR[\fB=\fR\fI<pathspec>\fR]
.RS 4
پس از ایجاد کلون، زیرماژول‌های درون آن را بر اساس
\fI<pathspec>\fR
ارائه‌شده مقداردهی اولیه و کلون می‌کند\&. اگر هیچ مقداری برای
\fB=\fR\fI<pathspec>\fR
ارائه نشود، تمامی زیرماژول‌ها مقداردهی اولیه و کلون می‌شوند\&. این گزینه می‌تواند چندین بار برای الگوهای مسیری متشکل از چند مدخل مشخص شود\&. در کلون حاصل، گزینه
\fBsubmodule\&.active\fR
روی الگوی مسیر ارائه‌شده، یا "\&." (به معنای تمام زیرماژول‌ها) در صورت عدم ارائه الگوی مسیر، تنظیم می‌گردد\&.
.sp
زیرماژول‌ها با استفاده از تنظیمات پیش‌فرض خود مقداردهی اولیه و کلون می‌شوند\&. این معادل با اجرای بلافاصله دستور
\fBgit\fR
\fBsubmodule\fR
\fBupdate\fR
\fB\-\-init\fR
\fB\-\-recursive\fR
\fI<pathspec>\fR
پس از پایان عملیات کلون است\&. اگر مخزن کلون‌شده درخت کاری/checkout نداشته باشد (یعنی اگر هر یک از گزینه‌های
\fB\-\-no\-checkout\fR/\fB\-n\fR،
\fB\-\-bare\fR،
یا
\fB\-\-mirror\fR
داده شده باشد) این گزینه نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-\-shallow\-submodules\fR, \fB\-\-no\-shallow\-submodules\fR
.RS 4
تمام زیرماژول‌هایی که کلون می‌شوند کم‌عمق و با عمق ۱ خواهند بود\&.
.RE
.PP
\fB\-\-remote\-submodules\fR, \fB\-\-no\-remote\-submodules\fR
.RS 4
تمام زیرماژول‌هایی که کلون می‌شوند، به جای استفاده از SHA\-1 ثبت‌شده در پروژه بالادست (superproject)، از وضعیت شاخه ردگیری دوردست زیرماژول برای به‌روزرسانی آن استفاده خواهند کرد\&. معادل با ارسال
\fB\-\-remote\fR
به
\fBgit\fR
\fBsubmodule\fR
\fBupdate\fR\&.
.RE
.PP
\fB\-\-separate\-git\-dir=\fR\fI<git\-dir>\fR
.RS 4
به جای قرار دادن مخزن کلون‌شده در جایی که قرار است باشد، آن را در دایرکتوری مشخص‌شده قرار می‌دهد، سپس یک پیوند نمادین گیت مستقل از سامانه فایل به آنجا می‌سازد\&. نتیجه این است که مخزن گیت می‌تواند از درخت کاری جدا شود\&.
.RE
.PP
\fB\-\-ref\-format=\fR\fI<ref\-format>\fR
.RS 4
قالب ذخیره‌سازی مراجع را برای مخزن مشخص می‌کند\&. مقادیر معتبر عبارتند از:
.PP
\fBfiles\fR
.RS 4
برای فایل‌های مستقل با packed\-refs\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fBreftable\fR
.RS 4
برای قالب reftable\&.
.RE
.RE
.PP
\fB\-j\fR\fI<n>\fR, \fB\-\-jobs=\fR\fI<n>\fR
.RS 4
تعداد زیرماژول‌هایی که به طور هم‌زمان واکشی می‌شوند\&. پیش‌فرض آن مقدار گزینه
\fBsubmodule\&.fetchJobs\fR
است\&.
.RE
.PP
\fI<repository>\fR
.RS 4
مخزن (احتمالاً دوردست)
\fI<repository>\fR
که کلون از آن انجام می‌شود\&. برای اطلاعات بیشتر درباره نحوه مشخص کردن مخازن، بخش
نشانی‌های گیت (GIT URLS)
در زیر را ببینید\&.
.RE
.PP
\fI<directory>\fR
.RS 4
نام یک دایرکتوری جدید برای کلون کردن درون آن\&. اگر هیچ
\fI<directory>\fR
به‌طور صریح داده نشود، بخش «شبه‌انسانی» مخزن مبدأ استفاده می‌شود (\fBrepo\fR
برای
\fB/path/to/repo\&.git\fR
و
\fBfoo\fR
برای
\fBhost\&.xz:foo/\&.git\fR)\&.
کلون کردن درون یک دایرکتوری موجود تنها در صورتی مجاز است که آن دایرکتوری خالی باشد\&.
.RE
.PP
\fB\-\-bundle\-uri=\fR\fI<uri>\fR
.RS 4
پیش از واکشی از سرور دوردست، یک بسته باندل را از
\fI<uri>\fR
داده‌شده واکشی کرده و داده‌ها را در مخزن محلی از بسته باز (unbundle) می‌کند\&. مراجع موجود در باندل در فضای نام پنهان
\fBrefs/bundle/*\fR
ذخیره خواهند شد\&. این گزینه با گزینه‌های
\fB\-\-depth\fR،
\fB\-\-shallow\-since\fR
و
\fB\-\-shallow\-exclude\fR
ناسازگار است\&.
.RE
.SH "نشانی‌های گیت (GIT URLS)"
.sp
به‌طور کلی، نشانی‌ها (URL) حاوی اطلاعاتی درباره پروتکل انتقال، نشانی سرور دوردست و مسیر مخزن هستند\&. بسته به پروتکل انتقال، ممکن است برخی از این اطلاعات وجود نداشته باشند\&.
.sp
گیت از پروتکل‌های ssh، git، http و https پشتیبانی می‌کند (علاوه بر این، ftp و ftps می‌توانند برای واکشی استفاده شوند، اما این کار ناکارآمد و منسوخ است؛ از آن‌ها استفاده نکنید)\&.
.sp
انتقال بومی (یعنی نشانی \fBgit://\fR) هیچ‌گونه احراز هویتی انجام نمی‌دهد و باید در شبکه‌های ناامن با احتیاط استفاده شود\&.
.sp
قالب‌های ساختاری زیر می‌توانند با آن‌ها استفاده شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBssh://\fR[\fI<user>\fR\fB@\fR]\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBgit://\fR\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhttp\fR[\fBs\fR]\fB://\fR\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBftp\fR[\fBs\fR]\fB://\fR\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
همچنین می‌توان یک نحو جایگزین شبیه scp را با پروتکل ssh استفاده کرد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
[\fI<user>\fR\fB@\fR]\fI<host>\fR\fB:/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
این نحو تنها در صورتی تشخیص داده می‌شود که هیچ اسلشی قبل از اولین دو‌نقطه نباشد\&. این امر به تمایز مسیر محلی که حاوی دو‌نقطه است کمک می‌کند\&. برای نمونه، مسیر محلی \fBfoo:bar\fR می‌تواند به‌صورت یک مسیر مطلق یا \fB\&./foo:bar\fR مشخص شود تا از تفسیر نادرست آن به‌عنوان یک نشانی ssh جلوگیری شود\&.
.sp
پروتکل‌های ssh و git علاوه بر این از بسط \fB~\fR\fI<username>\fR پشتیبانی می‌کنند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBssh://\fR[\fI<user>\fR\fB@\fR]\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/~\fR\fI<user>\fR\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBgit://\fR\fI<host>\fR[\fB:\fR\fI<port>\fR]\fB/~\fR\fI<user>\fR\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
[\fI<user>\fR\fB@\fR]\fI<host>\fR\fB:~\fR\fI<user>\fR\fB/\fR\fI<path\-to\-git\-repo>\fR
.RE
.sp
برای مخازن محلی، که به‌طور بومی توسط گیت نیز پشتیبانی می‌شوند، می‌توان از نحوهای زیر استفاده کرد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB/path/to/repo\&.git/\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfile:///path/to/repo\&.git/\fR
.RE
.sp
این دو نحو عمدتاً معادل هستند، به جز اینکه اولی متضمن گزینه \fB\-\-local\fR است\&.
.sp
دستورهای \fBgit\fR \fBclone\fR، \fBgit\fR \fBfetch\fR و \fBgit\fR \fBpull\fR (اما نه \fBgit\fR \fBpush\fR) یک فایل باندل مناسب را نیز می‌پذیرند\&. نگاه کنید به \fBgit-bundle\fR(1)\&.
.sp
هنگامی که گیت روش کار با یک پروتکل انتقال معین را نمی‌داند، تلاش می‌کند از دستیار دوردست \fBremote\-\fR\fI<transport>\fR در صورت وجود استفاده کند\&. برای درخواست صریح یک دستیار دوردست، می‌توان از نحو زیر استفاده کرد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI<transport>\fR\fB::\fR\fI<address>\fR
.RE
.sp
که در آن \fI<address>\fR می‌تواند یک مسیر، یک سرور و مسیر، یا یک رشته دلخواه شبیه نشانی باشد که توسط دستیار دوردست مربوطه فراخوانی‌شده شناسایی می‌شود\&. برای جزئیات به \fBgitremote-helpers\fR(7) مراجعه کنید\&.
.sp
اگر تعداد زیادی مخزن دوردست با نام‌های مشابه وجود دارد و می‌خواهید فرمت متفاوتی برای آن‌ها استفاده کنید (به گونه‌ای که نشانی‌های مورداستفاده شما به نشانی‌هایی که کار می‌کنند بازنویسی شوند)، می‌توانید یک بخش پیکربندی به این شکل بسازید:
.sp
.if n \{\
.RS 4
.\}
.nf
        [url "\fI<actual\-url\-base>\fR"]
                insteadOf = \fI<other\-url\-base>\fR
.fi
.if n \{\
.RE
.\}
.sp
.sp
برای نمونه، با این تنظیم:
.sp
.if n \{\
.RS 4
.\}
.nf
        [url "git://git\&.host\&.xz/"]
                insteadOf = host\&.xz:/path/to/
                insteadOf = work:
.fi
.if n \{\
.RE
.\}
.sp
.sp
یک نشانی مانند "work:repo\&.git" یا مانند "host\&.xz:/path/to/repo\&.git" در هر زمینه‌ای که یک نشانی می‌پذیرد به "git://git\&.host\&.xz/repo\&.git" بازنویسی خواهد شد\&.
.sp
اگر می‌خواهید نشانی‌ها را فقط برای push بازنویسی کنید، می‌توانید یک بخش پیکربندی به این شکل بسازید:
.sp
.if n \{\
.RS 4
.\}
.nf
        [url "\fI<actual\-url\-base>\fR"]
                pushInsteadOf = \fI<other\-url\-base>\fR
.fi
.if n \{\
.RE
.\}
.sp
.sp
برای نمونه، با این تنظیم:
.sp
.if n \{\
.RS 4
.\}
.nf
        [url "ssh://example\&.org/"]
                pushInsteadOf = git://example\&.org/
.fi
.if n \{\
.RE
.\}
.sp
.sp
یک نشانی مانند "git://example\&.org/path/to/repo\&.git" برای ارسال‌ها (push) به "ssh://example\&.org/path/to/repo\&.git" بازنویسی می‌شود، اما دریافت‌ها (pull) همچنان از نشانی اصلی استفاده خواهند کرد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کلون کردن از بالادست:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git clone git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\&.git my\-linux
$ cd my\-linux
$ make
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ایجاد یک کلون محلی که از دایرکتوری فعلی اشیاء را قرض می‌گیرد، بدون دریافت (checkout) فایل‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git clone \-l \-s \-n \&. \&.\&./copy
$ cd \&.\&./copy
$ git show\-branch
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کلون کردن از بالادست در حالی که از یک دایرکتوری محلی موجود اشیاء را قرض می‌گیرد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git clone \-\-reference /git/linux\&.git \e
        git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\&.git \e
        my\-linux
$ cd my\-linux
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ایجاد یک مخزن تهی (bare) برای انتشار تغییرات خود به عموم:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git clone \-\-bare \-l /home/proj/\&.git /pub/scm/proj\&.git
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کلون کردن یک مخزن محلی از یک کاربر دیگر:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git clone \-\-no\-local /home/otheruser/proj\&.git /pub/scm/proj\&.git
.fi
.if n \{\
.RE
.\}
.sp
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
تمام موارد زیر این خط در این بخش به‌صورت گزینشی از مستندات \fBgit-config\fR(1) گنجانده شده است\&. محتوای آن همان چیزی است که در آنجا یافت می‌شود:
.PP
\fBinit\&.templateDir\fR
.RS 4
دایرکتوری‌ای را مشخص می‌کند که قالب‌ها از آن کپی خواهند شد\&. (بخش "TEMPLATE DIRECTORY" در
\fBgit-init\fR(1)
را ببینید\&.)
.RE
.PP
\fBinit\&.defaultBranch\fR
.RS 4
امکان لغو و تغییر نام شاخه پیش‌فرض را برای نمونه هنگام مقداردهی اولیه یک مخزن جدید فراهم می‌کند\&.
.RE
.PP
\fBinit\&.defaultObjectFormat\fR
.RS 4
امکان لغو و تغییر قالب پیش‌فرض اشیاء برای مخازن جدید را فراهم می‌کند\&. نگاه کنید به
\fB\-\-object\-format=\fR
در
\fBgit-init\fR(1)\&.
هم گزینه خط فرمان و هم متغیر محیطی
\fBGIT_DEFAULT_HASH\fR
بر این تنظیم پیکربندی اولویت دارند\&.
.RE
.PP
\fBinit\&.defaultRefFormat\fR
.RS 4
امکان لغو و تغییر قالب پیش‌فرض ذخیره‌سازی مراجع را برای مخازن جدید فراهم می‌کند\&. نگاه کنید به
\fB\-\-ref\-format=\fR
در
\fBgit-init\fR(1)\&.
هم گزینه خط فرمان و هم متغیر محیطی
\fBGIT_DEFAULT_REF_FORMAT\fR
بر این تنظیم پیکربندی اولویت دارند\&.
.RE
.PP
init\&.defaultSubmodulePathConfig
.RS 4
یک مقدار بولی که مشخص می‌کند آیا
\fBgit\fR
\fBinit\fR
و
\fBgit\fR
\fBclone\fR
باید به‌طور خودکار
\fBextensions\&.submodulePathConfig\fR
را روی
\fBtrue\fR
تنظیم کنند یا خیر\&. این امر اجازه می‌دهد تمام مخازن جدید به‌طور خودکار از افزونه مسیر زیرماژول استفاده کنند\&. در صورت عدم تنظیم، مقدار پیش‌فرض آن
\fBfalse\fR
است\&.
.RE
.PP
\fBclone\&.defaultRemoteName\fR
.RS 4
نام سرور دوردستی که هنگام کلون کردن یک مخزن ایجاد می‌شود\&. مقدار پیش‌فرض آن
\fBorigin\fR
است\&. می‌توان آن را با ارسال گزینه خط فرمان
\fB\-\-origin\fR
لغو کرد\&.
.RE
.PP
\fBclone\&.rejectShallow\fR
.RS 4
در صورتی که مخزن یک مخزن کم‌عمق باشد، کلون کردن آن را رد می‌کند؛ این رفتار را می‌توان با ارسال گزینه
\fB\-\-reject\-shallow\fR
در خط فرمان لغو کرد\&.
.RE
.PP
\fBclone\&.filterSubmodules\fR
.RS 4
اگر یک فیلتر کلون جزئی ارائه شده باشد (نگاه کنید به
\fB\-\-filter\fR
در
\fBgit-rev-list\fR(1))
و از
\fB\-\-recurse\-submodules\fR
استفاده شود، فیلتر را روی زیرماژول‌ها نیز اعمال می‌کند\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)