这是 Shields.io 的主页，它提供了简洁、一致且易读的 SVG 和光栅格式徽章，可以轻松地包含在 GitHub 的 readme 文件或其他任何网页中。该服务支持数十种持续集成服务、包注册表、发行版、应用商店、社交网络、代码覆盖服务和代码分析服务。每个月它提供超过 16 亿张图片，并被世界上一些最受欢迎的开源项目所使用，包括 VS Code、Vue.js 和 Bootstrap 等。
本仓库托管：
- Shields.io 的前端和服务器代码
- 一个用于生成徽章的 NPM 库
- 徽章设计规范
- 代码覆盖率百分比：
- 稳定版本发布：
- 包管理器发布：
- 第三方依赖状态：
- 静态代码分析等级：
- SemVer 版本遵守：
- 每周 Liberapay 捐款金额：
- Python 包下载量：
- Chrome 网上应用店扩展评分：
- Uptime Robot 百分比：
制作你自己的徽章！
（快速示例：https://img.shields.io/badge/left-right-f39f37）
浏览 完整的徽章列表 并通过搜索栏或浏览类别找到特定的徽章。点击徽章以填写该类型徽章所需的数据元素（如你的用户名或仓库）并可选地自定义（标签、颜色等）。然后就可以使用了！
使用底部的按钮复制你的徽章 url 或代码片段，然后可以添加到你的 GitHub readme 文件或其他网页上。
Shields 是一个社区项目。我们邀请你通过问题和拉取请求参与进来！你可以浏览 贡献指南。
添加或更改服务时 请添加测试。
这个项目有很多积压的建议！如果你是新来的，也许你愿意打开一个拉取请求来处理它们中的一个。
你可以阅读一个 如何添加徽章的教程。
如果你想报告或贡献与安全漏洞相关的修复，请首先参考我们的 安全政策。
- 安装 Node 20 或更高版本。你可以使用你选择的 [包管理器][]。 测试需要在 Node 20 和 22 中通过。
- 克隆这个仓库。
- 运行
npm ci安装依赖项。 - 运行
npm start启动徽章服务器和前端开发服务器。 - 打开
http://localhost:3000/查看前端。
当服务器源文件更改时，徽章服务器应该自动重启（使用 nodemon）。当前端文件更改时，前端开发服务器（docusaurus start）也应该自动重新加载。但是徽章定义只在服务器首次启动前构建。要重新生成它们，要么运行 npm run prestart 或手动重启服务器。
要从命令行调试徽章，运行 npm run badge -- /npm/v/nock。
它也可以使用完整的 URL 工作，如
npm run badge -- https://img.shields.io/npm/v/nock。
使用 npm run debug:server 以调试模式启动服务器。
这个配方 展示了如何在 VS Code 中调试 Node.js 应用程序。
Shields 对 Gitpod 有实验性支持，这是一个预配置的开发环境，可以在你的浏览器中运行。要使用 Gitpod，点击下面的按钮并用 GitHub 登录。Gitpod 还提供了一个浏览器插件，尽管不是必需的。 请在问题 #2772 中报告任何 Gitpod 错误、问题或建议。
[快照测试][] 确保我们不会无意中做出影响 SVG 或 JSON 输出的更改。当故意更改输出时，运行 SNAPSHOT_DRY=1 npm run test:package 预览对保存的快照的更改，并使用 SNAPSHOT_UPDATE=1 npm run test:package 更新它们。
服务器可以配置为使用 Sentry (配置) 和 Prometheus (配置)。
有关 托管你自己的服务器 的文档。
状态徽章在开源和私有软件项目中被广泛使用。 学者们研究了徽章提供的关于软件项目质量的“信号”。有许多现有的库用于渲染这些徽章，以及 Shields 徽章服务的替代品。awesome-badges 是这些资源的精选集合。 贡献 可能会被考虑在那里。 （该项目在该集合中的存在不应被解释为 Shields 项目的背书或推广）
b.adge.me 是这项服务的原始网站。当时 Heroku 有一个特性，使得使用顶级域名变得困难，因此域名看起来很奇怪。它使用的代码来自 2013 年的一个名为 gh-badges 的库，两者都是由 Thaddée Tyl 开发的。 该项目通过使用 b.adge.me 代码并与 shields.io 合并，关闭了 b.adge.me。
最初的徽章规范是在 2013 年由 Olivier Lacan 开发的。它受到了 Travis CI 和类似徽章的启发（那时候徽章少得多）。2014 年，Thaddée Tyl 在 Travis CI 的一名员工的帮助下重新设计了它，并说服大家切换到它。旧的设计就是现在所说的塑料风格；新的是平面风格。
你可以阅读更多关于 项目起源、SVG 徽章规范的动机 和 规范本身。
维护者：
- calebcartwright (核心团队)
- chris48s (核心团队)
- Daniel15 (核心团队)
- paulmelnikow (核心团队)
- platan (核心团队)
- PyvesB (核心团队)
- RedSparr0w (核心团队)
运营：
校友：
所有资产和代码都在 CC0 许可证 下，除非另有说明，否则属于公共领域。
感谢那些捐赠资金、服务或时间以保持项目运行的人们和公司。https://shields.io/community