.\" DO NOT MODIFY THIS FILE!  It was generated by help2man.
.TH REPO "1" "September 2024" "repo init" "راهنمای Repo"
.SH "نام (NAME)"
repo \- راه‌اندازی و مقداردهی اولیه کلاینت repo
.SH "خلاصه دستور (SYNOPSIS)"
.B repo
\fI\,init \/\fR[\fI\,گزینه‌ها\/\fR] [\fI\,manifest url\/\fR]
.SH "توضیحات (DESCRIPTION)"
خلاصه
.PP
راه‌اندازی و مقداردهی اولیه یک کلاینت repo در دایرکتوری جاری
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما و خروج
.SS "گزینه‌های ثبت وقایع (Logging options):"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش تمامی خروجی‌ها
.TP
\fB\-q\fR, \fB\-\-quiet\fR
تنها نمایش خطاها
.SS "گزینه‌های مانیفست (Manifest options):"
.TP
\fB\-u\fR URL, \fB\-\-manifest\-url\fR=\fI\,URL\/\fR
مکان مخزن manifest
.TP
\fB\-b\fR REVISION, \fB\-\-manifest\-branch\fR=\fI\,REVISION\/\fR
شاخه یا بازنگری (revision) مانیفست (برای پیش‌فرض از HEAD استفاده کنید)
.TP
\fB\-\-manifest\-upstream\-branch\fR=\fI\,BRANCH\/\fR
هنگامی که یک کامیت به \fB\-\-manifest\-branch\fR داده می‌شود، این گزینه
نام مرجع git (git ref) است که کامیت در آن یافت می‌شود
.TP
\fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml
فایل manifest اولیه
.TP
\fB\-g\fR GROUP, \fB\-\-groups\fR=\fI\,GROUP\/\fR
محدود کردن پروژه‌های manifest به مواردی با گروه‌(های) مشخص‌شده
[default|all|G1,G2,G3|G4,\-G5,\-G6]
.TP
\fB\-p\fR PLATFORM, \fB\-\-platform\fR=\fI\,PLATFORM\/\fR
محدود کردن پروژه‌های manifest به مواردی با گروه پلتفرم مشخص‌شده
[auto|all|none|linux|darwin|...]
.TP
\fB\-\-submodules\fR
همگام‌سازی تمامی زیرماژول‌های (submodules) مرتبط با مخزن manifest
.TP
\fB\-\-standalone\-manifest\fR
بارگیری manifest به‌صورت یک فایل ایستا به جای ایجاد یک checkout گیت
از مخزن manifest
.TP
\fB\-\-manifest\-depth\fR=\fI\,DEPTH\/\fR
ایجاد یک کلون کم‌عمق (shallow clone) از مخزن manifest با عمق داده‌شده
(۰ برای کلون کامل)؛ git clone را ببینید (پیش‌فرض: 0)
.SS "گزینه‌های دریافت (فقط) مانیفست (Manifest only checkout options):"
.TP
\fB\-c\fR, \fB\-\-current\-branch\fR
تنها واکشی شاخه مانیفست جاری از سرور
(پیش‌فرض)
.TP
\fB\-\-no\-current\-branch\fR
واکشی تمام شاخه‌های مانیفست از سرور
.TP
\fB\-\-tags\fR
واکشی تگ‌های موجود در manifest
.TP
\fB\-\-no\-tags\fR
تگ‌های موجود در manifest واکشی نشوند
.SS "حالت‌های دریافت (Checkout modes):"
.TP
\fB\-\-mirror\fR
ایجاد یک نسخه مشابه (replica) از مخازن ریموت به جای
دایرکتوری کاری کلاینت
.TP
\fB\-\-archive\fR
دریافت یک آرشیو به جای مخزن git برای هر پروژه. git archive را ببینید.
.TP
\fB\-\-worktree\fR
استفاده از git\-worktree برای مدیریت پروژه‌ها
.SS "بهینه‌سازی‌های دریافت پروژه (Project checkout optimizations):"
.TP
\fB\-\-reference\fR=\fI\,DIR\/\fR
مکان دایرکتوری آینه (mirror)
.TP
\fB\-\-dissociate\fR
جدا کردن پیوند از آینه‌های مرجع پس از اتمام clone
.TP
\fB\-\-depth\fR=\fI\,DEPTH\/\fR
ایجاد یک کلون کم‌عمق با عمق داده‌شده؛ git clone را ببینید
.TP
\fB\-\-partial\-clone\fR
انجام کلون جزئی (partial clone) (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)
.TP
\fB\-\-no\-partial\-clone\fR
غیرفعال‌سازی استفاده از کلون جزئی (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)
.TP
\fB\-\-partial\-clone\-exclude\fR=\fI\,PARTIAL_CLONE_EXCLUDE\/\fR
مستثنی کردن پروژه‌های مشخص‌شده (نام‌های پروژه با کاما جدا شوند)
از کلون جزئی (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)
.TP
\fB\-\-clone\-filter\fR=\fI\,CLONE_FILTER\/\fR
فیلتر مورد استفاده با \fB\-\-partial\-clone\fR [پیش‌فرض:
blob:none]
.TP
\fB\-\-use\-superproject\fR
استفاده از superproject مانیفست برای همگام‌سازی پروژه‌ها؛
شامل \fB\-c\fR می‌شود
.TP
\fB\-\-no\-use\-superproject\fR
غیرفعال‌سازی استفاده از superprojectهای مانیفست
.TP
\fB\-\-clone\-bundle\fR
فعال‌سازی استفاده از \fI\,/clone.bundle\/\fP بر روی HTTP/HTTPS (در صورت
عدم استفاده از \fB\-\-partial\-clone\fR پیش‌فرض است)
.TP
\fB\-\-no\-clone\-bundle\fR
غیرفعال‌سازی استفاده از \fI\,/clone.bundle\/\fP بر روی HTTP/HTTPS (در صورت
استفاده از \fB\-\-partial\-clone\fR پیش‌فرض است)
.TP
\fB\-\-git\-lfs\fR
فعال‌سازی پشتیبانی از Git LFS
.TP
\fB\-\-no\-git\-lfs\fR
غیرفعال‌سازی پشتیبانی از Git LFS
.SS "گزینه‌های نسخه repo (repo Version options):"
.TP
\fB\-\-repo\-url\fR=\fI\,URL\/\fR
مکان مخزن repo ($REPO_URL)
.TP
\fB\-\-repo\-rev\fR=\fI\,REV\/\fR
شاخه یا بازنگری repo ($REPO_REV)
.TP
\fB\-\-no\-repo\-verify\fR
عدم اعتبارسنجی کد منبع repo
.SS "سایر گزینه‌ها (Other options):"
.TP
\fB\-\-config\-name\fR
همواره برای نام/رایانامه (e\-mail) سؤال شود
.SS "چندمانیفستی (Multi\-manifest):"
.TP
\fB\-\-outer\-manifest\fR
شروع عملیات از بیرونی‌ترین manifest
.TP
\fB\-\-no\-outer\-manifest\fR
عدم اعمال عملیات بر روی manifestهای بیرونی
.TP
\fB\-\-this\-manifest\-only\fR
تنها بر روی این (زیر)مانیفست عملیات انجام شود
.TP
\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR
اعمال عملیات بر روی این manifest و زیرمانیفست‌های آن
.PP
برای مشاهده راهنمای تفصیلی، فرمان `repo help init` را اجرا کنید.
.SH "جزئیات (DETAILS)"
.PP
دستور 'repo init' یک بار برای نصب و راه‌اندازی repo اجرا می‌شود. جدیدترین
کد منبع repo و مجموعه manifest از سرور دانلود شده و در دایرکتوری .repo/ در
دایرکتوری کاری جاری نصب می‌شود.
.PP
هنگام ایجاد یک checkout جدید، نشانی وب manifest تنها تنظیم الزامی است. این نشانی
می‌تواند با استفاده از گزینه \fB\-\-manifest\-url\fR یا به عنوان نخستین آرگومان اختیاری
مشخص شود.
.PP
آرگومان اختیاری \fB\-b\fR می‌تواند برای انتخاب شاخه manifest جهت دریافت (checkout)
و استفاده به کار رود. اگر هیچ شاخه‌ای مشخص نشود، شاخه پیش‌فرض سرور دوردست (remote) استفاده
خواهد شد. این معادل استفاده از \fB\-b\fR HEAD است.
.PP
آرگومان اختیاری \fB\-\-manifest\-upstream\-branch\fR هنگامی که یک کامیت به
\fB\-\-manifest\-branch\fR (یا \fB\-b\fR) داده شده است، می‌تواند برای تعیین نام git ref
که کامیت در آن یافت می‌شود به کار رود.
.PP
آرگومان اختیاری \fB\-m\fR می‌تواند برای تعیین یک manifest جایگزین مورد استفاده قرار گیرد.
اگر هیچ manifestی مشخص نشود، فایل پیش‌فرض default.xml استفاده خواهد شد.
.PP
اگر آرگومان \fB\-\-standalone\-manifest\fR تنظیم شود، manifest مستقیماً از
\fB\-\-manifest\-url\fR مشخص‌شده به صورت یک فایل ایستا بارگیری می‌شود (به جای
راه‌اندازی یک checkout گیت برای manifest). با گزینه \fB\-\-standalone\-manifest\fR،
فایل manifest کاملاً ایستا خواهد بود و در فراخوانی‌های بعدی `repo init` و
`repo sync` دوباره دانلود نخواهد شد.
.PP
گزینه \fB\-\-reference\fR می‌تواند برای اشاره به دایرکتوری‌ای به کار رود که دارای محتوای یک
همگام‌سازی \fB\-\-mirror\fR است. این کار باعث می‌شود دایرکتوری کاری هنگام واکشی از سرور،
تا حد امکان از داده‌های دایرکتوری مرجع محلی استفاده کند. با کاهش ترافیک داده
در شبکه، این امر سرعت همگام‌سازی را بسیار افزایش می‌دهد.
.PP
گزینه \fB\-\-dissociate\fR می‌تواند برای قرض گرفتن اشیاء از دایرکتوری مشخص‌شده با گزینه
\fB\-\-reference\fR تنها به منظور کاهش انتقال شبکه استفاده شود؛ و پس از انجام نخستین کلون،
با ایجاد رونوشت‌های محلی مورد نیاز از اشیاء قرض‌گرفته‌شده، استفاده اشتراکی از آن‌ها پایان یابد.
.PP
گزینه \fB\-\-no\-clone\-bundle\fR هرگونه تلاش برای استفاده از \fI\,$URL/clone.bundle\/\fP جهت
راه‌اندازی اولیه یک مخزن Git جدید از یک فایل bundle با قابلیت ادامه دانلود (resumeable) روی شبکه
توزیع محتوا (CDN) را غیرفعال می‌کند. در صورتی که کلاینت محلی پایتون برای HTTP یا پیکربندی پروکسی
دچار مشکل بوده اما باینری Git به‌درستی کار کند، این گزینه ممکن است ضروری باشد.
.PP
تغییر شاخه‌های مانیفست
.PP
برای تغییر به یک شاخه manifest دیگر در یک کلاینت موجود، می‌توان از `repo init \fB\-b\fR otherbranch`
استفاده کرد. با این حال، از آنجا که این کار تنها manifest را به‌روزرسانی می‌کند، اجرای متعاقب
`repo sync` (یا `repo sync \fB\-d\fR`) برای به‌روزرسانی فایل‌های دایرکتوری کاری ضروری است.