草梅搜索机器人 2.0 版本的发布说明
草梅搜索机器人 v2 使用教程
草梅搜索机器人 2.0 版本的使用教程
hexo-g 报错 Cannot set property ‘lastIndex’ of undefined
hexo-g 报错 Cannot set property ‘lastIndex’ of undefined
作者:草梅友仁
使用 hexo -g
时候报错:TypeError: Cannot set property ‘lastIndex’ of undefined
解决方法:
在配置文件_config.yml 中将 highlight 选项的 auto_detect 设为 false
方法来自:https://github.com/hexojs/hexo/issues/1627
本文作者:草梅友仁
本文地址: https://blog.cmyr.ltd/archives/4b3a011e.html
版权声明:转载请注明出处!
用 typescript 生成 Swagger 文档
用 typescript 生成 Swagger 文档
参考地址:https://wz2cool.github.io/2018/04/14/swagger-ts-doc-start/
apiModelProperty 装饰器
这个装饰器主要是为了生成 definitions 中的 model,我们看代码可看到如何描述一个 typescript 中的一个类。
1 | import { apiModelProperty, DataType } from "swagger-ts-doc"; |
最后会生成与之对应的 swagger json 描述(这里我们不使用 yaml 语法,使用的 json 语法)
1 | "UpdateStudentDto": { |
Request 参数
参考 swagger 文档:
https://swagger.io/docs/specification/describing-parameters/
https://swagger.io/docs/specification/describing-request-body/
- RequestBody 类对应文档 requestBody
- PathVariable 类对应文档 path parameters (in: path)
- RequestParam 类对弈文档 query parameters (in: query)
Reponse
参考 swagger 文档:
https://swagger.io/docs/specification/describing-responses/
我们看一下定义多个返回相应
1 | [ |
registerRequestMapping 方法
这里就是我们要去生成 swagger 中 paths 节点调用的方法,这里我们举一个修改学生的一个例子。
1 | registerRequestMapping( |
本文作者:草梅友仁
本文地址: https://blog.cmyr.ltd/archives/bbc1fd72.html
版权声明:转载请注明出处!
自动生成日志
自动生成日志
参考链接:https://juejin.im/post/5bd2debfe51d457abc710b57
Commitizen – 自动生成合格的 commit message
根据上述的描述,你是不是在感慨写个 commit message
好麻烦,这里介绍下 Commitizen
– 能够根据提示自动生成符合规范的 commit message
安装
1 | $ npm install -g commitizen |
在项目中使用
然后,在项目目录里,运行下面的命令,使其支持 Angular
的 Commit message
格式。
1 | $ commitizen init cz-conventional-changelog --save --save-exact |
commit
在提交的时候就可以使用 git cz
就可以根据提示,生成自动化的 commit message
validate-commit-msg
检查你的 commit-message
规范
Commitizen
可以帮助我们规范自己的 commit-message
,但是在团队合作中,如何规范其他成员的 commit
规范呢?
可以使用 validate-commit-msg
来检查你的项目的 commit-message
是否符合格式
validate-commit-msg
安装
1 | npm install --save-dev validate-commit-msg |
husky
安装
按照 validate-commit-msg 中 README 中写的,可以用 validate-commit-msg
作为一个 githook 来验证提交消息,并且推荐了 husky
。
This provides you a binary that you can use as a githook to validate the commit message. I recommend husky. You’ll want to make this part of the commit-msg githook, e.g. when using husky, add “commitmsg”: “validate-commit-msg” to your npm scripts in package.json.
执行
1 | npm install husky --save-dev |
并且在 package.json
中的 scripts
字段中加入
1 | "commitmsg": "validate-commit-msg" |
然后每次 git commit
之后,就会自动检查 commit message
是否合格。如果不合格,就会报错
1 | husky > commit-msg (node v9.2.1) |
生成 Change log
如果你的所有 commit 都符合 Angular 格式,那么发布新版本时, Change log 就可以用脚本自动生成。
生成的文档包括以下三个部分。
- New features
- Bug fixes
- Breaking changes.
每个部分都会罗列相关的 commit ,并且有指向这些 commit 的链接。当然,生成的文档允许手动修改,所以发布前,你还可以添加其他内容。
conventional-changelog
自动根据 commit
生成 change log
conventional-changelog
安装
1 | npm install -g conventional-changelog-cli |
本文作者:草梅友仁
本文地址: https://blog.cmyr.ltd/archives/320b027.html
版权声明:转载请注明出处!