docs(changelog): make it possible to include a section of the commit …

…message in the changelog

This part of the commit message will not be included.
If you have any references to issues, or need to
include the keywords to cause a major version bump,
include them before the section that should go into
the changelog.

-CHANGELOG-
This part of the commit message will be included in
the release notes and in the changelog. For optimal
formatting in the changelog, do not include blank
lines, only single line breaks.
  - Lists can be included by indenting them with 2 spaces.
    Further lines on the same list item, like this one,
    should be indented with 2 more spaces still.

commit.hbs

@@ -0,0 +1,34 @@
+
+*{{#if scope}} **{{scope}}:**
+{{~/if}} {{#if subject}}
+  {{~subject}}
+{{~else}}
+  {{~header}}
+{{~/if}}
+
+{{~!-- commit link --}}{{~#if hash}} {{#if @root.linkReferences~}}
+  ([{{shortHash}}]({{~@root.host}}/{{#if this.owner}}{{~this.owner}}{{else}}{{~@root.owner}}{{/if}}/{{#if this.repository}}{{~this.repository}}{{else}}{{~@root.repository}}{{/if}}/commit/{{hash}}))
+{{~else}}
+  {{~shortHash}}
+{{~/if}}{{~/if}}
+
+{{~!-- commit references --}}
+{{~#if references~}}
+  , closes
+  {{~#each references}} {{#if @root.linkReferences~}}
+    [
+    {{~#if this.owner}}
+      {{~this.owner}}/
+    {{~/if}}
+    {{~this.repository}}{{this.prefix}}{{this.issue}}]({{~@root.host}}/{{#if this.owner}}{{~this.owner}}{{else}}{{~@root.owner}}{{/if}}/{{#if this.repository}}{{~this.repository}}{{else}}{{~@root.repository}}{{/if}}/issues/{{this.issue}})
+  {{~else}}
+    {{~#if this.owner}}
+      {{~this.owner}}/
+    {{~/if}}
+    {{~this.repository}}{{this.prefix}}{{this.issue}}
+  {{~/if}}{{/each}}
+{{~/if}}
+{{#if CHANGELOG}}
+
+{{CHANGELOG}}
+{{~/if}}

release.config.js

@@ -1,4 +1,7 @@
 /* eslint-env node */
+const { readFileSync } = require('fs');
+const { join } = require('path');
+
 module.exports = {
     branches: [
         'main',
@@ -18,7 +21,12 @@ module.exports = {
         [
             '@semantic-release/release-notes-generator',
             {
-                preset: 'conventionalcommits',
+                writerOpts: {
+                    commitPartial: readFileSync(
+                        join(__dirname, 'commit.hbs'),
+                        'utf-8'
+                    ),
+                },
             },
         ],
         '@semantic-release/changelog',