mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2024-11-26 21:51:05 +01:00
440b66da14
Issue: ohmyzsh/ohmyzsh#12627 This commit refactors the prior implementation which used git aliases and modified .gitconfig. This implementation uses proper git-dash commands, which are all just symlinks to one handler - omz_git_commit.
44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# git-commit plugin
|
|
|
|
The git-commit plugin adds several git subcommands for
|
|
[conventional commit](https://www.conventionalcommits.org/en/v1.0.0/#summary) messages.
|
|
|
|
To use it, add `git-commit` to the plugins array in your zshrc file:
|
|
|
|
```zsh
|
|
plugins=(... git-commit)
|
|
```
|
|
|
|
## Syntax
|
|
|
|
```zsh
|
|
git <type> [(-s, --scope) "<scope>"] [(-a, --attention)] "<message>"
|
|
```
|
|
|
|
Where `type` is one of the following:
|
|
|
|
- `build`
|
|
- `chore`
|
|
- `ci`
|
|
- `docs`
|
|
- `feat`
|
|
- `fix`
|
|
- `perf`
|
|
- `refactor`
|
|
- `rev`
|
|
- `style`
|
|
- `test`
|
|
- `wip`
|
|
|
|
> NOTE: the subcommand for `revert` type is `rev`, as otherwise it conflicts with the
|
|
> git command of the same name. It will still generate a commit message in the format
|
|
> `revert: <message>`
|
|
|
|
## Examples
|
|
|
|
| Git subcommand | Command |
|
|
| --------------------------------------------- | ---------------------------------------------------- |
|
|
| `git style "remove trailing whitespace"` | `git commit -m "style: remove trailing whitespace"` |
|
|
| `git wip "work in progress"` | `git commit -m "work in progress"` |
|
|
| `git fix -s "router" "correct redirect link"` | `git commit -m "fix(router): correct redirect link"` |
|
|
| `git rev -s "api" "rollback v2"` | `git commit -m "revert(api): rollback v2"` |
|