[chore]: standardize makefile to npm run calls

[banana-three-join]

Notes for Reviewers

This PR fixes #226

Summary

Makefile

Bug fixes

• clean ran hugo --cleanDestinationDir — a build, not a clean. public/ and resources/ were never removed. Now npm run clean.
• build ran bare hugo (a production build, no clean) under a "local machine" label. Now npm run build (dev build with clean + drafts/future content).

Behavior

• site: hugo server -D -F → npm run site (adds --cleanDestinationDir, -E for expired content, and --minify).
• lint-fix: no longer installs markdownlint-cli2 globally (npm install -g); uses npx --yes. Scope narrowed from **/*.md to content/**/*.md.

Added

• Missing include .github/build/Makefile.core.mk (the old file only included Makefile.show-help.mk).
• Targets: build-preview, build-production, site-no-watch, check-links, format, format-check, check-deps, theme-update.
• HTMLTEST_VERSION ?= latest (+ export) — single place to pin htmltest.
• check-go check-deps prerequisites on all build/serve/theme targets (previously only site had check-go).

Structural

• All recipes now route through npm run instead of calling hugo directly, making package.json the single source of Hugo flags.

package.json

Removed

• Trailing -- on _build and build — no-ops
• check:links:all, precheck:links:all — orphaned; nothing invoked them

Renamed

• _serve → _site, serve → site
• update:dep → update:pkg:dep, update:hugo → update:pkg:hugo

Added

• Scripts: site, site:no-watch, format, format:check, update:theme
• prettier@3.8.3

Behavior

• build:production: added --gc (cache garbage collection; output unchanged)
• Serve uses canonical hugo server instead of the serve alias, and --renderToMemory was dropped, so serve now writes to public/
• _check:links: IMPLEMENTATION PENDING → Skipped: go run …htmltest… -s. Link checking remains a no-op, now explicitly labelled.

Dependencies

• autoprefixer floor ^10.4.21 → ^10.5.0
• postcss floor ^8.5.14 → ^8.5.15
• Added prettier@3.8.3
• package-lock.json regenerated to match

Breaking

• npm run serve, _serve, update:dep, update:hugo, check:links:all no longer exist.
• make build now cleans the destination directory and includes drafts/future content; use make build-production for production output.

Signed commits

• Yes, I signed my commits.

[github-actions]

🚀 Preview deployment: https://layer5io.github.io/academy-theme/pr-preview/pr-227/

[gemini-code-assist]

Code Review

This pull request introduces an .htmltest.yml configuration for link checking, refactors the Makefile to delegate tasks to npm scripts, and updates package.json with new scripts for building, formatting with Prettier, and updating the theme. Feedback on these changes highlights that the _check:links script only echoes the command instead of executing it, disabling link checking. Additionally, it is recommended to define a lint:fix script in package.json, add markdownlint-cli2 to devDependencies for reproducible linting, and update the Makefile to invoke this script via npm rather than using npx directly.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.