---
url: /zh/repo/settings-issue.md
description: |
  通过 .cnb/settings.yml 自定义创建 Issue 按钮 的描述文字和悬浮图片。
---
定制创建 Issue 按钮的外观，让仓库更有特色。

## 配置方式

在仓库默认分支的 `.cnb/settings.yml` 中添加 `issue` 配置：

```yaml title=".cnb/settings.yml"
issue:
  button:
    description: ~bug~ 给你!
    hoverImage: https://cnb.cool/my/test/-/git/raw/main/issue-hover.png
```

## 参数说明

| 参数                        | 类型   | 默认值 | 说明                    |
| -------------------------- | ------ | ----- | ---------------------- |
| `issue.button.description` | string | -     | Issue 按钮的描述文字     |
| `issue.button.hoverImage`  | string | -     | 鼠标悬浮时显示的图片     |

`hoverImage` 支持仓库相对路径或 raw 地址，大小上限 10 MB。