From 1d5f2955c407540130f437b98c0a54a388ee2b5e Mon Sep 17 00:00:00 2001 From: Dimitri Masson <5263585+dhmmasson@users.noreply.github.com> Date: Tue, 15 Oct 2024 11:28:26 +0000 Subject: [PATCH] docs(third-party-commitizen): uniformize the third party page - Create a top level heading for provider to mirror the template heading - Uniformize the installation/usage sub-heading for each template/provider - Uniformize the code-block syntax highlighting --- docs/third-party-commitizen.md | 45 +++++++++++++++++++++++----------- 1 file changed, 31 insertions(+), 14 deletions(-) diff --git a/docs/third-party-commitizen.md b/docs/third-party-commitizen.md index 245e35a1d..1c8ef8a18 100644 --- a/docs/third-party-commitizen.md +++ b/docs/third-party-commitizen.md @@ -9,7 +9,7 @@ Just like _conventional commit_ format, but the scope has been restricted to a JIRA issue format, i.e. `project-issueNumber`. This standardises scopes in a meaningful way. -### Installation +#### Installation ```sh pip install conventional-JIRA @@ -23,25 +23,25 @@ This plugin extends the commitizen tools by: - creating links to GitHub commits in the CHANGELOG.md - creating links to JIRA issues in the CHANGELOG.md -### Installation +#### Installation ```sh pip install cz-github-jira-conventional ``` -For installation instructions (configuration and pre-commit) please visit https://github.com/apheris/cz-github-jira-conventional +For installation instructions (configuration and pre-commit) please visit [https://github.com/apheris/cz-github-jira-conventional](https://github.com/apheris/cz-github-jira-conventional) ### [cz-emoji](https://github.com/adam-grant-hendry/cz-emoji) _conventional commit_ format, but with emojis -### Installation +#### Installation ```sh pip install cz-emoji ``` -### Usage +#### Usage ```sh cz --name cz_emoji commit @@ -53,15 +53,15 @@ cz --name cz_emoji commit Includes a pre-commit hook that automatically adds the correct gitmoji to the commit message based on the conventional type. -### Installation +#### Installation -```bash +```sh pip install cz-conventional-gitmoji ``` -### Usage +#### Usage -```bash +```sh cz --name cz_gitmoji commit ``` @@ -69,9 +69,17 @@ cz --name cz_gitmoji commit Just like _conventional commit_ format, but with emojis and optionally time spent and related tasks. -It can be installed with `pip install commitizen-emoji`. +#### Installation + +```sh +pip install commitizen-emoji +``` -Usage: `cz --name cz_commitizen_emoji commit`. +#### Usage + +```sh +cz --name cz_commitizen_emoji commit +``` ### [Conventional Legacy (cz_legacy)][1] @@ -79,19 +87,28 @@ An extension of the _conventional commit_ format to include user-specified legacy change types in the `CHANGELOG` while preventing the legacy change types from being used in new commit messages -`cz_legacy` can be installed with `pip install cz_legacy` +#### Installation + +```sh +pip install cz_legacy +``` + +#### Usage See the [README][1] for instructions on configuration [1]: https://pypi.org/project/cz_legacy +## Third-Party Commitizen Providers + +Commitizen can read and write version from different sources. In addition to the native providers, some alternative version sources are available as PyPI packages (installable with `pip`). + ### [commitizen-deno-provider](https://pypi.org/project/commitizen-deno-provider/) -A provider for Deno projects. The provider updates the version in deno.json and jsr.json files. +A provider for **Deno** projects. The provider updates the version in deno.json and jsr.json files. #### Installation - ```sh pip install commitizen-deno-provider ```