diff --git a/build.gradle.kts b/build.gradle.kts
index 875c48e..25a15d2 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -54,3 +54,12 @@ plugins.withType(org.jetbrains.kotlin.gradle.targets.js.yarn.YarnPlugin::class.j
}
// endregion
+// region Configure Dokka overrides
+
+dokka {
+ pluginsConfiguration.html {
+ templatesDir.set(file("docs/dokka/overrides"))
+ }
+}
+
+// endregion
diff --git a/docs/dokka/overrides/includes/page_metadata.ftl b/docs/dokka/overrides/includes/page_metadata.ftl
new file mode 100644
index 0000000..3d419df
--- /dev/null
+++ b/docs/dokka/overrides/includes/page_metadata.ftl
@@ -0,0 +1,6 @@
+<#macro display>
+
${pageName}
+ <@template_cmd name="pathToRoot">
+
+ @template_cmd>
+#macro>
--
2.51.2
From 25fb158bee2edaa826a7585cec24a476d297bf08 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=E2=80=9CCLOVIS=E2=80=9D=20Canet?=
Date: Sun, 30 Nov 2025 18:57:44 +0100
Subject: [PATCH 2/5] feat(dokka): Enable Plausible
---
.../overrides/includes/page_metadata.ftl | 26 +++++++++++++++++++
1 file changed, 26 insertions(+)
diff --git a/docs/dokka/overrides/includes/page_metadata.ftl b/docs/dokka/overrides/includes/page_metadata.ftl
index 3d419df..65adb1f 100644
--- a/docs/dokka/overrides/includes/page_metadata.ftl
+++ b/docs/dokka/overrides/includes/page_metadata.ftl
@@ -3,4 +3,30 @@
<@template_cmd name="pathToRoot">
@template_cmd>
+
+ <@template_cmd name="projectName">
+
+
+
+ @template_cmd>
#macro>
--
2.51.2
From d8fb9c309d1b5c976078d3fc9fe4fdddc79a1c61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=E2=80=9CCLOVIS=E2=80=9D=20Canet?=
Date: Wed, 3 Dec 2025 22:07:23 +0100
Subject: [PATCH 3/5] upgrade: GitLab CI for Kotlin 0.7.2
---
.gitlab-ci.main.kts | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.gitlab-ci.main.kts b/.gitlab-ci.main.kts
index 3827a19..d85d238 100755
--- a/.gitlab-ci.main.kts
+++ b/.gitlab-ci.main.kts
@@ -1,7 +1,7 @@
#!/usr/bin/env kotlin
// https://gitlab-ci-kts.opensavvy.dev/news/index.html
-@file:DependsOn("dev.opensavvy.gitlab:gitlab-ci-kotlin-jvm:0.7.1")
+@file:DependsOn("dev.opensavvy.gitlab:gitlab-ci-kotlin-jvm:0.7.2")
import opensavvy.gitlab.ci.*
import opensavvy.gitlab.ci.Environment.EnvironmentTier.Development
--
2.51.2
From cb711b10c9684d740a931249b2e07ec38e26c66b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=E2=80=9CCLOVIS=E2=80=9D=20Canet?=
Date: Sat, 13 Dec 2025 13:15:58 +0100
Subject: [PATCH 4/5] upgrade: NodeJS 24.12.0
---
build.gradle.kts | 11 +++++++++++
gradle/common.versions.toml | 3 +++
2 files changed, 14 insertions(+)
diff --git a/build.gradle.kts b/build.gradle.kts
index 25a15d2..91b3151 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -63,3 +63,14 @@ dokka {
}
// endregion
+// region NodeJS version
+
+project.plugins.withType {
+ project.the().version.set(libsCommon.versions.nodejs)
+}
+
+project.plugins.withType {
+ project.the().version.set(libsCommon.versions.nodejs)
+}
+
+// endregion
diff --git a/gradle/common.versions.toml b/gradle/common.versions.toml
index 6e9a163..9bc5360 100644
--- a/gradle/common.versions.toml
+++ b/gradle/common.versions.toml
@@ -28,6 +28,9 @@ prepared = "2.2.0"
# https://github.com/JetBrains/java-annotations/releases
jetbrains-annotations = "26.0.2-1"
+# https://nodejs.org/en/download
+nodejs = "24.12.0"
+
[plugins]
kotlin = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
--
2.51.2
From 43e2679f4090082f5f43f8fc041e6d5cdee89dac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=E2=80=9CCLOVIS=E2=80=9D=20Canet?=
Date: Sat, 13 Dec 2025 17:21:45 +0100
Subject: [PATCH 5/5] ci(gitlab): Remove the unused docs/website CI file
All its logic was moved to the Kotlin DSL in f7c94a6022e9edd6052c0aed2b4135f128533f37.
---
docs/website/.gitlab-ci.yml | 37 -------------------------------------
1 file changed, 37 deletions(-)
delete mode 100644 docs/website/.gitlab-ci.yml
diff --git a/docs/website/.gitlab-ci.yml b/docs/website/.gitlab-ci.yml
deleted file mode 100644
index 254ace4..0000000
--- a/docs/website/.gitlab-ci.yml
+++ /dev/null
@@ -1,37 +0,0 @@
-
-mkdocs:
- image: registry.gitlab.com/opensavvy/automation/containers/mkdocs:$ci_containers
- stage: build
- extends: [ .os.gradle ]
- needs: [ os.version ]
-
- variables:
- GIT_DEPTH: 0
-
- before_script:
- - ./docs/website/verify-marker.sh
- - ./gradlew docs:website:embedDokkaIntoMkDocs -PappVersion=$project_version
- - cd docs/website
- - ls
- - 'echo "repo_url: $CI_PROJECT_URL">>mkdocs.yml'
- - 'echo "repo_name: $CI_PROJECT_TITLE">>mkdocs.yml'
- - 'echo "site_url: $CI_PAGES_URL">>mkdocs.yml'
-
- script:
- - pwd
- - ./generate-news.sh
- - mkdocs build --site-dir ../../docs-website
-
- after_script:
- - echo "URL=$(.gitlab/ci/review-url.sh docs-website/index.html)" >>docs.env
-
- artifacts:
- paths:
- - docs-website
- reports:
- dotenv: docs.env
-
- environment:
- name: review/$CI_COMMIT_REF_SLUG/docs
- url: $URL
- deployment_tier: development