fix(build): resolve Docsy 0.16.0 vendor deps via npm workspace

Author: alee

.github/scripts/build-site.sh

@@ -36,6 +36,14 @@ mkdir -p "$HUGO_CACHEDIR" "$OUTPUT_DIR" "$npm_config_cache"
 git config --global --add safe.directory /src
 git config --global core.quotepath false
 
+# Docsy 0.16.0 theme module mounts expect node_modules/ at the project root
+# (e.g. node_modules/bootstrap -> assets/vendor/bootstrap).  PostCSS tooling
+# and theme dependencies are installed at /tmp/node_modules by the Dockerfile;
+# symlink so Hugo module mounts resolve them at the project root.
+if [ ! -e node_modules ]; then
+  ln -s /tmp/node_modules node_modules
+fi
+
 set -- build \
   --gc \
   --minify \

Dockerfile

@@ -35,8 +35,13 @@ RUN git config --global --add safe.directory /src
 # python3 is required for uv to create a venv when running scripts with inline metadata.
 RUN apk add --no-cache nodejs npm go python3
 
-# Install front-end tooling.
+# Install front-end tooling and Docsy theme npm dependencies (Bootstrap, Font
+# Awesome) into /tmp/node_modules.  The packages/ workspace directory is
+# required so npm ci processes the hugoautogen workspace that Hugo generates
+# via "hugo mod npm pack"; without it @fortawesome/fontawesome-free is missing
+# and Docsy 0.16.0's module mounts fail.
 COPY package.json package-lock.json /tmp/
+COPY packages/ /tmp/packages/
 RUN --mount=type=cache,target=/root/.npm \
     cd /tmp && npm ci
 

Makefile

@@ -56,7 +56,7 @@ render-site-isolated : build
 		-v "$(HUGO_ISOLATED_CACHE_HOST_DIR)":"$(HUGO_ISOLATED_CACHE_CONTAINER_DIR)":rw \
 		-w /tmp \
 		$(HUGO_IMAGE) \
-		-lc 'cp -a /workspace /tmp/src && git config --global --add safe.directory /tmp/src && cd /tmp/src && hugo build --gc --minify --cacheDir "$(HUGO_ISOLATED_CACHE_CONTAINER_DIR)" -d /tmp/public --noBuildLock'
+		-lc 'cp -a /workspace /tmp/src && git config --global --add safe.directory /tmp/src && cd /tmp/src && ln -s /tmp/node_modules node_modules && hugo build --gc --minify --cacheDir "$(HUGO_ISOLATED_CACHE_CONTAINER_DIR)" -d /tmp/public --noBuildLock'
 
 ## publications-json: generate Hugo data/publications.json from BibTeX.
 publications-json : build