README 标签生成器(Shields.io 风格)
指导
README 徽章生成器
README 徽章生成器在您的浏览器中直接构建像素精确的 Shields.io 风格徽章。选择预设或自定义标签和消息,选择颜色和样式(扁平、扁平方形、用于徽章或塑料质感),并获得可直接使用的 Markdown、HTML、SVG 和数据 URL 输出。无需外部 API 调用,无需网络依赖,即使服务中断也不会出现损坏的徽章——SVG 在客户端生成并内嵌。
如何使用
- 从模板下拉菜单中选择一个预设,或保持为“自定义”并填写您自己的标签和消息。
- 选择标签颜色和消息颜色——Shields.io 的预设颜色或自定义十六进制颜色。
- 选择徽章样式:扁平、扁平方形、用于徽章或塑料质感。
- 在浅色和深色背景之间实时预览更新。
- 复制 Markdown、HTML、URL 或原始 SVG —— 或下载 SVG 文件。
特征
- 四种徽章样式 – 扁平、扁平方形、用于徽章(大写、更高)和带有渐变阴影的塑料质感。
- 包含的预设 – 版本、许可证、构建状态、覆盖率、下载量、点赞数以及“用心打造”模板。
- 实时预览 – 支持即时渲染,并通过浅色/深色背景切换,让您看到徽章在不同 README 主题中的显示效果。
- 四种输出格式 – Markdown、HTML 图像标签、SVG 数据 URL 和原始 SVG 代码。
- 自包含的 SVG – 文本以真实的 SVG 文本节点形式渲染,具有测量宽度、阴影和适当的圆角。
- 自定义颜色 – 标准的 Shields.io 配色方案加上自由选择的十六进制颜色选择器。
- 100% 客户端 – 无需 API 调用,无跟踪,无速率限制。页面加载后即可离线使用。
- 一键复制和 SVG 下载 – 导出一个独立的 .svg 文件,可直接放入任何仓库。
常见用例
- 开源 README – 一目了然地显示构建状态、版本、许可证、覆盖率或下载量。
- 项目仪表板 – 在内部维基和文档网站中嵌入一致的状态徽章。
- 作品集网站 – 无需加载外部图像服务,即可用风格化的标签装饰项目卡片。
- 营销页面 – 使用“用心打造”和自定义徽章作为轻量级的装饰图形。
- 离线文档 – 发布即使在防火墙阻止 shields.io 的情况下也能正常渲染的徽章。
为何本地生成徽章
远程徽章服务虽然方便,但每次加载 README 时都会增加一次网络请求。当这些服务变慢、被限速或更改默认设置时,您的徽章会无声地失效。本地生成的 SVG 是一个静态文件——它在任何支持 Markdown 或 HTML 的地方都能正常渲染,随项目一起打包,且在服务中断时依然可用。它还让您完全掌控颜色、间距和字体粗细,使徽章在整个组织内保持一致的视觉风格。
常问问题
-
什么是 SVG 徽章?
SVG 徽章是一种小型矢量图像,以胶囊形状显示标签和消息。由于是矢量图像,它在任何尺寸下都保持清晰,并可使用实色、渐变和抗锯齿文本进行样式化,无需服务器端渲染。
-
扁平与用于徽章样式有何区别?
扁平是默认的紧凑样式,带有从上到下的轻微阴影和圆角。用于徽章则更高,使用粗体大写字母,并增加额外的横向间距,使其更显眼且从远处更易阅读。
-
SVG 徽章的宽度是如何计算的?
每个文本部分都通过字体度量计算得出——通常为 Verdana 11 字体中每个字符的宽度——然后在两侧添加边距。标签和消息的宽度相加得出总 SVG 宽度,以确保背景矩形精确对齐文本。
-
为何使用数据 URL 而非托管图像?
数据 URL 将整个 SVG 内嵌在 Markdown 或 HTML 中,消除了对外部托管的依赖。徽章立即渲染,无需额外请求,不会因服务更改 API 而失效,并且在离线状态下依然可见。
