Skip to content

Commit 4ae4b34

Browse files
author
shijiashuai
committed
feat: (general) add Chinese translation for git conventional commit messages
- Translate rule set: git-conventional-commit-messages - Category: general - Status: Translation completed and reviewed - Quality: Passed translation checklist verification
1 parent dcb6718 commit 4ae4b34

File tree

2 files changed

+59
-0
lines changed
  • rules/backend/java/git-conventional-commit-messages/git-conventional-commit-messages

2 files changed

+59
-0
lines changed
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
Use the Conventional Commit Messages specification to generate commit messages
2+
3+
The commit message should be structured as follows:
4+
5+
6+
```
7+
<type>[optional scope]: <description>
8+
9+
[optional body]
10+
11+
[optional footer(s)]
12+
```
13+
--------------------------------
14+
15+
The commit contains the following structural elements, to communicate intent to the consumers of your library:
16+
17+
- fix: a commit of the type fix patches a bug in your codebase (this correlates with PATCH in Semantic Versioning).
18+
- feat: a commit of the type feat introduces a new feature to the codebase (this correlates with MINOR in Semantic Versioning).
19+
- BREAKING CHANGE: a commit that has a footer BREAKING CHANGE:, or appends a ! after the type/scope, introduces a breaking API change (correlating with MAJOR in Semantic Versioning). A BREAKING CHANGE can be part of commits of any type.
20+
- types other than fix: and feat: are allowed, for example @commitlint/config-conventional (based on the Angular convention) recommends build:, chore:, ci:, docs:, style:, refactor:, perf:, test:, and others.
21+
- footers other than BREAKING CHANGE: <description> may be provided and follow a convention similar to git trailer format.
22+
- Additional types are not mandated by the Conventional Commits specification, and have no implicit effect in Semantic Versioning (unless they include a BREAKING CHANGE). A scope may be provided to a commit’s type, to provide additional contextual information and is contained within parenthesis, e.g., feat(parser): add ability to parse arrays.
23+
24+
25+
26+
### Specification Details
27+
28+
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
29+
30+
Commits MUST be prefixed with a type, which consists of a noun, feat, fix, etc., followed by the OPTIONAL scope, OPTIONAL !, and REQUIRED terminal colon and space.
31+
The type feat MUST be used when a commit adds a new feature to your application or library.
32+
The type fix MUST be used when a commit represents a bug fix for your application.
33+
A scope MAY be provided after a type. A scope MUST consist of a noun describing a section of the codebase surrounded by parenthesis, e.g., fix(parser):
34+
A description MUST immediately follow the colon and space after the type/scope prefix. The description is a short summary of the code changes, e.g., fix: array parsing issue when multiple spaces were contained in string.
35+
A longer commit body MAY be provided after the short description, providing additional contextual information about the code changes. The body MUST begin one blank line after the description.
36+
A commit body is free-form and MAY consist of any number of newline separated paragraphs.
37+
One or more footers MAY be provided one blank line after the body. Each footer MUST consist of a word token, followed by either a :<space> or <space># separator, followed by a string value (this is inspired by the git trailer convention).
38+
A footer’s token MUST use - in place of whitespace characters, e.g., Acked-by (this helps differentiate the footer section from a multi-paragraph body). An exception is made for BREAKING CHANGE, which MAY also be used as a token.
39+
A footer’s value MAY contain spaces and newlines, and parsing MUST terminate when the next valid footer token/separator pair is observed.
40+
Breaking changes MUST be indicated in the type/scope prefix of a commit, or as an entry in the footer.
41+
If included as a footer, a breaking change MUST consist of the uppercase text BREAKING CHANGE, followed by a colon, space, and description, e.g., BREAKING CHANGE: environment variables now take precedence over config files.
42+
If included in the type/scope prefix, breaking changes MUST be indicated by a ! immediately before the :. If ! is used, BREAKING CHANGE: MAY be omitted from the footer section, and the commit description SHALL be used to describe the breaking change.
43+
Types other than feat and fix MAY be used in your commit messages, e.g., docs: update ref docs.
44+
The units of information that make up Conventional Commits MUST NOT be treated as case sensitive by implementors, with the exception of BREAKING CHANGE which MUST be uppercase.
45+
BREAKING-CHANGE MUST be synonymous with BREAKING CHANGE, when used as a token in a footer.
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
## 约定式提交信息
2+
3+
这是一个用于生成约定式提交信息的 .cursorrules 提示文件。
4+
5+
## 使用方法
6+
7+
1. 将 .cursorrules 文件复制到您的项目中。
8+
2. 打开 Cursor AI 并选择 .cursorrules 文件。
9+
3. 开始输入您的提交信息。
10+
4. Cursor AI 将生成约定式提交信息。
11+
5. 复制约定式提交信息并粘贴到您的终端中。
12+
13+
基于约定式提交信息规范 V1.0.0:https://www.conventionalcommits.org/en/v1.0.0/#specification
14+

0 commit comments

Comments
 (0)