shields

该仓库是 Shields.io 的所在地，Shields.io 是一项以 SVG 和位图格式提供简洁、一致且清晰易读的徽章的服务。README 说明徽章可以嵌入 GitHub 的 readme 或任何其他网页。它指出该服务支持数十种持续集成服务、包注册表、发行版、应用商店、社交网络、代码覆盖率服务和代码分析服务。它表示每个月提供超过 16 亿张图片，并被 VS Code、Vue.js 和 Bootstrap 等项目使用。该仓库托管 Shields.io 的前端和服务器代码、一个名为 badge-maker 的用于生成徽章的 NPM 库，以及徽章设计规范。列出的示例包括代码覆盖率百分比、稳定版版本号、包管理器发布版本、依赖状态、静态代码分析等级、SemVer 版本、每周 Liberapay 捐款、Python 包下载量、Chrome Web Store 扩展评分以及 Uptime Robot 的正常运行时间百分比。用户可以通过 URL 模式制作自定义徽章。README 描述了一个快速入门指南：用户浏览完整的徽章列表，搜索或浏览类别，点击徽章并填写所需数据（如用户名或仓库），可选地自定义标签和颜色，然后复制徽章 URL 或代码片段，用于 GitHub 的 readme 或其他网页。贡献是基于社区的，通过 issue 和 pull request 进行；README 要求贡献者在添加或更改服务时添加测试，并指向一个添加徽章的教程。它还引用了“good first issues”和安全政策。对于开发，README 列出了安装 Node 24、克隆仓库、运行 npm ci、npm start 并打开 localhost:3000 的步骤。服务器源代码更改会通过 nodemon 自动重启，而前端更改会通过 Docusaurus 开发服务器重新加载；徽章定义在首次服务器启动前构建，并可通过 npm run prestart 或重启重新生成。可以通过命令行使用 npm run badge 调试徽章，包括完整 URL。快照测试保护 SVG 或 JSON 输出；有意的输出更改可以通过 SNAPSHOT_DRY=1 npm run test:package 预览，并使用 SNAPSHOT_UPDATE=1 更新。服务器可选使用 Sentry 和 Prometheus。自托管文档已链接。相关项目包括 awesome-badges，一个精选集合。README 给出了历史：b.adge.me 是原始站点，使用 2013 年的 gh-badges 代码；该项目与 shields.io 合并。原始徽章规范于 2013 年制定，后来在 2014 年重新设计；旧设计称为塑料风格，新设计称为平面风格。维护者和校友已列出，项目采用 MIT 和 Apache 2.0 双重许可。它还链接到社区资助和支持。