关于网页中页脚徽章的制作(一)
动态 XML 徽章(Shields.io)使用指南
目录
动态 XML 徽章(Shields.io)使用指南
官网一、什么是动态 XML 徽章?
动态 XML 徽章(Dynamic XML Badge)是 shields.io 提供的可自定义的徽章生成服务,用于在 GitHub、文档或网页中显示动态信息(如版本号、构建状态、下载量等)。通过 URL 参数可灵活配置徽章样式和内容,支持多种主题和颜色。
二、快速入门:生成徽章
1. 基础语法
动态 XML 徽章的 URL 格式为:
https://shields.io/badge/<label>-<message>-<color>
- 参数说明:
<label>
:徽章左侧的标签(如Version
、Build
)。<message>
:徽章右侧的动态信息(如v1.0.0
、Passing
)。<color>
:徽章背景颜色(支持名称或十六进制代码,如green
、#4C9
)。
2. 示例
生成一个绿色的“版本 v2.1.3”徽章:

渲染结果:
三、高级用法与参数配置
1. 自定义颜色
支持以下颜色格式:
- 预设颜色名称:
brightgreen
、orange
、red
、blue
等。 - 十六进制颜色代码:如
#4C1
(亮绿色)、#e05d44
(橙色)。
示例:使用十六进制颜色

渲染结果:
2. 动态数据源
若需从外部 API 获取动态数据(如 GitHub 仓库的星级或下载量),可使用 Shields.io 的动态徽章 功能。
格式:
https://shields.io/badge/<label>-<API_endpoint>-<color>
例如,获取 GitHub 仓库的星级:

3. 多语言与编码
- 特殊字符:需对空格等字符进行 URL 编码(如空格替换为 %20)。
- 中文支持:直接使用中文参数,但需确保 URL 编码正确。

渲染结果:
常见应用场景
1. GitHub 仓库 README
在 README.md 中添加构建状态徽章:

渲染结果:
2. 文档版本说明
展示文档版本:

渲染结果:
3. 网站底部版权信息
在网站底部添加版权信息:

渲染结果:
4.依赖管理
在依赖管理页面添加依赖徽章:

渲染结果:
更多示例
# My Project



渲染结果:
更多示例,请访问 Shields.io 网站。