文章目录

  • 导读
  • 徽章图片
  • Emoji
  • 数据统计
  • 贪吃蛇

导读

README.md作为Markdown文件,GitHub支持了Markdown的基本语法,但不支持CSDN提供的强大的公式编辑$$功能以及标题功能等。

看到别人的GitHub同名项目里README.md丰富多彩,你是否羡慕呢?本文给读者分享几种常见的装饰README.md的小技巧,遇到新鲜的玩法会持续更新。

徽章图片

Shields IO有丰富的图片资源可以用在GitHub用户的README.md中,Shields项目也已开源。

该项目以SVG和raster格式提供简洁、一致和易读的徽章的服务,可以轻松地包含在GitHub的README.md文件或任何其他网页中。 该服务支持数十种持续集成服务、包注册表、分发、应用商店、社交网络、代码覆盖服务和代码分析服务。每个月它提供超过7.7亿张图片,并被一些世界上最受欢迎的开源项目使用,如 VS Code、Vue.js 和 Bootstrap 等等。

比如:

Emoji

有很多可以提供Emoji图片的网站,试推荐一个:emojipedia。

数据统计

github-readme-stats是一款非常有趣的GitHub数据统计可视化工具,也提供了中文文档,可以在GitHub用户的README.md里呈现出如下效果:

数据统计卡片有很多样式,还支持渐变色:

支持自定义repo卡片:

支持热门语言统计:

贪吃蛇

逛GitHub的时候发现了一个有趣的README.md内容,就是snack,容笔者称其为“贪吃蛇”。

比如下图为某GitHub用户的contributions统计:

通过一系列的操作,呈现在README.md上的是一个SVG格式的贪吃蛇动图:

操作方法如下:


将以下yml内容填入以后点击“Start Commit”,注意填写用户名:

name: Generate Datason:schedule:- cron: "* */12 * * *"workflow_dispatch:jobs:build:name: Jobs to update datasruns-on: ubuntu-lateststeps:# Snake Animation- uses: Platane/snk@masterid: snake-gifwith:github_user_name: 你的用户名svg_out_path: dist/github-contribution-grid-snake.svg- uses: crazy-max/ghaction-github-pages@v2.1.3with:target_branch: outputbuild_dir: distenv:GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

通过以上方法生成了SVG文件,README.md引入方法就是:
![Snake animation](https://github.com/你的用户名/你的用户名/blob/output/github-contribution-grid-snake.svg)

两个“你的用户名”都是为了凑URL,第一个是你的用户名必须要有,第二个是你的repo一般是同名repo,所以需要填这个。

【Git】GitHub同名项目实现丰富多彩的README.md相关推荐

  1. springboot 建readme_经验分享:给项目创建和编写README.md文件的步骤

    在项目开发过程中,不仅要注意代码的编写质量,也要为合作开发打好基础,尤其是合作开发的时候,同事直接的代码需要熟悉,这就需要在开发的时候进行注释操作,方便别人维护和熟悉代码.除了上述两个重要的点之外,还 ...

  2. ideagit更新一个文件_IDEA 配置 Git,GitHub, 获取项目, 更新项目 (Windows 版本)

    在本地配置 Git 首先呢在本地配置好 Git 客户端,我用的是 windows 系统,直接下载安装板下载就 OK, 然后配置 Git,告诉 Git 需要连接的名字与邮箱,名字随意,邮箱要与 GitH ...

  3. 个人项目github链接及README.md

    链接:   https://github.com/Silvia9/Word-Count README:   https://github.com/Silvia9/Word-Count/blob/mas ...

  4. git github 快速入门

    本节内容 github介绍 安装 仓库创建& 提交代码 代码回滚 工作区和暂存区 撤销修改 删除操作 远程仓库 分支管理 多人协作 github使用 忽略特殊文件.gitignore 为什么要 ...

  5. git/github的使用

    内容最后更新时间:2018-08-10 以下内容是我在收集而来,再经过自己的经验修改而成,希望对你有用(在不断的更新中) 欢迎来到Github 初识Github 版本控制的介绍 熟练使用Git/Git ...

  6. git学习创建项目仓库

    登录git 这是git首页,已有帐号,点右上角sign in 进入登录页 输入帐号密码 登录之后的页面 Browse activity -- 浏览活动 就项目的一些更新信息 Discover repo ...

  7. 【Git】PyCharm项目关联Git的解决方案

    核心操作和<IntelliJ_IDEA项目关联Git的解决方案>是一致的,毕竟都是JetBrains家的产品. 这次简明扼要地总结一下步骤(默认你已经能做到本地Git和Github关联): ...

  8. git github 快速入门

    本节内容 github介绍 安装 仓库创建& 提交代码 代码回滚 工作区和暂存区 撤销修改 删除操作 远程仓库 分支管理 多人协作 github使用 忽略特殊文件.gitignore 为什么要 ...

  9. git/github的使用(入门到中阶)

    内容最后更新时间:2017-08-10 以下内容是我在收集而来,再经过自己的经验修改而成,希望对你有用(在不断的更新中) 博客地址 欢迎来到Github 初识Github 版本控制的介绍 熟练使用Gi ...

最新文章

  1. C语言过时了吗?不,我们需要的是一份个人成长
  2. 命令行请求网站地址带token_利用gitlab或gitee作为网站免费图床的C#实现
  3. Android版数据结构与算法(五):LinkedHashMap核心源码彻底分析
  4. python输出由1234组成的三位素数_编写程序,输出所有由 1 、 2 、 3 、 4 这 4 个数字组成的素数,并且在每个素数中每个数字只使用依次。_学小易找答案...
  5. MySQL截取字符串的方法-substring_index
  6. linux桌面下安装pptp,Linux下安装PPTP客户端
  7. 罗永浩将举办「老人与海」发布会;微软疑似遭遇大范围全球宕机;Python 3.9 首个测试版发布 | 极客头条...
  8. 【世界精品宝珀腕表win7主题】
  9. canvas基础学习笔记
  10. 快闪视频快影_快闪的12个步骤!
  11. 平板触屏笔什么比较好?实用平板电脑手写电容笔推荐
  12. 无线局域网WLAN的入门概念
  13. Cadence软件license相关问题
  14. Python 遗传算法实现字符串
  15. GYM 101173 K.Key Knocking(构造)
  16. CoreXY运动结构工作原理
  17. 如何给PPT加上页码?
  18. 微型计算机的i3或i5一般指的是,英特尔i3、i5、i7分别相当于骁龙哪个层次的处理器?...
  19. 检索 国家自然科学基金
  20. MacBook安装Golang Oracle数据库驱动程序

热门文章

  1. 求1到100的数字累加和(python)
  2. Shadow Defender 语言文件并注册
  3. 【算法基础笔记】常用的排序算法的时间、空间复杂度,部分排序算法原理
  4. sql 同一字段合并
  5. FABRIC单机开发者模式启动
  6. 处理sharepoint 列表中的 person or group类型字段
  7. iframe异步加载技术及性能
  8. zoj1738 Lagrange's Four-Square Theorem(DP)
  9. Git Bash中npm配置,加速下载等作用
  10. PHP常量:define和const的不同之处