如何在npm官网上发表自己的包

官网传送门

首先给大家推荐一个小工具i5ting_toc

i5ting_toc

i5ting_toc 是一个可以把 md 文档转为 html 页面的小工具,使用步骤如下:

相对路径的图片

规范的包结构

一个规范的包,它的组成结构,必须符合以下 3 点要求:

  1. 包必须以单独的目录而存在。
  2. 包的顶级目录下要必须包含 package.json 这个包管理配置文件
  3. package.json 中必须包含 name,version,main 这三个属性,分别代表包的名字、版本号、包的入口。

注意:

  1. 以上 3 点要求是一个规范的包结构必须遵守的格式,关于更多的约束,可以参考如下网址:包规范文档

  2. 在开发包的时候要最好按照要求开发,否则你写的包其他程序猿是很难去理解和应用的。

在了解这些后,你就可以开始开发自己的包了!开发过程结束后就需要写说明文档了。

编写包的说明文档

  1. 包根目录中的 README.md 文件,是包的使用说明文档。通过它,我们可以事先把包的使用说明,以 markdown 的格式写出来,方便用户参考。
  2. README 文件中具体写什么内容,没有强制性的要求;只要能够清晰地把包的作用、用法、注意事项等描述清楚即可。我们所创建的这个包的 README.md 文档中,会包含以下 6 项内容:
  3. 安装方式、导入方式、格式化时间、转义 HTML 中的特殊字符、还原 HTML 中的特殊字符、开源协议

发布包

  1. 注册 npm 账号
  2. 登录 npm 账号

npm 账号注册完成后,可以在终端中执行 npm login 命令,依次输入用户名、密码、邮箱后,即可登录成功。

注意:

在运行 npm login 命令之前,必须先把下包的服务器地址切换为 npm 的官方服务器。否则会导致发布包失败!

  1. 把包发布到 npm 上
    将终端切换到包的根目录之后,运行 npm publish 命令,即可将包发布到 npm 上(注意:包名不能雷同)。
  2. 删除已发布的包

运行 npm unpublish 包名 --force 命令,即可从 npm 删除已发布的包。

注意:

  1. npm unpublish 命令只能删除 72 小时以内发布的包
  2. npm unpublish 删除的包,在 24 小时内不允许重复发布
  3. 发布包的时候要慎重,尽量不要往 npm 上发布没有意义的包!

猜你喜欢

转载自blog.csdn.net/liyuchenii/article/details/125697051