Hugo Generator

User Guide

Public user guide for authoring websites with the QuantaLumin Hugo generator.

Mental Model

Developer mental model for the shared Hugo generator.

System Map

Architecture overview for the QuantaLumin generator.

Template Shell

The base template shell, page templates, main body, and list-page behavior.

Page Chrome

Header, chrome contracts, aside panels, and shared page frame behavior.

Section Rendering

How authored Markdown sections become contracted section DOM.

Render Hooks

Goldmark render hooks, codeblock renderers, and the preprocess layer.

Media and Figures

Figure wrappers, media dispatch, resource lookup, and workspace media handling.

References and Print Metadata

Citations, references, object labels, and data-ql-print metadata.

Runtime Imports

Head imports, CDN asset policy, runtime order, and editor injection.

Partial Docstrings

Rendering Hugo template comment docstrings into the docs site.

Partial Index

Generated reference inventory for documented Hugo partials.

Shortcodes

Authored shortcode and structured block contracts.

Adding a Structured Block

Recipe for adding a shortcode, fenced structured block, runtime, docs, and tests.

Site Archetypes

Shared site archetype contract and intended use.

Hugo CMS Roadmap

Roadmap for schema-driven Hugo CMS editing.

Hugo Blog Workspaces

Workspace-backed Hugo blog contract.

Website Service Integration Contract

Service integration boundaries for Hugo websites.

Shop Section Contract

Shop and storefront Hugo section contract.

Build Internationalization

Build-time i18n behavior and commands.

TutorLumin Workspaces

TutorLumin workspace integration notes.