# Svg Badge Tool

**Repository Path**: hamm/svg_badge_tool

## Basic Information

- **Project Name**: Svg Badge Tool
- **Description**: Svg Badge Tool是一个快速生成SVG的小工具，支持传入参数进行生成svg的可外链小图标。
- **Primary Language**: PHP
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://svg.hamm.cn
- **GVP Project**: No

## Statistics

- **Stars**: 116
- **Forks**: 24
- **Created**: 2019-12-14
- **Last Updated**: 2025-05-22

## Categories & Tags

**Categories**: image-processing

**Tags**: Gitee, Badge, svg

## README


## 一、项目介绍

Svg Badge Tool是一个快速生成SVG的小工具，支持传入参数进行生成svg的可外链小图标。

## 二、快速接入

### 1. 普通标签

![SVG](https://svg.hamm.cn/badge.svg?key=芬&value=必得&color=ff4500&radius=3 "SVG") ![SVG](https://svg.hamm.cn/badge.svg?key=博客&value=Hamm.cn "SVG")

```
接入地址：https://svg.hamm.cn/badge.svg
参数说明：
    key:标签头 必须
    value:标签内容 必须
    radis:标签圆角 选填 默认3
    color:标签颜色 选填 默认随机

示例：
    https://svg.hamm.cn/badge.svg?key=芬&value=必得&color=ff4500&radius=3
    https://svg.hamm.cn/badge.svg?key=博客&value=Hamm.cn
```

### 2. Gitee 标签

- 仓库标签

![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=star "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=watch "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=fork "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=commit "SVG")
![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=language "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=license "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=issue "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=branch "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=release "SVG")


```
接入地址：https://svg.hamm.cn/gitee.svg
参数说明：
    user:用户 必须
    project:项目 必须
    type:类型 必须 固定值为：
        - watch 项目watch人数
        - fork 项目fork人数
        - star 项目star数量
        - commit 项目提交次数
        - license 项目使用的开源协议
        - language 项目使用主要编程语言
        - issue 项目打开的Issues数量
        - branch 默认分支
        - release 最新的Release
    radis:标签圆角 选填 默认3
    color:标签颜色 选填 默认 #404550
    bg:标题颜色 默认Gitee主题色 #c71d23
    title:标签的Title 选填 默认Gitee
    logo:是否显示Gitee Logo 默认yes 其他值隐藏Logo

示例：
    https://svg.hamm.cn/gitee.svg?user=hamm&project=svg_badge_tool&type=star&color=ff4500&radius=3
```

- 用户标签

![SVG](https://svg.hamm.cn/gitee-user.svg?user=hamm "SVG")


```
接入地址：https://svg.hamm.cn/gitee-user.svg
参数说明：
    user:用户 必须

示例：
    https://svg.hamm.cn/gitee-user.svg?user=hamm
```


### 3. 微博标签

![SVG](https://svg.hamm.cn/weibo.svg?user=5898441253&type=followers "SVG") ![SVG](https://svg.hamm.cn/weibo.svg?user=5898441253&type=following "SVG")

```
接入地址：https://svg.hamm.cn/weibo.svg
参数说明：
    user:用户UID 必须
    type:类型 必须 固定值为：
        - followers 粉丝人数
        - following 关注人数
    radis:标签圆角 选填 默认3
    color:标签颜色 选填 默认 #404550
    bg:标题颜色 默认Gitee主题色 #c71d23
    title:标签的Title 选填 默认Gitee

示例：
    https://svg.hamm.cn/weibo.svg?user=5898441253&type=followers&color=ff4500&radius=3
```

### 4. 客户端标签

![SVG](https://svg.hamm.cn/client.svg?type=os "SVG") ![SVG](https://svg.hamm.cn/client.svg?type=broswer "SVG") ![SVG](https://svg.hamm.cn/client.svg?type=ip "SVG")

```
接入地址：https://svg.hamm.cn/client.svg
参数说明：
    type:类型 必须 固定值为：
        - os 操作系统
        - ip IP地址
        - broswer 浏览器
    radis:标签圆角 选填 默认3
    color:标签颜色 选填 默认随机

示例：
    https://svg.hamm.cn/client.svg?type=os&color=ff4500&radius=3
```


### 5. 平台粉丝标签

![SVG](https://svg.hamm.cn/github.svg?type=fans&user=hammcn "SVG") ![SVG](https://svg.hamm.cn/gitee.svg?type=fans&user=hamm "SVG") ![SVG](https://svg.hamm.cn/juejin.svg?type=fans&user=475426363282808 "SVG")

```
接入地址：

// Github: https://svg.hamm.cn/github.svg
// Gitee: https://svg.hamm.cn/gitee.svg
// 掘金：https://svg.hamm.cn/juejin.svg

参数说明：
    type:类型 必须 固定值为：
        - fans 粉丝数
    radis:标签圆角 选填 默认3
    color:标签颜色 选填 默认随机

示例：
    https://svg.hamm.cn/juejin.svg?type=fans&user=475426363282808&color=ff4500&radius=3
```

## 三、私有部署

Clone代码到本地，配置站点后即可使用，但后缀是.php，你也可以配置好伪静态，这样可能看起来更舒服：

```
if($request_uri ~* ^(.*?)svg(.*?)$){
    rewrite  ^/(.*?)svg(.*?)$  /$1php$2 break;
}
```

## 四、Enjoy it!