hub-release(1) hub manual hub-release(1)

hub-release - مدیریت انتشارهای GitHub برای مخزن جاری

hub release [--include-drafts] [--exclude-prereleases] [-L LIMIT] [-f FORMAT]
hub release show [-f FORMAT] TAG
hub release create [-dpoc] [-a FILE] [-m MESSAGE|-F FILE] [-t TARGET] TAG
hub release edit [options] TAG
hub release download TAG [-i PATTERN]
hub release delete TAG

بدون هیچ آرگومانی، فهرستی از انتشارهای موجود را نمایش می‌دهد.

show

نمایش یادداشت‌های انتشار GitHub برای TAG.

با --show-downloads، بخش "Downloads" نیز گنجانده می‌شود.

create

ایجاد یک انتشار GitHub برای نام TAG مشخص‌شده. اگر برچسب git با نام TAG وجود نداشته باشد، روی TARGET ایجاد خواهد شد (پیش‌فرض: شاخهٔ جاری).

edit

ویرایش انتشار GitHub برای نام TAG مشخص‌شده. همان گزینه‌های دستور create را می‌پذیرد. انتشار یک پیش‌نویس با --draft=false.

بدون --message یا --file، یک ویرایشگر متن باز خواهد شد که از قبل با عنوان و بدنهٔ انتشار فعلی پر شده است. برای استفادهٔ مجدد از عنوان و بدنهٔ موجود بدون تغییر، -m "" را ارسال کنید.

download

بارگیری دارایی‌های (assets) پیوست‌شده به انتشار برای TAG مشخص‌شده.

delete

حذف انتشار و دارایی‌های مرتبط با آن برای TAG مشخص‌شده. توجه داشته باشید که این دستور برچسب git با نام TAG را حذف نمی‌کند.

-d, --include-drafts

فهرست کردن پیش‌نویس‌ها در کنار انتشارهای منتشرشده.

-p, --exclude-prereleases

مستثنی کردن پیش‌انتشارها از فهرست.

-L, --limit

نمایش تنها به تعداد LIMIT انتشار اول.

-d, --draft

ایجاد یک انتشار پیش‌نویس.

-p, --prerelease

ایجاد یک پیش‌انتشار.

-a, --attach FILE

پیوست کردن یک فایل به عنوان دارایی (asset) برای این انتشار.

اگر FILE در قالب "filename#text" باشد، متن پس از نویسهٔ "#" به عنوان برچسب دارایی در نظر گرفته می‌شود.

-m, --message MESSAGE

متن تا نخستین خط خالی در MESSAGE به عنوان عنوان انتشار در نظر گرفته شده و مابقی آن به عنوان توضیحات انتشار در قالب Markdown استفاده می‌شود.

هنگامی که چندین --message ارسال شود، مقادیر آن‌ها با یک خط خالی در میانشان به یکدیگر متصل می‌شوند.

اگر نه --message و نه --file به release create داده نشوند، یک ویرایشگر متن برای نوشتن عنوان و توضیحات باز خواهد شد.

-F, --file FILE

خواندن عنوان و توضیحات انتشار از FILE. برای خواندن از ورودی استاندارد به جای فایل، "-" را ارسال کنید. برای قواعد قالب‌بندی به --message مراجعه کنید.

-e, --edit

باز کردن عنوان و توضیحات انتشار در یک ویرایشگر متن پیش از ارسال نهایی. این گزینه می‌تواند در ترکیب با --message یا --file استفاده شود.

-o, --browse

باز کردن انتشار جدید در مرورگر وب.

-c, --copy

قرار دادن نشانی (URL) انتشار جدید در کلیپ‌بورد به جای چاپ کردن آن.

-t, --commitish TARGET

یک SHA کامیت یا نام شاخه برای پیوست کردن انتشار به آن؛ تنها در صورتی استفاده می‌شود که TAG از قبل وجود نداشته باشد (پیش‌فرض: شاخهٔ اصلی).

-i, --include PATTERN

پالایش فایل‌های انتشار به مواردی که با الگوی تطابق PATTERN همخوانی دارند.

-f, --format FORMAT

چاپ زیبای انتشارها با استفاده از FORMAT (پیش‌فرض: "%T%n"). برای جزئیات بیشتر در مورد چگونگی استفاده از جای‌نگه‌دارها در قالب، بخش "PRETTY FORMATS" از git-log(1) را ببینید. جای‌نگه‌دارهای موجود عبارتند از:

%U: نشانی (URL) این انتشار

%uT: نشانی tarball

%uZ: نشانی zipball

%uA: نشانی بارگذاری دارایی

%S: وضعیت (مانند "draft"، "pre-release")

%sC: تنظیم رنگ به زرد یا قرمز، بسته به وضعیت

%t: نام انتشار

%T: برچسب انتشار

%b: بدنه

%as: فهرست دارایی‌های پیوست‌شده به این انتشار

%cD: فقط تاریخ ایجاد (بدون زمان و ساعت روز)

%cr: تاریخ ایجاد، نسبی

%ct: تاریخ ایجاد، برچسب زمانی UNIX

%cI: تاریخ ایجاد، در قالب ISO 8601

%pD: فقط تاریخ انتشار (بدون زمان و ساعت روز)

%pr: تاریخ انتشار، نسبی

%pt: تاریخ انتشار، برچسب زمانی UNIX

%pI: تاریخ انتشار، در قالب ISO 8601

%n: خط جدید

%%: نویسهٔ خود %

--color[=WHEN]

فعال کردن خروجی رنگی حتی اگر stdout یک ترمینال نباشد. WHEN می‌تواند یکی از مقادیر "always" (پیش‌فرض برای --color)، "never"، یا "auto" (پیش‌فرض) باشد.

TAG

نام برچسب git برای این انتشار.

hub(1), git-tag(1)

12 Jul 2024 hub version 2.14.2