.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj\-git\-init 1  "init "
.SH "نام (NAME)"
jj\-git\-init \- ایجاد یک مخزن جدید مبتنی بر Git
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj git init\fR [\fB\-\-colocate\fR] [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-\-ignore\-working\-copy\fR] [\fB\-\-no\-colocate\fR] [\fB\-\-no\-integrate\-operation\fR] [\fB\-\-object\-hash\fR] [\fB\-\-git\-repo\fR] [\fB\-\-ignore\-immutable\fR] [\fB\-\-at\-operation\fR] [\fB\-\-debug\fR] [\fB\-\-color\fR] [\fB\-\-quiet\fR] [\fB\-\-no\-pager\fR] [\fB\-\-config\fR] [\fB\-\-config\-file\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIDESTINATION\fR]
.SH "توضیحات (DESCRIPTION)"
ایجاد یک مخزن جدید مبتنی بر Git
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-colocate\fR
هم‌مکانی مخزن Jujutsu با مخزن git
.sp
مشخص می‌کند که مخزن `jj` باید یک مخزن معتبر `git` نیز باشد، که امکان استفاده از هر دو دستور `jj` و `git` را در همان دایرکتوری فراهم می‌سازد.
.sp
مخزن شامل یک دایرکتوری `.git` در بالاترین سطح خواهد بود. ابزارهای معمول Git قادر خواهند بود بر روی مخزن عمل کنند.
.sp
\fBاین حالت پیش‌فرض است\fR، و این گزینه اثری ندارد، مگر اینکه [git.colocate config] بر روی `false` تنظیم شده باشد.
.sp
این گزینه با
.B \-\-git\-repo
ناسازگار (مانعة‌الجمع) است.
.sp
[git.colocate config]: https://docs.jj\-vcs.dev/latest/config/#default\-colocation
.TP
\fB\-\-no\-colocate\fR
غیرفعال کردن هم‌مکانی مخزن Jujutsu با مخزن git
.sp
جلوگیری از کارکرد ابزارهای Git که از `jj` بی‌خبرند و دستورات معمول Git بر روی مخزن. مخزن Git که بیشتر داده‌های مخزن را در خود ذخیره می‌کند، درون یک زیردایرکتوری از دایرکتوری `.jj` پنهان خواهد شد.
.sp
برای آگاهی از برخی مزایای جزئی فضاهای کاری غیرهم‌مکان، [colocation docs] را ببینید.
.sp
[colocation docs]: https://docs.jj\-vcs.dev/latest/git\-compatibility/#colocated\-jujutsugit\-repos
.TP
\fB\-\-object\-hash\fR \fI<OBJECT_HASH>\fR
الگوریتم هش اشیاء برای مخزن تازه‌ ایجادشده Git.
.sp
معادل گزینهٔ
.B \-\-object\-format
در
.B git init
است. در صورت عدم ارائه، پیکربندی [git.object\-hash config] مقدار پیش‌فرض را تعیین می‌کند.
.sp
توجه داشته باشید که هش اشیاء در حال حاضر برای یک مخزن موجود قابل تغییر نیست و همهٔ سرویس‌های میزبان کد (code forges) هنوز از مخازن SHA\-256 پشتیبانی نمی‌کنند. همچنین برای توضیحات عمیق‌تر دربارهٔ مهاجرت به سمت توابع هش قوی‌تر، سند [hash\-function\-transition] گیت را ببینید.
.sp
[git.object\-hash config]: https://docs.jj\-vcs.dev/latest/config/#default\-object\-hash\-format
.br
[hash\-function\-transition]: https://git\-scm.com/docs/hash\-function\-transition
.sp
\fIمقادیر مجاز:\fR
.RS 14
.IP \(bu 2
sha1
.IP \(bu 2
sha256
.RE
.TP
\fB\-\-git\-repo\fR \fI<GIT_REPO>\fR
مسیر یک مخزن Git \fBموجود\fR را مشخص می‌کند تا به عنوان مخزن پشتیبان Git برای مخزن تازه‌ ایجادشده `jj` استفاده شود.
.sp
اگر مسیر مشخص‌شدهٔ `\-\-git\-repo` اتفاقاً با مسیر مخزن `jj` یکسان باشد (هر دو دایرکتوری .jj و .git در یک دایرکتوری کاری قرار داشته باشند)، آنگاه هر دو دستور `jj` و `git` روی همان مخزن کار خواهند کرد. این حالت یک فضای کاری هم‌مکان نامیده می‌شود.
.sp
این گزینه با
.B \-\-colocate
ناسازگار (مانعة‌الجمع) است، بنابراین در صورت ارسال، هم‌مکانی را غیرفعال می‌کند.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
[\fIDESTINATION\fR] [پیش‌فرض: .]
دایرکتوری مقصدی که مخزن `jj` در آن ایجاد خواهد شد. اگر دایرکتوری وجود نداشته باشد، ایجاد می‌شود. اگر هیچ دایرکتوری مشخص نشود، از دایرکتوری فعلی استفاده می‌شود.
.sp
به‌طور پیش‌فرض مخزن `git` در مسیر `$destination/.jj` قرار دارد.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که باید روی آن کار شود
.sp
به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در مسیرهای والد دایرکتوری کاری فعلی می‌گردد.
.TP
\fB\-\-ignore\-working\-copy\fR
از نسخهٔ کاری اسنپ‌شات گرفته نشود و به‌روزرسانی نیز نگردد
.sp
به‌طور پیش‌فرض، Jujutsu در ابتدای هر دستور از نسخهٔ کاری اسنپ‌شات می‌گیرد. همچنین در پایان دستور، اگر دستور کامیت نسخهٔ کاری (`@`) را تغییر داده باشد، نسخهٔ کاری به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از نسخهٔ کاری صرف‌نظر کنید و در عوض یک کامیت نسخهٔ کاری احتمالاً قدیمی را مشاهده کنید، می‌توانید از
.B \-\-ignore\-working\-copy
استفاده کنید. این مورد می‌تواند برای مثال در خط فرمان (prompt) مفید باشد، به‌ویژه اگر فرآیند دیگری داشته باشید که نسخهٔ کاری را کامیت می‌کند.
.sp
بارگذاری مخزن در یک عملیات خاص با
.B \-\-at\-operation
به معنای فعال بودن
.B \-\-ignore\-working\-copy
است.
.TP
\fB\-\-no\-integrate\-operation\fR
اجرای دستور به صورت معمول اما بدون ادغام عملیات‌ها
.sp
هنگامی که این گزینه ارائه شود، عملیات‌ها همچنان مثل همیشه ایجاد می‌شوند اما در گزارش عملیات (operation log) ادغام نخواهند شد. همچنین نسخهٔ کاری به‌روزرسانی نخواهد شد.
.sp
این دستور شناسهٔ عملیات حاصل را چاپ می‌کند. می‌توانید آن را مثلاً به
.B jj \-\-at\-op
ارسال کنید تا وضعیت مخزن حاصل را بررسی کنید، یا آن را به
.B jj op restore
بدهید تا مخزن را به آن وضعیت بازیابی کند. همچنین می‌توانید شناسه را به
.B jj op integrate
بدهید تا عملیات را ادغام نماید.
.sp
توجه داشته باشید که این گزینه مانع اثرات جانبی بیرون از مخزن *نمی‌شود*. برای نمونه، دستور
.B jj git push \-\-no\-integrate\-operation
همچنان عملیات پوش (push) را انجام خواهد داد.
.TP
\fB\-\-ignore\-immutable\fR
اجازه بازنویسی کامیت‌های تغییرناپذیر
.sp
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌های موجود در مجموعهٔ پیکربندی‌شدهٔ کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه بررسی مذکور را غیرفعال کرده و اجازه می‌دهد هر کامیتی به جز کامیت ریشه (root commit) را بازنویسی کنید.
.sp
این گزینه فقط بر روی این بررسی تأثیر می‌گذارد و روی مجموعه بازبینی (revset)
.B immutable_heads()
یا کلمه کلیدی الگوی
.B immutable
اثری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن بر مبنای آن بارگذاری شود
.sp
عملیاتی که مخزن باید بر مبنای آن بارگذاری شود. به‌طور پیش‌فرض، Jujutsu مخزن را بر مبنای جدیدترین عملیات یا در صورت وجود، بر مبنای ادغام عملیات‌های واگرا بارگذاری می‌کند.
.sp
می‌توانید از
.BI \-\-at\-op= <operation\~ID>
استفاده کنید تا ببینید مخزن در یک عملیات پیشین به چه شکلی بوده است. برای مثال، دستور
.BI "jj \-\-at\-op=" <operation\~ID> " st"
آنچه را که
.B jj st
بلافاصله پس از پایان عملیات مشخص‌شده نشان می‌داد، به شما نمایش می‌دهد.
.B \-\-at\-op=@
تقریباً همانند حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.
.sp
از دستور
.B jj op log
برای یافتن شناسهٔ عملیات دلخواه خود استفاده کنید. هر پیشوند یکتایی از شناسهٔ عملیات کافی است.
.sp
هنگام بارگذاری مخزن در یک عملیات قبلی، نسخهٔ کاری نادیده گرفته می‌شود، درست مانند اینکه
.B \-\-ignore\-working\-copy
مشخص شده باشد.
.sp
امکان اجرای دستورات تغییردهنده وضعیت (mutating) هنگام بارگذاری مخزن در یک عملیات قبلی وجود دارد. انجام این کار معادل اجرای دستورات همزمان با شروع از عملیات پیشین است. به‌ندرت دلیلی برای انجام این کار وجود دارد، اما امکان‌پذیر است.
.TP
\fB\-\-debug\fR
فعال‌سازی گزارش‌گیری اشکال‌زدایی (debug logging)
.TP
\fB\-\-color\fR \fI<WHEN>\fR
زمان رنگی‌سازی خروجی
.sp
\fIمقادیر مجاز:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
debug
.IP \(bu 2
auto
.RE
.TP
\fB\-\-quiet\fR
بی‌صدا کردن خروجی‌های غیر اصلی دستور
.sp
برای نمونه، دستور
.B jj file list
همچنان فایل‌ها را فهرست می‌کند، اما به شما اطلاع نمی‌دهد که از نسخهٔ کاری اسنپ‌شات گرفته شده است یا نوادگان بازپایه‌ریزی (rebase) شده‌اند.
.sp
هشدارها و خطاها همچنان چاپ خواهند شد.
.TP
\fB\-\-no\-pager\fR
غیرفعال کردن صفحه‌بندی (pager)
.TP
\fB\-\-config\fR \fI<NAME=VALUE>\fR
گزینه‌های پیکربندی اضافی (قابل تکرار)
.sp
نام باید به صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به عنوان یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای در هیچ‌یک از ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان علامت نقل‌قول را حذف کرد.
.TP
\fB\-\-config\-file\fR \fI<PATH>\fR
فایل‌های پیکربندی اضافی (قابل تکرار)
.SH "همچنین ببینید (SEE ALSO)"
.BR jj (1),
.BR jj\-git (1),
.BR git (1),
.BR git\-init (1)