从零开始写一套广告组件【三】编写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 肯定是手到擒来。

目录
相关文章
|
安全 API CDN
搭建Vue3组件库:第十五章 如何编写README文档
本章介绍如何正确编写项目的README文档
719 0
搭建Vue3组件库:第十五章 如何编写README文档
|
3月前
|
资源调度 搜索推荐 Shell
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
本文介绍了如何使用 Vue3、TypeScript 和 Vite 开发组件库并将其发布到 npm。文章详细描述了安装依赖、配置项目、创建文档网站以及编写组件文档的步骤。通过使用 VitePress,可以轻松搭建组件库的文档站点,并实现 Algolia 搜索功能。此外,还提供了自动化脚本用于部署静态网站至 GitHub 以及发布组件库到 npm。最后,展示了完整的目录结构和网站效果。
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
|
3月前
|
存储
好看又规范的Github Readme 制作指南
本文是关于制作规范且外观吸引人的GitHub README文件的指南,包括了README的基本结构、美化技巧,以及如何使用Markdown格式、徽标和图片来增强文档的可读性和吸引力。
355 0
|
4月前
|
前端开发
文本,paddocr的资料,base64转文字的相关源码,效果更好是点击button录了代码库
文本,paddocr的资料,base64转文字的相关源码,效果更好是点击button录了代码库
文本,paddocr的资料,base64转文字的相关源码,效果更好是点击button录了代码库
|
4月前
VuePress 开发技术文档网站,管理.md文件,生成静态网站
VuePress 开发技术文档网站,管理.md文件,生成静态网站
131 0
文本,Vitepress的优势之处,配合Typora进行页面撰写可以同步设计相同的HTML页面
文本,Vitepress的优势之处,配合Typora进行页面撰写可以同步设计相同的HTML页面
|
4月前
|
JavaScript
vue 加载展示md文件(markdown语法 .md后缀的文件)
vue 加载展示md文件(markdown语法 .md后缀的文件)
770 0
|
5月前
|
图形学
【unity实战】如何更加规范的创建各种Rogue-Lite(肉鸽)风格的物品和BUFF效果(附项目源码)
【unity实战】如何更加规范的创建各种Rogue-Lite(肉鸽)风格的物品和BUFF效果(附项目源码)
81 0
|
6月前
|
数据可视化 算法 API
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
2968 0
|
6月前
|
JavaScript 前端开发 开发者
JS逆向 -- 开发者工具介绍
JS逆向 -- 开发者工具介绍
63 0