1. hub-issue(1)
  2. hub 手册
  3. hub-issue(1)

管理当前代码库的 GitHub 问题

概要

hub issue [-a 负责人] [-c 创建者] [-@ 用户] [-s 状态] [-f 格式] [-M 里程碑] [-l 标签] [-d 日期] [-o 排序键 [-^]] [-L 限制]
hub issue show [-f 格式] 编号
hub issue create [-oc] [-m 消息|-F 文件] [--edit] [-a 用户] [-M 里程碑] [-l 标签]
hub issue update 编号 [-m 消息|-F 文件] [--edit] [-a 用户] [-M 里程碑] [-l 标签] [-s 状态]
hub issue labels [--color]
hub issue transfer 编号 代码库

命令

若不带参数,则显示打开的问题列表

显示
显示由 编号 指定的现有问题
创建
在当前代码库中打开问题
更新
更新由 编号 指定的现有问题的字段。使用 --edit 在文本编辑器中以交互方式编辑标题和消息
标签
列出此代码库中可用的标签
转移
将问题转移到另一个代码库

选项

-a, --assignee 负责人

在列表模式中,仅显示分配给 负责人 的问题

-a, --assign 用户

要分配至创建的问题的 GitHub 用户的逗号分隔列表

-c, --creator 创建者

仅显示由 创建者 创建的问题

-@, --mentioned 用户

仅显示提及 用户 的问题

-s, --state 状态

显示状态为 状态 的问题(默认:"打开")。

-f, --format 格式

使用格式 格式 以漂亮方式打印问题内容(默认:" %sC%>(8)%i%Creset %t% l %n" )。请参阅 git-log(1) 的“漂亮格式”部分以了解有关如何在格式中使用占位符的更多详细信息。问题可用的占位符包括

%I: 问题编号

%i: 以 "#" 为前缀的问题编号

%U: 此问题的 URL

%S: 状态(例如"打开"、"关闭")

%sC: 根据问题状态设置颜色为红色或绿色。

%t: 标题

%l: 有颜色的标签

%L: 原始的逗号分隔标签

%b: 正文

%au: 作者的登录名

%as: 分配人的逗号分隔列表

%Mn: 里程碑编号

%Mt: 里程碑标题

%NC: 评论数

%Nc: 以括号括起来的评论数,如果为零,则为空字符串。

%cD: 创建的日期(无时间)

%cr: 创建的日期,相对的

%ct: 创建的日期,UNIX 时间戳

%cI: 创建的日期,ISO 8601 格式

%uD: 更新的日期(无时间)

%ur: 更新的日期,相对的

%ut: 更新的日期,UNIX 时间戳

%uI: 更新的日期,ISO 8601 格式

%n: 新行

%%: 一个文本 %

--color[=何时]

即使 stdout 不是终端,也启用彩色输出。WHEN 可以是“always”(--color 的默认值)、“never”或“auto”(默认值)。

-m, --message MESSAGE

MESSAGE 中第一个空格符之前的文本视为问题标题,其余文本则使用 Markdown 格式作为问题描述。

当传递多个 --message 时,其值将使用空格符分隔后连接在一起。

当既未使用 --message 也不使用 --fileissue create 提供信息时,将会打开一个文本编辑器以撰写标题和描述。

-F, --file FILE

FILE 读取问题标题和描述。传递“-”以从标准输入读取。有关格式化规则,请参阅 --message

-e, --edit

在提交之前,在文本编辑器中打开问题标题和描述。可以将其与 --message--file 结合使用。

-o, --browse

在 Web 浏览器中打开新问题。

-c, --copy

将新问题的 URL 放入剪贴板,而不是将其打印出来。

-M, --milestone NAME

仅显示名称为 NAME 的 GitHub 里程碑的问题。

打开问题时,将此问题添加到名称为 NAME 的 GitHub 里程碑。传递里程碑编号已弃用。

-l, --labels LABELS

仅显示具有某些标签的问题。

打开问题时,将以逗号分隔的标签列表添加到此问题。

-d, --since DATE

仅显示自 ISO 8601 格式的 DATE 更新的问题。

-o, --sort KEY

按“created”(默认值)、“updated”或“comments”对显示的问题进行排序。

-^ --sort-ascending

按升序而不是降序对日期排序。

-L, --limit LIMIT

仅显示前 LIMIT 个问题。

--include-pulls

包括拉取请求和问题。

--color

为标签列表启用彩色输出。

另请参阅

hub-pr(1), hub(1)