前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >【github】论怎么去写一个高大上的ReadMe

【github】论怎么去写一个高大上的ReadMe

作者头像
啦啦啦321
发布2019-09-29 14:34:28
9220
发布2019-09-29 14:34:28
举报

前言

以前我时常觉得,自己写的ReadMe很单调乏味,但后来仔细研究一下后,发现有很多方式可以让ReadMe在简洁的基础上变得好看些,所以在这里和大家分享,如果大家有更好的想法,也非常欢迎在评论区留言哦

美化方案

  • 加彩色徽章:介绍npm版本,证书类型,发布版本等
  • 给代码添加颜色,不要使用纯文本啦!
  • 给自己的代码库设计一个专属的logo
  • 有想到再加其他的

最终结果

Github地址

https://github.com/penghuwan/water.js​github.com

Act1. 加彩色徽章

大家可能会感到奇怪,下面这些彩色徽章哪里来的呢?

其实它们都来自这一个网站:https://shields.io/

打开网站,往下翻,可以看到几个输入框,如下所示

比如我们想要生成license MIT这样的徽章,就分别在label和message上填写,同时选择颜色,最后点击Make Badge

点击Make Badge后会跳转到一个打开的图标文件,这个地址就是图片的引用地址

然后我们只要把这个地址复制到ReadMe上写成图片就好了,比如

代码语言:javascript
复制
![](https://img.shields.io/badge/license-MIT-blue)

看到的结果

Act2. 加代码颜色

我们知道,我们可以用下面的Markdown标记添加代码块

代码语言:javascript
复制
``` 代码 ```

但如果仅仅这样,代码是没有颜色的,就像这样

如果我想加上颜色,我可以这么做: 给```后面加上语言名简写,比如:js

代码语言:javascript
复制
```js 
代码 
```

然后代码就被赋予颜色了呀(灵魂)

同理,python的代码颜色可以这样设置

代码语言:javascript
复制
```python 
#!/usr/bin/python3 
print("Hello, World!"); 
```

其他语言也是一样的,大家自己替换上去就好了

Act3. 给自己的代码库设计一个logo

设计logo的网站很多,一查就有,随便你用哪个,但是我用过的设计最好,体验最好的还是下面这个Canva

https://www.canva.cn/design/DADk291IBFw/xK_s33mJsndiCPk03TYleQ/edit

可以给自己设计图标,名称和介绍,这下面是我的使用过程

效果如下

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2019-09-09 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 美化方案
  • 最终结果
  • Github地址
  • Act1. 加彩色徽章
  • Act2. 加代码颜色
  • Act3. 给自己的代码库设计一个logo
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档