---
url: /zh/repo/settings-fork.md
description: |
  介绍如何通过 .cnb/settings.yml 定制仓库 Fork 按钮的描述文字和鼠标悬浮图片， 为开源项目营造个性化的 Fork 体验。
---
自定义 Fork 按钮外观，让 Fork 操作更有趣。

## 使用场景

* 为 Fork 按钮添加个性化描述
* 通过悬浮图片吸引用户 Fork 项目，在开源社区营造友好的贡献氛围

## 配置方式

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

```yaml title=".cnb/settings.yml"
fork:
  button:
    description: 你的仓库不错，现在是我的了
    hoverImage: .cnb/fork-hover.png
```

## 参数说明

* **`fork.button.description`** (string)

  Fork 按钮的描述文字。

* **`fork.button.hoverImage`** (string)

  鼠标悬浮时显示的图片，支持仓库相对路径或 raw 地址，大小上限 10 MB。
