HugoBlox-kit

2,275 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
George Cushen	787ac94b5d	feat: add Dev HUD & 15 Obsidian callouts; more collection filters 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)	2025-09-25 01:58:32 +01:00
George Cushen	220330d872	refactor: implement multi-tier logging and drop panicOnWarning - Centralize logger: warnf/errorf for normal pages; HTML comments for adapters - Add dev console logs and export structured logs to /hbx-debug.json - Remove --panicOnWarning from dev scripts; builds no longer fail on warnings - Fix prior lint/format issues across scripts and templates	2025-09-22 22:48:26 +01:00
George Cushen	a2aaa838c0	feat(preact+landing): enable Preact block rendering + reusable landing page content system ## Preact Block Integration - Enable Preact component detection for data-driven pages: - Fix init.html to resolve sections_source + per-section ref before Preact detection - Correct resource paths: blox/* → js/hbx/blocks/* (Hugo module mounts) - Update libraries.html to load Preact core + compiled block scripts - Add dynamic icon rendering for Preact components: - Create Icon.jsx component with SVG decoding - Add get_icon_data.html partial for passing icon strings to Preact props - Update preact-wrapper.html to fetch icon data and inject into props - Wire hero component to render dynamic icons via <Icon svg={icon_svg} /> - Centralized logging system: - Add functions/logger.html to wrap warnf/errorf safely - Degrade to HTML comments in constrained contexts (content adapters) ## Reusable Landing Page Content System - Add sections_source support: - Page front matter: sections_source: pages/<key> loads base from data/pages/<key>.yaml - Inline sections deep-merge over base by position; extras appended - Add per-section ref system: - Any section: ref: blocks/<slug> loads from data/blocks/<slug>.yaml - Inline section properties deep-merge over ref (content/design submaps) - Enable content reuse across multiple landing pages - Create reusable block library: - Add test/data/blocks/: hero_basic.yaml, features_basic.yaml - Add test/content/linked/index.md demo using refs with overrides - Add pragmatic deep merge for content/design override handling ## Infrastructure & Schemas - Update base-block.json schema: - Fix gradient structure: flat → nested (gradient.start/end/direction) - Fix color structure: string\|{light,dark} (matches parse_block_v3.html) - Update hero schema to properly extend base via $ref - Fix Tailwind source path generation: - Add tailwind_sources.html with test vs starter site logic - scripts/view-test.sh: export HUGO_BLOX_TEST_SITE=true - Update block directory structure: - blox/<name>/config.html (was blox/<name>--CONFIG.html) - Apply to init.html + parse_block_v2.html - Code quality improvements: - Biome config: match Prettier rules ## Content Adapters (Removed) - Investigated Hugo content adapters for landing pages - Found execution context limitations (early build phase, limited site methods) - Archived to backups/content-adapters-*.zip and removed from test site - Decision: use standard pages + data linking instead of adapters This enables dynamic Preact rendering with proper icon support while providing a flexible, reusable content system for landing pages that maintains the "single file = page" mental model with optional advanced linking.	2025-09-22 22:18:03 +01:00

Author

SHA1

Message

Date

George Cushen

787ac94b5d

feat: add Dev HUD & 15 Obsidian callouts; more collection filters

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)

2025-09-25 01:58:32 +01:00

George Cushen

220330d872

refactor: implement multi-tier logging and drop panicOnWarning

- Centralize logger: warnf/errorf for normal pages; HTML comments for adapters
- Add dev console logs and export structured logs to /hbx-debug.json
- Remove --panicOnWarning from dev scripts; builds no longer fail on warnings
- Fix prior lint/format issues across scripts and templates

2025-09-22 22:48:26 +01:00

George Cushen

a2aaa838c0

feat(preact+landing): enable Preact block rendering + reusable landing page content system

## Preact Block Integration
- Enable Preact component detection for data-driven pages:
  - Fix init.html to resolve sections_source + per-section ref before Preact detection
  - Correct resource paths: blox/* → js/hbx/blocks/* (Hugo module mounts)
  - Update libraries.html to load Preact core + compiled block scripts
- Add dynamic icon rendering for Preact components:
  - Create Icon.jsx component with SVG decoding
  - Add get_icon_data.html partial for passing icon strings to Preact props
  - Update preact-wrapper.html to fetch icon data and inject into props
  - Wire hero component to render dynamic icons via <Icon svg={icon_svg} />
- Centralized logging system:
  - Add functions/logger.html to wrap warnf/errorf safely
  - Degrade to HTML comments in constrained contexts (content adapters)

## Reusable Landing Page Content System
- Add sections_source support:
  - Page front matter: sections_source: pages/<key> loads base from data/pages/<key>.yaml
  - Inline sections deep-merge over base by position; extras appended
- Add per-section ref system:
  - Any section: ref: blocks/<slug> loads from data/blocks/<slug>.yaml
  - Inline section properties deep-merge over ref (content/design submaps)
  - Enable content reuse across multiple landing pages
- Create reusable block library:
  - Add test/data/blocks/: hero_basic.yaml, features_basic.yaml
  - Add test/content/linked/index.md demo using refs with overrides
- Add pragmatic deep merge for content/design override handling

## Infrastructure & Schemas
- Update base-block.json schema:
  - Fix gradient structure: flat → nested (gradient.start/end/direction)
  - Fix color structure: string|{light,dark} (matches parse_block_v3.html)
  - Update hero schema to properly extend base via $ref
- Fix Tailwind source path generation:
  - Add tailwind_sources.html with test vs starter site logic
  - scripts/view-test.sh: export HUGO_BLOX_TEST_SITE=true
- Update block directory structure:
  - blox/<name>/config.html (was blox/<name>--CONFIG.html)
  - Apply to init.html + parse_block_v2.html
- Code quality improvements:
  - Biome config: match Prettier rules

## Content Adapters (Removed)
- Investigated Hugo content adapters for landing pages
- Found execution context limitations (early build phase, limited site methods)
- Archived to backups/content-adapters-*.zip and removed from test site
- Decision: use standard pages + data linking instead of adapters

This enables dynamic Preact rendering with proper icon support while providing a flexible, reusable content system for landing pages that maintains the "single file = page" mental model with optional advanced linking.

2025-09-22 22:18:03 +01:00