Merge pull request #130 from Sbragul26/standardize-academy-makefiles

chore(make): standardize Makefile structure across academies

Author: saurabhraghuvanshii

Makefile

@@ -18,29 +18,42 @@ include .github/build/Makefile.show-help.mk
 #----------------------------------------------------------------------------
 # Academy
 # ---------------------------------------------------------------------------
-.PHONY: setup build site clean check-go theme-update
-
 ## ------------------------------------------------------------
 ----LOCAL_BUILDS: Show help for available targets
 
 ## Local: Install site dependencies
 setup:
-	 npm i
+	npm install
+
+## Local: Build and run site locally with draft and future content enabled.
+site: check-go
+	hugo server -D -F
 
 ## Local: Build site for local consumption
 build:
 	hugo build
 
-## Local: Build and run site locally with draft and future content enabled.
-site: check-go
-	hugo server -D -F
-	
+## Build site for local consumption
+build-preview:
+	hugo --baseURL=$(BASEURL)
+
 ## Empty build cache and run on your local machine.
 clean: 
 	hugo --cleanDestinationDir
 	make setup
 	make site
 
+## Fix Markdown linting issues
+lint-fix:
+	@echo "Checking for markdownlint-cli2..."
+	@command -v markdownlint-cli2 > /dev/null || { \
+		echo "markdownlint-cli2 not found. Attempting to install globally..."; \
+		command -v npm > /dev/null || { echo "npm is not installed. Please install Node.js/npm and re-run 'make lint-fix'."; exit 1; }; \
+		npm install -g markdownlint-cli2; \
+	}
+	@echo "Running markdownlint-cli2 --fix..."
+	@markdownlint-cli2 --fix "**/*.md" "#node_modules" "#public" "#resources"
+
 ## ------------------------------------------------------------
 ----MAINTENANCE: Show help for available targets
 
@@ -53,3 +66,5 @@ check-go:
 theme-update:
 	echo "Updating to latest academy-theme..." && \
 	hugo mod get github.com/layer5io/academy-theme
+
+.PHONY: setup build build-preview site clean lint-fix check-go theme-update

README.md

@@ -103,9 +103,12 @@ The site will be available at `http://localhost:1313/academy/` (or the port show
 | Command | Description |
 |---------|-------------|
 | `make setup` | Install npm dependencies |
-| `make build` | Build the site for production |
 | `make site`  | Build and run site locally with draft and future content enabled |
+| `make build` | Build the site for production |
+| `make build-preview` | Build site for preview draft and future content enabled (honors `BASEURL`) |
 | `make clean` | Clear build cache and restart the dev server |
+| `make lint-fix` | Fix Markdown linting issues with `markdownlint-cli2` |
+| `make check-go` | Verify Go is installed locally |
 | `make theme-update` | Update the `academy-theme` Hugo module to the latest version |
 
 ---