Files
HugoBlox-kit/scripts/view-starter-dev.sh
T
George Cushen e6734f33ae feat(scripts): default to academic-cv starter when no argument provided
- Update view-starter-dev.sh to default to academic-cv if no starter specified
- Update view-starter-prod.sh to default to academic-cv if no starter specified
- Update usage documentation to show starter name as optional parameter
- Maintain backward compatibility with existing usage patterns
2025-09-17 00:16:19 +01:00

121 lines
3.3 KiB
Bash
Executable File

#!/usr/bin/env bash
set -euo pipefail
INITIAL_DIR="$(pwd)"
cleanup() {
cd "$INITIAL_DIR" || true
}
trap cleanup EXIT INT TERM
usage() {
echo "View a starter template with local development modules and debug features."
echo ""
echo "Usage: ./scripts/view-starter-dev.sh [<starter-name>] [--debug] [--no-pagefind]"
echo "Example: ./scripts/view-starter-dev.sh blog --debug"
echo "Default starter: academic-cv (if no starter-name provided)"
echo ""
echo "This script uses:"
echo " • Local development modules (via HUGO_MODULE_REPLACEMENTS)"
echo " • Development environment with demo/debug flags enabled"
echo " • Optional Pagefind search indexing and enhanced debugging"
}
STARTER="academic-cv" # Default starter if none provided
DEBUG_MODE=false
PAGEFIND=true
while [ $# -gt 0 ]; do
case "$1" in
--debug)
DEBUG_MODE=true
shift
;;
--no-pagefind)
PAGEFIND=false
shift
;;
-h|--help)
usage
exit 0
;;
-*)
echo "Unknown option: $1"
usage
exit 1
;;
*)
STARTER="$1"
shift
;;
esac
done
# Run Hugo from the site dir so Tailwind CLI is discoverable
cd "starters/$STARTER"
# Ensure Tailwind CLI exists in starter (required for Hugo css.TailwindCSS)
if [ -f "package.json" ] && [ ! -x "node_modules/.bin/tailwindcss" ]; then
echo "📦 Installing Tailwind CLI in starter directory for Hugo..."
if command -v pnpm >/dev/null 2>&1; then
pnpm install
else
npm install
fi
fi
# Core environment for local dev linking modules and enabling demo/debug flags
export HUGO_BLOX_DEMO=true
export HUGO_BLOX_DEBUG=true
export HUGO_ENVIRONMENT=development
export HUGOxPARAMSxDECAP_CMSxLOCAL_BACKEND=true
# Link local modules for development (Hugo module replacements)
export HUGO_MODULE_REPLACEMENTS="\
github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind -> ../../../modules/blox-tailwind,\
github.com/HugoBlox/hugo-blox-builder/modules/blox-analytics -> ../../../modules/blox-analytics,\
github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-netlify -> ../../../modules/blox-plugin-netlify,\
github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-reveal -> ../../../modules/blox-plugin-reveal,\
github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-decap-cms -> ../../../modules/blox-plugin-decap-cms\
"
# Optionally pre-build and generate Pagefind index for local search
if [ "$PAGEFIND" = true ]; then
hugo
if command -v pnpm >/dev/null 2>&1; then
pnpm dlx pagefind --site "public" --output-subdir ../static/pagefind
else
npm_config_yes=true npx pagefind --site "public" --output-subdir ../static/pagefind
fi
fi
# Compose Hugo server args
HUGO_ARGS=(
server
--disableFastRender
--printI18nWarnings
--printPathWarnings
--gc
-F
--port 8081
--bind 0.0.0.0
)
if [ "$DEBUG_MODE" = true ]; then
HUGO_ARGS+=(
--logLevel debug
--panicOnWarning
--templateMetrics
--templateMetricsHints
--ignoreCache
--noHTTPCache
--renderStaticToDisk
-D
-E
)
fi
hugo "${HUGO_ARGS[@]}"