mirror of
https://github.com/tiennm99/HugoBlox-kit.git
synced 2026-10-05 16:13:52 +00:00
George Cushen
787ac94b5d
Dev tools - Add HBX Dev HUD (floating button + panel) with live log viewer - Add get-build-id helper to dedupe logs per build (during `hugo server` refreshes) Callouts - Implement Obsidian-compatible callouts (15+ types) with shared renderer - Add i18n title translations (en, es, fr) for all callout types - Deprecate `callout` shortcode with suppressible warning; keep working - Migrate starters to Markdown callouts (>[!TYPE]) and update docs Logging - Centralize logging in partial `functions/logger` with info/warn/error levels - Use fmt.Warnidf for suppressible warnings (consistent IDs) - Only show info in Dev HUD/JSON (no longer use warnf for info logging); warn/error still printed in CLI - Include source metadata and build ID on each entry Blocks – Collection - Add support for `content.filters.kinds` - Add `content.filters.tags` (array) alongside existing `filters.tag` (string) Build/Tailwind/JS - Fix missing Tailwind v4 styles in Hugo render: include preact-built assets, extract classes from JSX/TSX to `@sources` - Load Preact client per block, publish source maps in dev; on-demand Alpine CI - Re-implement fast fails with panicOnWarning now that info logging as warnf removed - Fix package splitter change detection: strip trailing slashes; collapse paths to starter roots Starters/Docs - Restructure courses under `courses/hugo-blox/` - Update menus and landing pages - Replace deprecated callout usage in content and docs - Replace missing hero icon `download` with `arrow-down-tray` in academic-cv guide Icons - Improve icon resolver: default pack inference, better fallback, and precise missing-icon warnings (with page ref)
122 lines
3.3 KiB
Bash
Executable File
122 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 HUGO_BLOX_MONOREPO=true
|
|
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+=(
|
|
--panicOnWarning
|
|
--logLevel debug
|
|
--templateMetrics
|
|
--templateMetricsHints
|
|
--ignoreCache
|
|
--noHTTPCache
|
|
--renderStaticToDisk
|
|
-D
|
|
-E
|
|
)
|
|
fi
|
|
|
|
hugo "${HUGO_ARGS[@]}"
|