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

目录
相关文章
|
6月前
|
人工智能 测试技术 API
PaperBench:OpenAI开源AI智能体评测基准,8316节点精准考核复现能力
PaperBench是OpenAI推出的开源评测框架,通过8316个评分节点系统评估AI智能体复现学术论文的能力,涵盖理论理解、代码实现到实验执行全流程。
385 30
PaperBench:OpenAI开源AI智能体评测基准,8316节点精准考核复现能力
|
SQL Oracle 关系型数据库
|
12月前
|
Java 测试技术 开发者
初学者入门:掌握单元测试的基础与实践
【10月更文挑战第14天】单元测试是一种软件测试方法,它验证软件中的最小可测试单元——通常是单独的函数或类——是否按预期工作。单元测试的目标是确保每个模块在其自身范围内正确无误地运行。这些测试应该独立于其他模块,并且应该能够反复执行而不受外部环境的影响。
302 2
|
安全 物联网
物联网卡锁卡是一个常见的问题,处理这类问题时,可以根据锁卡的具体原因采取相应的解决措施。以下是一些常见的物联网卡锁卡原因及其处理方法
物联网卡在使用的话过程中出现锁卡问题原因以及处理办法: 如锁卡,由于更换设备、长期未使用或者风险地区使用等原因触发的停机或管控,应及时与购卡公司或运营商联系处理。
|
数据可视化 算法 API
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
【README.md 指南 】如何编写 README.md:打造出色的开源项目文档
5252 0
|
12月前
|
前端开发 JavaScript API
前端的全栈之路Meteor篇(完):关于前后端分离及与各框架的对比,浅析分离之下的潜在耦合
本文探讨了Meteor.js这一全栈JavaScript框架的特点与优势,特别是在前后端分离架构中的应用。Meteor通过共享数据结构和简化全栈开发流程,实现了前后端的紧密协作。文章还对比了其他全栈框架,如Next.js、Nuxt.js等,分析了各自的优势与适用场景,最后讨论了通过定义文档归属者和用户专有数据集简化后端构建及端云数据同步的方法。
813 0
|
11月前
|
JavaScript 前端开发 API
探索组合式API的革新与优势
探索组合式API的革新与优势
160 1
|
NoSQL Linux
Linux系统调试中出现核心转储(core dump)的问题
Linux系统调试中出现核心转储(core dump)的问题
2830 0
|
机器学习/深度学习 算法 搜索推荐
Elasticsearch:崭新的打分机制 - Learning To Rank (LTR)
【6月更文挑战第8天】Elasticsearch 的 Learning To Rank (LTR) 打分机制通过机器学习改进搜索结果排序,以适应复杂需求和用户行为。传统打分基于词频等,而 LTR 利用训练数据学习更合理的排序,考虑文本、用户行为等特征。示例代码展示了如何在 Elasticsearch 中运用 LTR。尽管实施 LTR 需要高质量训练数据和专业选择算法,但它能处理模糊搜索、多因素排序,提升搜索体验,增强应用价值和竞争力。随着技术发展,LTR 将在 Elasticsearch 中发挥更大作用。
348 6
|
数据可视化 搜索推荐 数据挖掘
Plotly:交互式数据
【7月更文挑战第13天】Plotly是Python的交互式可视化库,用于创建多种图表,如散点图、箱线图等。通过安装`pip install plotly`开始使用。基本的交互式图表演示了如何用学生成绩创建散点图,而自定义图表展示了如何增强视觉效果。Plotly还支持高级交互功能,如数据筛选、动态更新,以及实时数据追踪。未来,Plotly将扩展图表类型、增强交互性和性能,更好地集成云服务,并提供更多的教育资源和定制选项,以适应数据科学的快速发展。