github 的 READEME.md 自动生成和手动编辑两种方法介绍
先看下要做什么吧
- 打开https://github.com/cxvh会看到
cxvh
仓库的README.md
文件 - 接下来从两方面介绍如何去编辑
- 首选懒人快速生成的方法,简单,快捷
- 自定义编辑、构建
懒人快速生成
- 打开生成网站
Title
是标题,有示例,参考编写即可Subtitle
小标题,可以做个简短的自我描述Work
项目名称+链接、在学习什么、关于、邮箱、所有的项目链接、你的博客地址、简历地址、你认为你很有趣~Skills
技能专长、选中你会的,会生成图标Social
社交、联系方式Add-ons
附加组件、会生成一些分析图标等Support
支持(没用过不太懂)
- 配置好后点击
Generate README
生成,复制到你的https://github.com/名称/仓库名和名称一样的仓库/README.md
,然后commit
就看到了
自定义编辑、构建
这里主要说下流程和需要注意的细节(以下通过开发工具为vscode
,使用github
仓库)
- 先从
wakatime
说起,它主要对项目进行分析,它通过你本地的开发工具打开的项目、链接对应git
仓库进行分析- 打开网站https://wakatime.com/,并注册登录。
- 安装开发工具插件https://wakatime.com/plugins,
vscode
打开项目后搜索插件安装,安装完成后弹出输入框WakaTime API Key
,粘贴Secret API Key
然后去刷新网站就能看到了(其他项目用vscode
打开后ctrl+shift+p
键入WakaTime API Key
回车粘贴Secret API Key
)- 打开https://wakatime.com/settings/account就能看到:
Secret API Key
- 打开https://wakatime.com/settings/account就能看到:
- 网站获取
github
仓库,打开https://wakatime.com/integrations,去关联授权 - 本地项目关联
github仓库
- 打开https://wakatime.com/share,点击第一个图表—>网站拉取到的
github仓库
,点击开关按钮—>弹出复选框去关联本地项目,点击Connect this repo.
—>出来的是本地项目列表,点击对应的项目—>点击Connect to GitHub
—>出来仓库下拉框,选中点Save
即可完成关联!
- 打开https://wakatime.com/share,点击第一个图表—>网站拉取到的
- 使用编码花费时间图标
Repo Badges
,打开https://wakatime.com/share/badges,点击项目绿色开关按钮右边的图标,复制代码去粘贴 - 使用实时图表,显示语言,编辑器或总编码活动
Embeddable Charts
,打开https://wakatime.com/share/embed,配置好后点Get Embeddable Code
生成出弹出引用代码(新项目过了晚上12点以后可能才会有数据)
1 | ### :gem: 投入网站时间: |
- 使用
github
的actions
生成,扩展地址https://github.com/marketplace/actions/profile-readme-development-stats- 配置
github
仓库环境变量,token
和Secret API Key
- 项目中配置
yml
,.github/workflows/waka-coding-stats-workflows.yml
,并commit
、push
- 打开https://github.com/cxvh/cxvh/actions,点
Run workflow
即可构建,会替换掉README.md
中的这个注释:<!--START_SECTION:waka--><!--END_SECTION:waka-->
(两个注释中间敲个回车吧,和文档保持一致没错)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19# waka-coding-stats-workflows.yml
name: Waka Readme
on:
schedule:
# Runs at 12am IST
- cron: '30 18 * * *'
workflow_dispatch:
jobs:
update-readme:
name: Update Readme with Metrics
runs-on: ubuntu-latest
steps:
- uses: anmol098/waka-readme-stats@master
with:
# secrets.WAKATIME_API_KEY 的 WAKATIME_API_KEY 就是 Secret API Key 的变量名
WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
# secrets.GH_TOKEN 的 GH_TOKEN 就是 token 的变量名
GH_TOKEN: ${{ secrets.GH_TOKEN }}1
2
3
4
5# 这是生成的
🌞 Morning 5 commits ███░░░░░░░░░░░░░░░░░░░░░░ 12.82%
🌆 Daytime 7 commits ████░░░░░░░░░░░░░░░░░░░░░ 17.95%
🌃 Evening 7 commits ████░░░░░░░░░░░░░░░░░░░░░ 17.95%
🌙 Night 20 commits ████████████░░░░░░░░░░░░░ 51.28%
- 配置
许多都类似,下面给几个常用分析工具链接和图标生成网站
- https://metrics.lecoq.io/
- https://github.com/anuraghazra/github-readme-stats
- https://github.com/ryo-ma/github-profile-trophy
- https://shields.io/这个很不错!!!
还不会的话看视频
开头中间结尾有广告
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 BARAN的小站🎈!