.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "BUNDLE\-GEM" "1" "September 2025" ""
.SH "نام (NAME)"
\fBbundle\-gem\fR \- ایجاد ساختار اولیه پروژه برای ساخت یک rubygem
.SH "خلاصه دستور (SYNOPSIS)"
\fBbundle gem\fR \fIGEM_NAME\fR \fIOPTIONS\fR
.SH "توضیحات (DESCRIPTION)"
پوشه‌ای به نام \fBGEM_NAME\fR شامل یک \fBRakefile\fR، \fBGEM_NAME\.gemspec\fR و سایر فایل‌ها و دایرکتوری‌های پشتیبان تولید می‌کند که می‌توان از آن‌ها برای توسعه یک rubygem با همان نام استفاده کرد\.
.P
دستور \fBrake \-T\fR را درون پروژه حاصل اجرا کنید تا فهرستی از وظایف Rake که می‌توان برای آزمودن و انتشار gem در rubygems\.org استفاده کرد را مشاهده نمایید\.
.P
ساختار اولیه پروژه تولیدشده را می‌توان با استفاده از گزینه‌ها (OPTIONS) سفارشی‌سازی کرد، همان‌طور که در ادامه توضیح داده شده است\. توجه داشته باشید که این گزینه‌ها را می‌توان از طریق فایل پیکربندی سراسری Bundler نیز با نام‌های زیر مشخص کرد:
.IP "\(bu" 4
\fBgem\.coc\fR
.IP "\(bu" 4
\fBgem\.mit\fR
.IP "\(bu" 4
\fBgem\.test\fR
.IP "" 0
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-exe\fR, \fB\-\-bin\fR, \fB\-b\fR
مشخص می‌کند که Bundler باید یک فایل اجرایی باینری (به‌صورت \fBexe/GEM_NAME\fR) در پروژه rubygem تولیدشده بسازد\. این باینری همچنین به مانیفست \fBGEM_NAME\.gemspec\fR اضافه خواهد شد\. این رفتار به‌طور پیش‌فرض غیرفعال است\.
.TP
\fB\-\-no\-exe\fR
فایل باینری ایجاد نکند (گزینه \fB\-\-exe\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-coc\fR
یک فایل \fBCODE_OF_CONDUCT\.md\fR به ریشه پروژه تولیدشده اضافه کند\. در صورت عدم تعیین این گزینه، یک اعلان تعاملی نمایش داده می‌شود و پاسخ در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\.
.TP
\fB\-\-no\-coc\fR
فایل \fBCODE_OF_CONDUCT\.md\fR را ایجاد نکند (گزینه \fB\-\-coc\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-changelog\fR
یک فایل \fBCHANGELOG\.md\fR به ریشه پروژه تولیدشده اضافه کند\. در صورت عدم تعیین این گزینه، یک اعلان تعاملی نمایش داده می‌شود و پاسخ در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\. مقدار پیش‌فرض را با دستور \fBbundle config set \-\-global gem\.changelog <true|false>\fR به‌روزرسانی کنید\.
.TP
\fB\-\-no\-changelog\fR
فایل \fBCHANGELOG\.md\fR را ایجاد نکند (گزینه \fB\-\-changelog\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-ext=c\fR, \fB\-\-ext=go\fR, \fB\-\-ext=rust\fR
قالب اولیه (boilerplate) برای کدهای افزونه C، Go (در حال حاضر بر پایه go\-gem\-wrapper \fIhttps://github\.com/ruby\-go\-gem/go\-gem\-wrapper\fR) یا Rust (در حال حاضر بر پایه magnus \fIhttps://docs\.rs/magnus\fR) به پروژه تولیدشده اضافه کند\. این رفتار به‌طور پیش‌فرض غیرفعال است\.
.TP
\fB\-\-no\-ext\fR
کد افزونه اضافه نکند (گزینه \fB\-\-ext\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-git\fR
یک مخزن git درون کتابخانه شما مقداردهی اولیه کند\.
.TP
\fB\-\-github\-username=GITHUB_USERNAME\fR
نام کاربری GitHub را در فایل README درج کند تا نیازی به انجام دستی آن نباشد\. با دستور \fBbundle config set \-\-global gem\.github_username <your_username>\fR یک مقدار پیش‌فرض تنظیم کنید\.
.TP
\fB\-\-mit\fR
یک مجوز MIT را در فایل \fBLICENSE\.txt\fR در ریشه پروژه تولیدشده اضافه کند\. نام شما از پیکربندی سراسری git برای بیانیه حق نشر (کپی‌رایت) استفاده خواهد شد\. در صورت عدم تعیین این گزینه، یک اعلان تعاملی نمایش داده می‌شود و پاسخ در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\.
.TP
\fB\-\-no\-mit\fR
فایل \fBLICENSE\.txt\fR را ایجاد نکند (گزینه \fB\-\-mit\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-t\fR, \fB\-\-test=minitest\fR, \fB\-\-test=rspec\fR, \fB\-\-test=test\-unit\fR
چارچوب آزمایشی را که Bundler باید هنگام تولید پروژه استفاده کند مشخص می‌سازد\. مقادیر مجاز عبارتند از \fBminitest\fR، \fBrspec\fR و \fBtest\-unit\fR\. فایل \fBGEM_NAME\.gemspec\fR پیکربندی شده و یک دایرکتوری پایه test/spec بر اساس این گزینه ایجاد خواهد شد\. در صورتی که گزینه‌ای مشخص نشود:
.IP
اگر Bundler برای ایجاد آزمون‌ها پیکربندی شده باشد، این مورد به‌طور پیش‌فرض به تنظیمات سراسری \fBgem\.test\fR در Bundler بازمی‌گردد\.
.IP
اگر Bundler برای عدم ایجاد آزمون‌ها پیکربندی شده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی برای پروژه rubygem فعلی اعمال خواهد شد\.
.IP
اگر Bundler پیکربندی نشده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\.
.TP
\fB\-\-no\-test\fR
از چارچوب آزمایشی استفاده نکند (گزینه \fB\-\-test\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-ci\fR, \fB\-\-ci=circle\fR, \fB\-\-ci=github\fR, \fB\-\-ci=gitlab\fR
سرویس یکپارچه‌سازی مداوم (CI) مورد استفاده Bundler در زمان تولید پروژه را تعیین می‌کند\. مقادیر مجاز عبارتند از \fBgithub\fR، \fBgitlab\fR و \fBcircle\fR\. یک فایل پیکربندی در دایرکتوری پروژه ایجاد خواهد شد\. در صورتی که گزینه‌ای مشخص نشود:
.IP
اگر Bundler برای ایجاد فایل‌های CI پیکربندی شده باشد، به‌طور پیش‌فرض از تنظیمات سراسری \fBgem\.ci\fR در Bundler استفاده می‌کند\.
.IP
اگر Bundler برای عدم ایجاد فایل‌های CI پیکربندی شده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی برای پروژه rubygem فعلی اعمال خواهد شد\.
.IP
اگر Bundler پیکربندی نشده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\.
.TP
\fB\-\-no\-ci\fR
از سرویس یکپارچه‌سازی مداوم استفاده نکند (گزینه \fB\-\-ci\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-linter\fR, \fB\-\-linter=rubocop\fR, \fB\-\-linter=standard\fR
ابزار لینتر و قالب‌بندی کدی که Bundler باید به وابستگی‌های توسعه پروژه اضافه کند را مشخص می‌سازد\. مقادیر مجاز عبارتند از \fBrubocop\fR و \fBstandard\fR\. یک فایل پیکربندی در دایرکتوری پروژه ایجاد خواهد شد\. در صورتی که گزینه‌ای مشخص نشود:
.IP
اگر Bundler برای افزودن لینتر پیکربندی شده باشد، به‌طور پیش‌فرض از تنظیمات سراسری \fBgem\.linter\fR در Bundler استفاده خواهد شد\.
.IP
اگر Bundler برای عدم افزودن لینتر پیکربندی شده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی برای پروژه rubygem فعلی استفاده خواهد شد\.
.IP
اگر Bundler پیکربندی نشده باشد، یک اعلان تعاملی نمایش داده شده و پاسخ دریافتی در پیکربندی سراسری Bundler برای استفاده‌های بعدی \fBbundle gem\fR ذخیره خواهد شد\.
.TP
\fB\-\-no\-linter\fR
لینتر اضافه نکند (گزینه \fB\-\-linter\fR مشخص‌شده در پیکربندی سراسری را لغو می‌کند)\.
.TP
\fB\-\-edit=EDIT\fR, \fB\-e=EDIT\fR
فایل GEM_NAME\.gemspec ایجادشده را در ویرایشگر EDIT، یا در صورت عدم تعیین، در ویرایشگر پیش‌فرض باز کند\. مقدار پیش‌فرض \fB$BUNDLER_EDITOR\fR، \fB$VISUAL\fR یا \fB$EDITOR\fR است\.
.TP
\fB\-\-bundle\fR
پس از ایجاد gem دستور \fBbundle install\fR را اجرا کند\.
.TP
\fB\-\-no\-bundle\fR
پس از ایجاد gem دستور \fBbundle install\fR را اجرا نکند\.
.SH "همچنین ببینید (SEE ALSO)"
.IP "\(bu" 4
bundle config(1) \fIbundle\-config\.1\.html\fR
.IP "" 0