从零开始写一套广告组件【三】编写README.md

简介: 现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 ` License` 文件,这一章我们就一起来看看如何写一个**README.md**

前言

现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 License 文件,这一章我们就一起来看看如何写一个README.md

内容

为了更好的写出好的一个 README.md,我们先看看优秀的开源项目都是怎么写的。

tdesign-vue-nexthttps://github.com/Tencent/tdesign-vue-next/blob/develop/README-zh_CN.md

Vuehttps://github.com/vuejs/core

elementhttps://github.com/ElemeFE/element

Rusthttps://github.com/rust-lang/rust

这里我们只列举三个项目,如果感兴趣的话,你可以查看更多优秀项目的 README.md 。好了,看过这三个项目后,我们大概知道一个项目的 README.md 需要包含哪些内容,接下来我们就来尝试写下自己项目的 README.md

语言

默认提供 英语中文README.md,这里我们也提供两个版本的 README.md,先将中文的写好,再进行翻译即可。

安装

基础的安装使用教程,这里我们还没开发完成,所以暂时留空即可。

开源协议

在最后的末尾来,描述下自己项目遵循的协议内容,License 我们可以在仓库创建的时候进行添加,如果前期没有添加的话,后续在 github 的仓库里去再添加也是可以的,直接添加LICENSE文件,然后选择对应的协议,确认好信息后,直接提交即可。

Logo

一个项目最起码要有个自己的脸面是不,不过是否需要一个Logo,可以根据自己的需求来定,毕竟现在生成Logod 的网站其实挺多的。

徽章

这里作为演示,我们就简单添加一些徽章,具体的各位可根据自身的喜好,到 shields 网站去生成,并添加到自己的项目中。

shieldshttps://shields.io/

徽章作为一个项目的点缀,这个必须拿下,接下来我们说下如何配置徽章。

GitHub Release

GitHub Releasehttps://shields.io/badges/git-hub-release

只需要输入 userrepo 即可得到一个版本的徽章,不过如果当前的仓库没有版本信息或者没有找到仓库地址,则会生成失败。

GitHub Release

node-current

node-currenthttps://shields.io/badges/node-current

只需要输入 packageName ,即可获取到软件包是否支持最新版本 node 的徽章,比如我们要获取 vite 对应的徽章,只需要在 packageName 输入 vite 即可。

Node Current

Github License

Github Licensehttps://shields.io/badges/git-hub-license

只需要输入 userrepo ,即可获得当前仓库下的许可证信息。

GitHub License

效果

中文:https://github.com/oyo-cool/eaui/blob/main/README-zh_CN.md

英文(默认):https://github.com/oyo-cool/eaui/blob/main/README.md

总结

这一章最主要的其实就是徽章的生成,毕竟以大家的聪明才智,写个 README.md 肯定是手到擒来。

目录
相关文章
|
4月前
|
JavaScript 前端开发 测试技术
移动端(APP)自动化脚本工具详细列举(autojs、easyclick、hamibot、ctrljs ...)
移动端(APP)自动化脚本工具详细列举(autojs、easyclick、hamibot、ctrljs ...)
1732 0
|
安全 API CDN
搭建Vue3组件库:第十五章 如何编写README文档
本章介绍如何正确编写项目的README文档
687 0
搭建Vue3组件库:第十五章 如何编写README文档
|
1月前
|
存储
好看又规范的Github Readme 制作指南
本文是关于制作规范且外观吸引人的GitHub README文件的指南,包括了README的基本结构、美化技巧,以及如何使用Markdown格式、徽标和图片来增强文档的可读性和吸引力。
118 0
|
2月前
VuePress 开发技术文档网站,管理.md文件,生成静态网站
VuePress 开发技术文档网站,管理.md文件,生成静态网站
73 0
|
2月前
|
JavaScript 区块链
从零开始:如何用Electron将chatgpt-plus.top 打包成EXE文件
从零开始:如何用Electron将chatgpt-plus.top 打包成EXE文件
26 0
|
4月前
|
小程序 JavaScript Java
基于微信小程序的学习资料库小程序的设计与实现(源码+lw+部署文档+讲解等)
基于微信小程序的学习资料库小程序的设计与实现(源码+lw+部署文档+讲解等)
|
4月前
|
Rust JavaScript 安全
🚀JS使用Wasm为你的文件MD5计算装上火箭引擎🚀
🚀JS使用Wasm为你的文件MD5计算装上火箭引擎🚀
|
4月前
|
数据可视化 算法 API
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
2080 0
|
4月前
|
JavaScript 前端开发 开发者
JS逆向 -- 开发者工具介绍
JS逆向 -- 开发者工具介绍
51 0
github:代码修改合并工作流程笔记
github:代码修改合并工作流程笔记
108 0