feat(changelog): skip unreleased section if no commits are associated

CHANGELOG.md

@@ -2,17 +2,14 @@
 ## [Unreleased]
 
 
-<a name="2023.8.23-stable.1608.9730ec9"></a>
-## [2023.8.23-stable.1608.9730ec9] - 2023-08-23
-
-<a name="2023.8.23-stable.1545.643e170"></a>
-## [2023.8.23-stable.1545.643e170] - 2023-08-23
-
-<a name="2023.8.23-stable.1545.2f77f3e"></a>
-## [2023.8.23-stable.1545.2f77f3e] - 2023-08-23
+<a name="2023.8.23-stable.1615.0545812"></a>
+## [2023.8.23-stable.1615.0545812] - 2023-08-23
 ### Bug Fixes
 - **changelog:** add missing task dependency
 
+### Documentation
+- add tutorial to generate release with its changelog
+
 ### Features
 - add changelog
 - add mkt-changelog task
@@ -26,7 +23,5 @@
 - initial commit
 
 
-[Unreleased]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1608.9730ec9...HEAD
-[2023.8.23-stable.1608.9730ec9]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1545.643e170...2023.8.23-stable.1608.9730ec9
-[2023.8.23-stable.1545.643e170]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1545.2f77f3e...2023.8.23-stable.1545.643e170
-[2023.8.23-stable.1545.2f77f3e]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1207.cd2f1ba...2023.8.23-stable.1545.2f77f3e
+[Unreleased]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1615.0545812...HEAD
+[2023.8.23-stable.1615.0545812]: https://forge.cadoles.com/Cadoles/mktools/compare/2023.8.23-stable.1207.cd2f1ba...2023.8.23-stable.1615.0545812

install.sh

@@ -3,7 +3,7 @@
 set -e
 
 TASKS_DIR=".mktools"
-TASKS_FILES="webdav gitea"
+TASKS_FILES="webdav gitea changelog version checkmake"
 
 main() {
     echo "Creating directory '$TASKS_DIR/'"

tasks/changelog.mk

@@ -50,10 +50,10 @@ define _MKT_GIT_CHGLOG_TEMPLATE_SCRIPT =
 mkdir -p .chglog
 cat > .chglog/CHANGELOG.tpl.md << EOF
 {{ if .Versions -}}
+{{ if .Unreleased.CommitGroups -}}
 <a name="unreleased"></a>
 ## [Unreleased]
 
-{{ if .Unreleased.CommitGroups -}}
 {{ range .Unreleased.CommitGroups -}}
 ### {{ .Title }}
 {{ range .Commits -}}

tasks/version.mk

@@ -19,8 +19,9 @@ else
 	MKT_PROJECT_SHORT_VERSION_CHANNEL ?= $(shell echo "$(MKT_PROJECT_VERSION_CHANNEL)" | sed -e 's/[aeiouy]//g' | cut -c1-3)
 endif
 
-MKT_PROJECT_VERSION_DATE ?= $(shell date +%Y.%-m.%-d)
-MKT_PROJECT_VERSION_TIMESTAMP ?= $(shell date +%-H%M)
+MKT_PROJECT_VERSION_COMMIT_TIMESTAMP ?= $(shell git show -s --format=%ct)
+MKT_PROJECT_VERSION_DATE ?= $(shell TZ=Europe/Paris date -d '@$(MKT_PROJECT_VERSION_COMMIT_TIMESTAMP)' +%Y.%-m.%-d)
+MKT_PROJECT_VERSION_TIMESTAMP ?= $(shell TZ=Europe/Paris date -d '@$(MKT_PROJECT_VERSION_COMMIT_TIMESTAMP)' +%-H%M)
 
 MKT_PROJECT_VERSION ?= $(MKT_PROJECT_VERSION_DATE)-$(MKT_PROJECT_VERSION_CHANNEL).$(MKT_PROJECT_VERSION_TIMESTAMP).$(shell git rev-parse --short HEAD)
 MKT_PROJECT_SHORT_VERSION ?= $(MKT_PROJECT_VERSION_DATE)-$(MKT_PROJECT_SHORT_VERSION_CHANNEL).$(MKT_PROJECT_VERSION_TIMESTAMP)