如何在npm官网上发表自己的包
作者:互联网
首先给大家推荐一个小工具i5ting_toc
i5ting_toc
i5ting_toc 是一个可以把 md 文档转为 html 页面的小工具,使用步骤如下:
规范的包结构
一个规范的包,它的组成结构,必须符合以下 3 点要求:
- 包必须以单独的目录而存在。
- 包的顶级目录下要必须包含 package.json 这个包管理配置文件
- package.json 中必须包含 name,version,main 这三个属性,分别代表包的名字、版本号、包的入口。
注意:
以上 3 点要求是一个规范的包结构必须遵守的格式,关于更多的约束,可以参考如下网址:包规范文档
在开发包的时候要最好按照要求开发,否则你写的包其他程序猿是很难去理解和应用的。
在了解这些后,你就可以开始开发自己的包了!开发过程结束后就需要写说明文档了。
编写包的说明文档
- 包根目录中的
README.md
文件,是包的使用说明文档
。通过它,我们可以事先把包的使用说明,以 markdown 的格式写出来,方便用户参考。 - README 文件中具体写什么内容,没有强制性的要求;只要能够清晰地把包的作用、用法、注意事项等描述清楚即可。我们所创建的这个包的 README.md 文档中,会包含以下 6 项内容:
- 安装方式、导入方式、格式化时间、转义 HTML 中的特殊字符、还原 HTML 中的特殊字符、开源协议
发布包
- 注册 npm 账号
- 登录 npm 账号
npm 账号注册完成后,可以在终端中执行 npm login 命令,依次输入用户名、密码、邮箱后,即可登录成功。
注意:
在运行 npm login 命令之前,必须先把下包的服务器地址切换为 npm 的官方服务器。否则会导致发布包失败!
-
把包发布到 npm 上
将终端切换到包的根目录之后,运行 npm publish 命令,即可将包发布到 npm 上(注意:包名不能雷同)。 -
删除已发布的包
运行 npm unpublish 包名 --force 命令,即可从 npm 删除已发布的包。
注意:
- npm unpublish 命令只能删除 72 小时以内发布的包
- npm unpublish 删除的包,在 24 小时内不允许重复发布
- 发布包的时候要慎重,尽量不要往 npm 上发布没有意义的包!
标签:npm,i5ting,unpublish,发布,文档,README,发表,网上 来源: https://www.cnblogs.com/liyublogs/p/16461587.html