npm 包 @endemolshinegroup/cz-github 使用教程

简介

在前端工程师的日常开发中,我们经常需要提交代码到 GitHub,并且需要在提交代码的时候写一些良好的提交信息,如何提交规范的 commit message 是开发团队必须要解决的问题之一。为了解决这个问题,我们可以使用 Commitizen来规范我们的提交信息。

@endemolshinegroup/cz-github 是一个基于 Commitizen 的程序包,它可以使用 GitHub 的 API 来获取所有的 issue 和 PR 并自动生成提交信息,帮助我们规范化的编写提交信息。

在本文中,我将指导你如何使用 @endemolshinegroup/cz-github 来规范化的编写提交信息。

安装

我们可以使用下面的命令安装 @endemolshinegroup/cz-github

--- ------- ---------- ----------------------------

使用

在安装完成之后,我们可以在 package.json 文件中添加如下代码:

--------- -
  ------------- -
    ------- ---------------------------------------------
  -
--
---------- -
  --------- --------
--

同时,我们可以使用 npm run commit 命令来代替 git commit 的方式提交代码。此时,我们只需要按照下面的参数规范中的提示操作即可编写规范的提交信息。

参数规范

@endemolshinegroup/cz-github 提供了如下参数规范,使用这些规范可以帮助我们写出规范的提交信息。

类型

用于说明 commit 的类别,只允许使用下面的 7 个标识。

  • feat:新功能(feature)
  • fix:修补 bug
  • docs:文档(documentation)
  • style:格式(不影响代码运行的变动)
  • refactor:重构(即不是新增功能,也不是修改 bug 的代码变动)
  • test:增加测试
  • chore:构建过程或辅助工具的变动

主体

是 commit 的简短描述,不超过 50 个字符。

- --- ------ -- ------ ------

具体内容

详细描述 commit 的内容,可使用多行以更清晰地展现更改内容。

- --- ------ -- ------ ----------------

GitHub issues和PR

我们可以使用下面的格式来链接 GitHub issues 和 PR。

- --- ------ -- ------ -------------- ----- ----- ---

在这个例子中,我们使用 "Closes" 关键字来关闭对应的 issues 和 PR,也可以使用 "Fixes" 和 "Resolves" 关键字。

示例代码

最后,让我们来看一下使用 @endemolshinegroup/cz-github 的示例代码。

--
 - ------------- -- ---------------------------- ----------
 - -------- ---
 - ------ ---------- --------
 - ------------- ---
 - -------------- ---------- --------
 --

---
 - --- ----
 - ------ ------- --- ------
 - -------- ------
 --
-------- ----------- -
  ----- --- - --- --------
  ------ --------
-

---
 - --- ----
 - ------ ------- --- ------
 - -------- ------
 --
-------- --------- -
  ------------ -- -- - - --
  ------ ---
-

- --- --- -
- --- --- ------

在上面的示例代码中,我们编写了一个名为 unique 的函数,它用于对数组进行去重;同时编写了一个名为sort 的函数用于对数组进行排序。在代码提交之前,我们使用了 @endemolshinegroup/cz-github 来规范我们的提交信息。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/5f394b20dbf7be33b2566fc9


猜你喜欢

  • npm包eslint-config-docz-js使用教程

    前言 在前端开发当中,一个好的代码规范能够让你的代码更加易读易维护。在这个过程中,eslint是一个必不可少的工具之一。在这篇文章中,我们将介绍一个名为eslint-config-docz-js的np...

    4 年前
  • npm 包 gatsby-theme-docz 使用教程

    简介 gatsby-theme-docz 是一个基于 Gatsby 的文档生成器。它提供了一些预定义的组件,并对 Markdown 排版做出了一些优化,以便于撰写文档。

    4 年前
  • npm 包 highlight.js-tokens 使用教程

    介绍 highlight.js-tokens 是一个在 JavaScript 中使用 highlight.js 包的解析器。它可以将代码解析成 highlight.js 高亮所需要的 tokens 序...

    4 年前
  • npm 包 @types/pascal-case 使用教程

    前言 在 TypeScript 中,我们经常需要对字符串进行转化和处理。pascalCase 是一种常见的字符串格式,在一些场景下十分有用。pascal-case npm 包提供了一个用于将字符串转换...

    4 年前
  • NPM 包 Sluggish 使用教程

    什么是 Sluggish? Sluggish 是一个非常方便的 NPM 包,它能够将字符串快速地转换成 URL 友好的格式。该包基于 Node.js 平台,主要是用于服务端渲染(SSR)应用程序。

    4 年前
  • npm 包 eslint-config-docz-ts 使用教程

    在前端开发中,代码质量是至关重要的一环。为了确保代码质量,我们需要使用工具来进行代码检测。而 eslint 是前端开发中一个非常流行的代码检测工具。它可以帮助我们捕获代码中的错误、代码风格问题以及潜在...

    4 年前
  • npm 包 @livingui/cwc-popper 使用教程

    前言 在前端开发中,我们经常需要使用弹出框、下拉框等常见的 UI 元素,而 cwc-popper 就是一个可以帮助我们实现这些 UI 元素的工具包。本文将介绍如何使用 @livingui/cwc-po...

    4 年前
  • npm 包 @livingui/cwc-tag 使用教程

    前言 在 Web 开发中,标签的展示及交互是不可避免的需求。为了方便开发者快速实现功能,npm 社区涌现了众多开源的前端组件库。其中,@livingui/cwc-tag 包就是一个非常优秀的标签组件库...

    4 年前
  • npm 包 @remusao/counter 使用教程

    简介 @remusao/counter 是一个轻量级的计数器组件,适用于前端网页的开发。它提供了简单易用的 API,可以帮助您快速地实现计数器功能。 安装 在使用 @remusao/counter 之...

    4 年前
  • NPM 包 @remusao/trie 使用教程

    在前端开发中,我们经常需要使用字典或者词库来进行字符串匹配、单词提示等操作。而 @remusao/trie 就是一个非常实用的 trie 树数据结构的库,可用于快速搜索和关键词匹配。

    4 年前
  • npm包 @remusao/smaz-compress 使用教程

    简介 随着互联网的普及,前端技术发展日新月异,对于前端工程师来说,掌握好各种优秀的工具包和插件能够极大地提升开发效率和用户体验。本文将介绍一个优秀的npm包:@remusao/smaz-compres...

    4 年前
  • npm 包 @types/har-format 使用教程

    什么是 @types/har-format @types/har-format 是一种 npm 包,它提供了与 har 文件格式相关的 TypeScript 类型定义。

    4 年前
  • npm 包 @remusao/smaz-decompress 使用教程

    前言 在前端开发中,我们经常需要处理压缩过的数据。@remusao/smaz-decompress 是一款专业用于处理 smaz 压缩数据的 npm 包,其具有轻便、易用等优势,十分适合前端的数据处理...

    4 年前
  • npm 包 @csstools/normalize.css 使用教程

    本文将向您介绍 npm 包 @csstools/normalize.css 的使用方法。该包是一款用于标准化 CSS 样式的工具,能够自动解决不同浏览器之间的样式差异,使用该工具可以让您更好地专注于网...

    4 年前
  • npm 包 documentation-markdown-themes 使用教程

    前端开发中文档编写是必不可少的工作,同时也要考虑到文档的展示效果和易用性,documentation-markdown-themes 可以方便地解决文档主题的展示和自定义的问题,让文档更加美观和易用。

    4 年前
  • npm包 http-proxy-response-rewrite 的使用教程

    前言 在前端开发过程中,我们通常会使用代理来解决跨域的问题。一些优秀的代理工具如 Nginx、Apache 等能够很好地解决跨域的问题,但是需要一定的配置和维护成本。

    4 年前
  • npm 包 puppeteer-extra-plugin 使用教程

    简介 puppeteer-extra 是一个 Puppeteer 模块,它允许增强 Puppeteer 功能,可以在爬虫、测试、数据抓取等场景中应用。puppeteer-extra-plugin 是 ...

    4 年前
  • npm 包 postcss-browser-comments 使用教程

    对于前端开发者来说,常常需要使用一些预处理器来编写 CSS 样式文件。这些预处理器可以显著提高我们的工作效率,但是也会产生一些问题。其中一个问题就是 CSS 文件过大,非常不利于页面的加载速度。

    4 年前
  • npm 包 puppeteer-extra-plugin-anonymize-ua 使用教程

    简介 puppeteer-extra-plugin-anonymize-ua 是一个 npm 包,它基于 Puppeteer,用于匿名化浏览器 User-Agent。

    4 年前
  • npm 包 fpcollect 使用教程

    前言 在前端编程中,通常需要处理大量数据。在数据处理过程中,我们经常会遇到需要对数组、对象等数据结构进行操作的场景。而 fpcollect 就是一个方便且高效的 JavaScript 工具库,专注于函...

    4 年前

相关推荐

    暂无文章