.TH git-annex-init 1
.SH "نام (NAME)"
git-annex-init \- مقداردهی اولیه git-annex
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex init \fB[description]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
تا زمانی که یک مخزن (یا یکی از مخازن دوردست آن) مقداردهی اولیه نشده باشد،
git-annex از کار بر روی آن امتناع خواهد کرد، تا از استفاده تصادفی
از آن در مخزنی که قرار نبوده است ضمیمه (annex) داشته باشد، جلوگیری شود.
.PP
مقداردهی اولیه هر کلون جدید از یک مخزن با توضیحات مخصوص به خود مفید است،
اما اجباری نیست. اگر توضیحی ارائه ندهید، توضیحی با استفاده از نام کاربری،
نام میزبان (hostname) و مسیر تولید خواهد شد.
.PP
اگر هر مخزن ویژه دوردستی با autoenable=true پیکربندی شده باشد،
این دستور همچنین تلاش خواهد کرد آن‌ها را فعال کند. به git-annex\-initremote(1) مراجعه کنید.
برای جلوگیری از آن، مخزن دوردست را با "autoenable=false" مجدداً فعال کنید، یا
آن را به عنوان مرده/غیرفعال علامت‌گذاری نمایید (ببینید: git-annex\-dead(1)).
.PP
اجرای این دستور در یک مخزن git-annex که قبلاً مقداردهی اولیه شده است،
کاملاً ایمن است، اگرچه معمولاً بی‌فایده خواهد بود.
.PP
یک فایل \fB.noannex\fP در ریشه مخزن (top\-level) از اجرای git-annex init
در مخزن جلوگیری خواهد کرد. این قابلیت برای مخازنی مفید است که به دلایل
خط‌مشی نباید از git-annex استفاده کنند. محتوای این فایل به کاربری که تلاش می‌کند
git-annex init را اجرا کند نمایش داده خواهد شد.
.PP
پیکربندی گیت annex.pre\-init\-command یا قلاب (hook) pre\-init\-annex
پیش از مقداردهی اولیه اجرا می‌شود و می‌تواند با کد غیرصفر خارج شود تا از
مقداردهی اولیه جلوگیری کرده و همچنین سایر تنظیمات را انجام دهد.
.PP
.SH "مثال‌ها (EXAMPLES)"
.EX
 # git annex add foo
 git-annex: First run: git-annex init
 # git annex init
 init ok
 # git annex add foo
 add foo ok
.EE
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-version=N\fP"
.IP
مخزن را وادار می‌کند تا با استفاده از یک annex.version متفاوت نسبت به
پیش‌فرض فعلی، مقداردهی اولیه شود.
.IP
هنگامی که نسخه ارائه‌شده پشتیبانی نمی‌شود، اما امکان ارتقای خودکار به
یک نسخه جدیدتر وجود دارد، در عوض از نسخه جدیدتر استفاده خواهد کرد.
.IP
.IP "\fB\-\-autoenable\fP"
تنها مخازن ویژه دوردستی را فعال می‌کند که با autoenable=true پیکربندی شده‌اند؛
در غیر این صورت هیچ چیز را مقداردهی اولیه نمی‌کند.
.IP
.IP "\fB\-\-no\-autoenable\fP"
مخازن ویژه دوردستی را که با autoenable=true پیکربندی شده‌اند فعال نمی‌کند.
.IP
.IP "\fB\-\-json\fP"
خروجی JSON را فعال می‌کند. این قابلیت برای تجزیه توسط برنامه‌هایی که از
git-annex استفاده می‌کنند در نظر گرفته شده است.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
پیام‌هایی که به‌طور معمول به خروجی خطای استاندارد ارسال می‌شدند، در عوض
در داخل JSON گنجانده می‌شوند.
.IP
.IP
همچنین می‌توان از
.BR git-annex\-common\-options (1)
استفاده کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-describe (1)
.PP
.BR git-annex\-reinit (1)
.PP
.BR git\-init (1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>