管理当前代码库的 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
也不使用--file
向issue 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
为标签列表启用彩色输出。