fix: use branch instead of tag

Signed-off-by: Mateusz Urbanek <mateusz.urbanek.98@gmail.com>

Author: shanduur

Makefile

@@ -119,7 +119,7 @@ build-docs: generate mdbook
 MDBOOK_PORT ?= 3000
 
 .PHONY: serve-docs
-serve-docs: generate mdbook
+serve-docs: generate mdbook build-docs
 	cd docs; $(MDBOOK) serve --port $(MDBOOK_PORT)
 
 .PHONY: clean
@@ -175,7 +175,7 @@ CTLPTL_VERSION        ?= v0.8.39
 GOLANGCI_LINT_VERSION ?= v1.64.7
 KIND_VERSION          ?= v0.27.0
 KUSTOMIZE_VERSION     ?= v5.6.0
-MDBOOK_VERSION        ?= v0.4.47
+MDBOOK_VERSION        ?= v0.4.45
 
 .PHONY: chainsaw
 chainsaw: $(CHAINSAW)-$(CHAINSAW_VERSION)

docs/book.toml

@@ -6,7 +6,8 @@ authors = ["The Kubernetes Authors"]
 [output.html]
 git-repository-url = "https://github.com/kubernetes-sigs/container-object-storage-interface/tree/main/docs"
 edit-url-template = "https://github.com/kubernetes-sigs/container-object-storage-interface/tree/main/docs/{path}"
-additional-css = ["custom.css"]
+additional-css = ["theme/custom.css"]
+theme = "theme"
 
 [preprocessor.generate-version]
 renderers = ["html"]

docs/scripts/generate-version.sh

@@ -1,8 +1,15 @@
-jq ".[1]";
+#!/usr/bin/env bash
+
+set -eu
+
+jq ".[1]"
+
 SHA=$(git rev-parse HEAD)
-VERSION="Built from: <a target="_blank" href=\"https:\/\/github.com\/kubernetes-sigs\/container-object-storage-interface\/tree\/${SHA}\"><code>${SHA}<\/code><\/a>"
-TAG=$(git tag --contains "$SHA" | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$')
-if [ -n "$TAG" ]; then
-  VERSION="Version: <a target="_blank" href=\"https:\/\/github.com\/kubernetes-sigs\/container-object-storage-interface\/tree\/${TAG}\"><code>${TAG}<\/code><\/a> ${VERSION}"
+VERSION="Commit: <a target="_blank" href=\"https:\/\/github.com\/kubernetes-sigs\/container-object-storage-interface\/tree\/${SHA}\"><code>${SHA}<\/code><\/a>"
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+if [ -n "$BRANCH" ]; then
+  VERSION="Branch: <a target="_blank" href=\"https:\/\/github.com\/kubernetes-sigs\/container-object-storage-interface\/tree\/${BRANCH}\"><code>${BRANCH}<\/code><\/a> ${VERSION}"
 fi
+
 sed "s/VERSION-PLACEHOLDER/${VERSION}/" theme/index-template.hbs > theme/index.hbs