前言
平时大家在在逛 github
时或多或少都看到过项目首页各式各样的小徽章,不知道你是否和我一样好奇这些小徽章都是哪来的呢?
首先我们先来一睹为快目前前端开发的三大主流框架: var
,看一看他们的 github
项目首页有哪些小徽章吧!
Angular
: https://github.com/angular/angular
小结:
前端三大框架的徽章均不相同,由此可见,这应该不是 github
统一分发而是自定义行为!
虽然不是统一分配的,但也不是毫无规律可寻,想要制作专属的小徽章,其实真的很简单!
什么是徽章
徽章是一种小巧精美的小图标,一般配有相关文字进行辅助说明,富有表现力.
不仅出现于 github
项目主页,凡是能够表现图片的地方都可以出现徽章,本质上是一种 svg
格式的矢量图标.
下面以自定义 github-snowdreams1006-brightgreen.svg
徽章为例,简单认识一下徽章.
- 在线链接
https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png
- 浏览器效果
打开在线链接,并检查当前网页,豁然开朗,徽章是一种
svg
实现的矢量图标.
svg
VSpng
如果说
svg
是矢量图形而png
却不是,所以不妨将png
姑且称之为标量图形.
svg
是矢量图形,png
是标量图形,两者均能实现类似效果,只不过矢量图形不论怎么方法都能保持原样,并不会像 png
那样会失真而已.
既然两种均能表现相同的效果,现在我们就来演示一下 png
的实现效果.
svg
转png
在线网站: https://cloudconvert.com/svg-to-svg
左侧的
svg
无论放大多少倍,依然保持原样,清晰度保持不变.右侧的png
一旦放大,立马变得模糊不清.
如何使用徽章
大多数徽章都是 svg
格式,当然也不排除某些徽章是 png
格式,不论怎么说,一律当成图标使用就可以了.
如果你和我一样,希望在 markdown
文件中使用徽章,那么建议使用在线链接,或者引入本地 svg
相关文件.
徽章格式 :
[![图片文字说明](图片源地址)](超链接地址)
即超链接内部嵌套图片
[![github](https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png)](https://github.com/snowdreams1006)
如果你是在 html
文件使用徽章,同样先取得在线徽章地址,然后按照 html
语法插入图片即可.
徽章格式 :
<a href="超链接地址"><img src="图片源地址" alt="图片文字说明"></a>
即超链接内部嵌套图片
<a href="https://github.com/snowdreams1006">
<img src="https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png" alt="github">
</a>
![github](https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png)
不论是什么语法,最核心最根本的获得到徽章链接,至于不同语言有着各自的语法,按照语言规则手动拼接就好.
Badge URL
https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png
Markdown
[![github](https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png)](https://github.com/snowdreams1006)
HTML
<a href="https://github.com/snowdreams1006"><img src="https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png" alt="github"></a>
Textile
!https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png!:https://github.com/snowdreams1006
RDOC
{<img src="https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png" alt="github" />}[https://github.com/snowdreams1006]
AsciiDoc
image:https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png["github", link="https://github.com/snowdreams1006"]
RST
.. image:: https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png
:target: https://github.com/snowdreams1006
徽章分类
如果以徽章的格式为标准,那么可以分为svg
和 png
两类.
svg
https://i-blog.csdnimg.cn/blog_migrate/902cf9f700852b0ec558c0ed6ae66416.png
png
https://i-blog.csdnimg.cn/blog_migrate/48cda270a0c59317ebba97a6453c4510.png
如果以徽章的样式为标准,那么可以分为默认样式和自定义样式两类.
- 默认样式
https://i-blog.csdnimg.cn/blog_migrate/740e2b63787c73a92bae91489e468ef1.png
- 自定义样式
https://i-blog.csdnimg.cn/blog_migrate/c81fef1fb5fcb0bbae6c5e8fb9756e11.png
如果以徽章的内容数据是否动态为标准,那么可以分为静态数据和动态数据两类.
静态数据意味着数据本身是不变的,只要在线链接不变,那么生成的徽章永远不会改变,而动态数据意味着生成徽章的数据是动态变化的,即使在线链接不变,当数据本身发现变化时,徽章自然随之更新.
- 静态数据
https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png
- 动态数据
https://i-blog.csdnimg.cn/blog_migrate/902cf9f700852b0ec558c0ed6ae66416.png
静态数据示例中
github-snowdreams1006-brightgreen.svg
数据不会更改,自然生成的徽章也不会变.动态数据示例中gitbook-plugin-mygitalk.svg
是npm
的版本号,当项目升级后,版本号会发生更改,那么生成的徽章也会随之更新.
如果以徽章的内容数据来源为标准,那么可以有无数多的分类.
GitHub
https://i-blog.csdnimg.cn/blog_migrate/d9863e86705362bcff154378758e6d35.png
Npm
https://i-blog.csdnimg.cn/blog_migrate/76a0788f7584bbd39e6ead9132f16e0a.png
Docker
https://i-blog.csdnimg.cn/blog_migrate/11bdc672a608cb030d73e1f8a590b748.png
如果以徽章的内容数据用途为标准,那么也可以有无数多的分类.
- 构建状态
https://img.shields.io/travis/GitbookIO/gitbook.svg
- 代码覆盖率
https://i-blog.csdnimg.cn/blog_migrate/c7bc087ac5c50b3f07954e4466583c7a.png
- 代码分析
https://i-blog.csdnimg.cn/blog_migrate/1862914c81c25c4261245e20a40d16b8.png
徽章来源
徽章有不同的分类,不管是哪种分类,在线徽章最为简单便捷,下面就简单介绍下提供在线生成徽章的网站.
- https://shields.io/
- https://badgen.net/
- https://forthebadge.com/
- https://badge.fury.io/
- https://github.com/boennemann/badges
https://shields.io/
适用于绝大多数情况,默认按照徽章内容分类,
Build
,Code Coverage
,Analysis
等多主题,同时支持自定义徽章和动态徽章.
如果徽章的主题明确,那么根据网站提供的主题对号入座即可在线生成徽章,下面以 gitbook-plugin-mygitalk
为例,简要说明如何获得相应徽章链接.
gitbook-plugin-mygitalk 是
gitbook
的一款评论插件.
打开网站后按照分类,选择其中一个主题,点击进去后填写目标信息,即可在线生成徽章.
- 浏览已支持的主体,选择
License
许可证主题.
- 浏览已支持的
License
许可证列表,选择NPM
许可证.
- 填写好正确的
npm
包信息并实时预览,然后点击按钮复制徽章链接或者或者特定格式的徽章.
![NPM](https://i-blog.csdnimg.cn/blog_migrate/cd5ffefeb7d6a4b6b0f3aed2b8c39675.png)
按照主题生成徽章真的很简单,首先对号入座,然后按需生成相应徽章即可,唯一的要求就是对号入座!
如果默认提供的徽章主题没有适合自己的徽章,或者想要自定义徽章效果,那么也可以在线制作私人订制徽章.
- 打开网站后往下拉,找到
Your Badge
区域,准备制作专属徽章.
- 填写(
Label
)标签-(Message
)信息-(Color
)颜色等信息后,点击(Make Badge
)生成徽章.
- 点击生成徽章后默认会在当前标签页面打开该链接,手动复制链接并调整成目标格式即可.
![微信公众号-雪之梦技术驿站-brightgreen.svg](https://i-blog.csdnimg.cn/blog_migrate/c81fef1fb5fcb0bbae6c5e8fb9756e11.png)
https://badgen.net/
徽章内容来源种类较多,默认按照平台分类,按照特定规则生成徽章,需要手动拼接在线链接,略显繁琐.
https://badgen.net/badge/:subject/:status/:color?icon=github
──┬── ───┬─── ──┬─── ──┬── ────┬──────
│ │ │ │ └─ Extra Options (label, list, icon, color)
│ │ │ │
│ TEXT TEXT RGB / COLOR_NAME ( optional )
│
"badge" - default (static) badge generator
虽然支持颜色,图标以及查询参数等高级用法,但是还是习惯性采用默认设置,下面动手开始制作徽章吧!
- 切换到默认动态徽章选项卡,选择
GitHUb
徽章.
- 选择
stars
徽章,将micromatch
替换成目标信息.
/github/stars/micromatch/micromatch
替换成 /stars/snowdreams1006/snowdreams1006.github.io
- 预览徽章效果并手动修改成目标格式.
![snowdreams1006.github.io](https://i-blog.csdnimg.cn/blog_migrate/543a0c122680a747337f7cc40c310ccf.png)
除了支持动态徽章,同样也支持静态徽章,切换到 STATIC BADGES
选项卡,一起来生成静态徽章吧!
![★★★★☆](https://i-blog.csdnimg.cn/blog_migrate/4ec7c503b7e0dbe9b7c76f3d392cf2c5.png)
按照徽章的在线链接规则,应该也支持自定义徽章,再次回顾一下链接规则:
规则 :
https://badgen.net/badge/:subject/:status/:color
,如果是自定义动态链接,估计不支持吧!
![微信公众号-雪之梦技术驿站](https://i-blog.csdnimg.cn/blog_migrate/803b6e6cf0aec45a7251314720d9ab16.png)
https://forthebadge.com/
扁平化的徽章,支持的徽章数量有限,不支持自定义徽章.
网站首页默认提供了一些预览徽章,左侧是复制 image
链接,右侧是复制 markdown
链接.
[![forthebadge](https://i-blog.csdnimg.cn/blog_migrate/ec7ae5ab49cde364a27d4526449ff962.png)](https://forthebadge.com)
网站首页默认展示的徽章毕竟有限,如果找不到理想徽章,岂不是白介绍了这个网站,当然不能够!
VIEW ALL
查看目前支持的全部徽章,如果还是找不到徽章,那就真的没有.
https://badge.fury.io/
版本徽章,支持各类平台版本,包括
npm
,Ruby
,Python
,Go
等平台.
选择目标平台并输入包管理信息,即可在线生成各个类型的徽章版本.
[![npm version](https://i-blog.csdnimg.cn/blog_migrate/902cf9f700852b0ec558c0ed6ae66416.png)](https://badge.fury.io/js/gitbook-plugin-mygitalk)
排版布局
默认 markdown
实现的图片是依次排开的,无法自定义样式,而 markdown
语法同时也兼容 html
语法,因此我们可以用 html
语法实现居中对齐.
<p align="center">
<a href="https://circleci.com/gh/vuejs/vue/tree/dev">
<img src="https://i-blog.csdnimg.cn/blog_migrate/5d77174878e0e780cf0294ffcefbeeb3.png" alt="Build Status">
</a>
<a href="https://codecov.io/github/vuejs/vue?branch=dev">
<img src="https://i-blog.csdnimg.cn/blog_migrate/3dc0115e454979b0a31d49f6cdd098bb.png" alt="Coverage Status">
</a>
<a href="https://www.npmjs.com/package/vue">
<img src="https://i-blog.csdnimg.cn/blog_migrate/0ef5838bd8bd275666fcfea0273e5289.png" alt="Downloads">
</a>
<a href="https://www.npmjs.com/package/vue">
<img src="https://i-blog.csdnimg.cn/blog_migrate/318d7bc84b26aae89b59de49154ca0dd.png" alt="License">
</a>
<a href="https://chat.vuejs.org/">
<img src="https://i-blog.csdnimg.cn/blog_migrate/5ce007414a973e42766c3ff07ac89ca7.png" alt="License">
</a>
</p>
抛砖引玉
- 社交化徽章
![GitHub followers](https://i-blog.csdnimg.cn/blog_migrate/2b13f345f8363a78c3d1af2626cb56c6.png)
![GitHub forks](https://i-blog.csdnimg.cn/blog_migrate/b3f45e728a4fed4dda7041164e4ec656.png)
![GitHub stars](https://i-blog.csdnimg.cn/blog_migrate/740e2b63787c73a92bae91489e468ef1.png)
![GitHub watchers](https://i-blog.csdnimg.cn/blog_migrate/33ffa6e13e391208ac08d5457a9631a2.png)
- 自定义徽章
[![github](https://i-blog.csdnimg.cn/blog_migrate/a187bd516ca0feb2ea27e40dd18e9847.png)](https://github.com/snowdreams1006)
[![wechat](https://i-blog.csdnimg.cn/blog_migrate/c81fef1fb5fcb0bbae6c5e8fb9756e11.png)](http://weixin.qq.com/r/cy5CWvvE5Kabrb8593th)
[![慕课网](https://i-blog.csdnimg.cn/blog_migrate/a971c528277e7047ca74962eaf9b11a8.png)](https://www.imooc.com/u/5224488/articles)
[![简书](https://i-blog.csdnimg.cn/blog_migrate/d501da3a9d4148ab6a4769a53998d3a6.png)](https://www.jianshu.com/u/577b0d76ab87)
[![csdn](https://i-blog.csdnimg.cn/blog_migrate/4c174fab7331ec724b81a0fefac0a7e1.png)](https://blog.csdn.net/weixin_38171180)
[![博客园](https://i-blog.csdnimg.cn/blog_migrate/905333f86a752b9f5b24f1e68a86960a.png)](https://www.cnblogs.com/snowdreams1006/)
[![掘金](https://i-blog.csdnimg.cn/blog_migrate/9cc53aec5ebc3c8676f5d6c430489321.png)](https://juejin.im/user/582d5cb667f356006331e586)
[![思否](https://i-blog.csdnimg.cn/blog_migrate/28fa67ed6d4f1743f65e97ab25a904db.png)](https://segmentfault.com/u/snowdreams1006)
[![开源中国](https://i-blog.csdnimg.cn/blog_migrate/ca56e912b79da80760dbbee3ba11db0c.png)](https://my.oschina.net/snowdreams1006)
[![腾讯云社区](https://i-blog.csdnimg.cn/blog_migrate/573ebff028dd750d19a2581753b5c662.png)](https://cloud.tencent.com/developer/user/2952369/activities)
- 进度条徽章
[![progress](https://i-blog.csdnimg.cn/blog_migrate/0d190a025bb060a86187561101df2689.png)](https://github.com/fehmicansaglam/progressed.io)
[![progress](https://i-blog.csdnimg.cn/blog_migrate/22996081166f0d04302d3d4d2a166932.png)](https://github.com/fehmicansaglam/progressed.io)
[![completed](https://i-blog.csdnimg.cn/blog_migrate/0de87573f3039e9e59882e8bd1ad33eb.png)](https://github.com/fehmicansaglam/progressed.io)
[![done](https://i-blog.csdnimg.cn/blog_migrate/889e05d4aa7f2ed12a36c0d11617e93d.png)](https://github.com/fehmicansaglam/progressed.io)