---
url: /zh/repo/settings-issue.md
description: 介绍如何通过 .cnb/settings.yml 定制仓库创建 Issue 按钮的描述文字和悬浮图片，为仓库社区营造个性化的贡献氛围。
---
定制创建 Issue 按钮的外观，让你的仓库更有个性。

## 使用场景

* 为仓库的 Issue 按钮添加趣味性描述
* 通过悬浮图片提供更好的视觉引导
* 营造独特的社区贡献氛围

## 配置方式

在 `.cnb/settings.yml` 中添加 `issue` 配置：

```yaml title=".cnb/settings.yml"
# issue 配置，读取仓库默认分支 .cnb/settings.yml 配置
issue:
  # 定制创建 issue 按钮
  button:
    # 按钮描述
    description: ~bug~ 给你!
    # 鼠标悬浮在按钮上显示的图片
    # 1.用仓库中默认分支的图片，填写相对仓库根目录的路径，如 .cnb/issue-hover.png;
    # 2.使用当前域名下的文件 raw 地址，比如：https://cnb.cool/my/test/-/git/raw/main/issue-hover.png
    # 图片最大 10MB
    hoverImage: https://cnb.cool/my/test/-/git/raw/main/issue-hover.png
```

## 参数说明

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `issue.button.description` | string | - | Issue 按钮的描述文字 |
| `issue.button.hoverImage` | string | - | 鼠标悬浮时显示的图片，支持仓库相对路径或 raw 地址，最大 10MB |