'\" t
.TH "CARGO\-INIT" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-init \- ایجاد یک بسته Cargo جدید در یک دایرکتوری موجود
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo init\fR [\fIoptions\fR] [\fIpath\fR]
.SH "توضیحات (DESCRIPTION)"
این دستور یک مانیفست Cargo جدید در دایرکتوری جاری ایجاد می‌کند. برای ایجاد در یک دایرکتوری مشخص، یک مسیر (\fIpath\fR) را به عنوان آرگومان مشخص کنید.
.sp
اگر از قبل فایل‌های سورس Rust با نام‌گذاری‌های معمول در دایرکتوری وجود داشته باشند، از همان‌ها استفاده خواهد شد. در غیر این صورت، یک فایل نمونه \fBsrc/main.rs\fR ایجاد می‌شود، یا اگر \fB\-\-lib\fR ارسال شده باشد، فایل \fBsrc/lib.rs\fR ایجاد خواهد شد.
.sp
اگر دایرکتوری از قبل درون یک مخزن VCS نباشد، یک مخزن جدید ایجاد می‌شود (به \fB\-\-vcs\fR در زیر مراجعه کنید).
.sp
برای دستوری مشابه که یک بسته جدید را در یک دایرکتوری تازه ایجاد می‌کند، \fBcargo\-new\fR(1) را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های Init (Init Options)"
.sp
\fB\-\-bin\fR
.RS 4
یک بسته با هدف باینری (\fBsrc/main.rs\fR) ایجاد می‌کند.
این رفتار پیش‌فرض است.
.RE
.sp
\fB\-\-lib\fR
.RS 4
یک بسته با هدف کتابخانه‌ای (\fBsrc/lib.rs\fR) ایجاد می‌کند.
.RE
.sp
\fB\-\-edition\fR \fIedition\fR
.RS 4
ویرایش (edition) زبان Rust مورد استفاده را مشخص می‌کند. پیش‌فرض 2024 است.
مقادیر ممکن: 2015, 2018, 2021, 2024
.RE
.sp
\fB\-\-name\fR \fIname\fR
.RS 4
نام بسته را تنظیم می‌کند. پیش‌فرض، نام دایرکتوری است.
.RE
.sp
\fB\-\-vcs\fR \fIvcs\fR
.RS 4
یک مخزن VCS جدید برای سامانه کنترل نسخه مشخص‌شده (git، hg، pijul یا fossil) مقداردهی اولیه می‌کند یا هیچ سامانه کنترل نسخه‌ای را مقداردهی نمی‌کند (none). در صورت عدم تعیین، مقدار پیش‌فرض \fBgit\fR یا مقدار پیکربندی \fBcargo\-new.vcs\fR خواهد بود، و در صورتی که دایرکتوری از قبل درون یک مخزن VCS باشد مقدار \fBnone\fR لحاظ می‌شود.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
این گزینه فیلد \fBpublish\fR را در \fBCargo.toml\fR روی نام رجیستری ارائه‌شده تنظیم می‌کند که انتشار را تنها به همان رجیستری محدود خواهد ساخت.
.sp
نام‌های رجیستری در \fIفایل‌های پیکربندی Cargo\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعریف می‌شوند.
در صورت عدم تعیین، رجیستری پیش‌فرض تعیین‌شده توسط کلید پیکربندی \fBregistry.default\fR استفاده می‌شود. اگر رجیستری پیش‌فرض تنظیم نشده باشد و از \fB\-\-registry\fR نیز استفاده نشود، فیلد \fBpublish\fR تنظیم نخواهد شد که به معنای عدم وجود محدودیت در انتشار است.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو (verbose). برای دریافت خروجی \[lq]بسیار پرگو\[rq] که شامل اطلاعات اضافی از قبیل هشدارهای وابستگی و خروجی اسکریپت ساخت است، می‌تواند دو بار مشخص شود.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& \fBterm.verbose\fR تعیین شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های لاگ کارگو را چاپ نمی‌کند.
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& \fBterm.quiet\fR تعیین شود.
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
زمان استفاده از خروجی رنگی را کنترل می‌کند. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): تشخیص خودکار اینکه آیا ترمینال از خروجی رنگی پشتیبانی می‌کند یا خیر.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: همیشه رنگ‌ها را نمایش می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: هرگز رنگ‌ها را نمایش نمی‌دهد.
.RE
.sp
همچنین می‌تواند از طریق \fIمقدار پیکربندی\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& \fBterm.color\fR تعیین شود.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo به وسیله rustup نصب شده باشد و اولین آرگومان \fBcargo\fR با \fB+\fR آغاز شود، به عنوان نام زنجیره ابزار (toolchain) در rustup تفسیر می‌شود (مانند \fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر درباره نحوه کار بازنویسی‌های زنجیره ابزار، به \fIمستندات rustup\fR <https://rust\-lang.github.io/rustup/overrides.html> مراجعه کنید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR or \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. آرگومان باید در ساختار TOML به صورت \fBKEY=VALUE\fR باشد، یا به عنوان مسیر یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار مشخص شود.
برای اطلاعات بیشتر، \fIبخش بازنویسی‌های خط فرمان\fR <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> را ببینید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری جاری را پیش از اجرای هرگونه عملیات مشخص‌شده تغییر می‌دهد. این گزینه بر مواردی چون محل جستجوی پیش‌فرض کارگو برای مانیفست پروژه (\fBCargo.toml\fR) و دایرکتوری‌های بررسی‌شده جهت یافتن مواردی مانند \fB\&.cargo/config.toml\fR تأثیر می‌گذارد. این گزینه باید قبل از نام دستور درج شود، برای مثال \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه فقط در \fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> موجود است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد (مشاهده کنید: \fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098>).
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را چاپ می‌کند.
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (فقط مخصوص nightly) برای Cargo. برای جزئیات، \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات درباره متغیرهای محیطی که Cargo آن‌ها را می‌خواند، به \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: کارگو با موفقیت اجرا شد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: کارگو موفق به تکمیل عملیات نشد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'ایجاد یک بسته باینری Cargo در دایرکتوری جاری:
.sp
.RS 4
.nf
cargo init
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-new\fR(1)