管理当前代码库的 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

命令

无参数时，显示现有版本列表。

显示

显示 TAG 的 GitHub 版本说明。

使用 --show-downloads 包含“下载”部分。

创建

为指定的 TAG 名称创建一个 GitHub 版本。如果 git 标记 TAG 不存在，则将在 TARGET（默认值：当前分支）处创建该标记。

编辑

编辑指定 TAG 名称的 GitHub 版本。接受与 create 命令相同的选项。使用 --draft=false 发布草稿。

如果没有 --message 或 --file，则会自动填充当前版本标题和正文，打开文本编辑器。要重新使用现有标题和正文，请传递 -m ""。

下载

下载附加到指定 TAG 版本的资产。

删除

删除指定 TAG 的版本和关联资产。请注意，这不会删除 git 标记 TAG。

选项

-d, --include-drafts

将草稿与已发布的版本一起列出。

-p, --exclude-prereleases

从列表中排除预发布版本。

-L, --limit

仅显示前 LIMIT 个版本。

-d, --draft

创建草稿版本。

-p, --prerelease

创建预发布版本。

-a, --attach FILE

将文件作为该版本的资产附加。

如果 FILE 采用 "filename#text" 格式，则 "#" 字符后的文本将作为资产标签。

-m, --message MESSAGE

在 MESSAGE 中，直到第一个空白行之前的文本将被视为版本标题，其余内容将以 Markdown 格式用作版本说明。

当传递多个 --message 时，它们的值将用中间的空白行连接起来。

当在 release create 中既未提供 --message 也未提供 --file 时，将打开一个文本编辑器来编写标题和说明。

-F, --file 文件

从 文件 中读取版本标题和说明。可将其传为“-”以从标准输入中读取。另请参阅 --message 了解格式规则。

-e, --edit

在提交之前，在文本编辑器中打开版本标题和说明。可将其与 --message 或 --file 结合使用。

-o, --browse

在网络浏览器中打开新版本。

-c, --copy

将新版本的 URL 放置在剪贴板上，而不是打印它。

-t, --commitish 目标

将要附加版本上的提交 SHA 或分支名称，前提是 标签 不存在（默认：主分支）。

-i, --include 模式

将版本中的文件筛选为与全局 模式 匹配的文件。

-f, --format 格式

使用 格式 美观地打印版本（默认：“%T%n”）。有关在格式中如何使用占位符的一些额外详细信息，请参阅 git-log(1) 中的“美观格式”部分。问题可用的占位符为：

%U：此版本的 URL

%uT：tar 包 URL

%uZ：zip 包 URL

%uA：资产上传 URL

%S：状态（即“草稿”、“预发布”）

%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"（默认值）之一。

标签

此版本的 git 标签名。

另请参阅

hub(1)、git-tag(1)