mirror of
https://github.com/tiennm99/HugoBlox-kit.git
synced 2026-10-05 02:13:24 +00:00
The previous section_break implementation used CSS mask-image, which incidentally established a stacking context on the section. Replacing it with a gradient overlay div removed that side-effect — and broke the visual depth on every section with a gradient mesh or radial background. Without a stacking context, the section's negative-z-index descendants (home-section-bg at z:-1 carrying the radial gradient, and the gradient_mesh wrapper at z:-10 carrying the orbs) escaped the section and painted behind the page root, where they were occluded by the page body — flat dark hero, no glow, no orbs. Add `isolate` (isolation: isolate) to the section element. This is the no-visual-side-effect way to force a stacking context, restoring containment of the negative-z layers without affecting siblings or content.
HugoBlox Kit Modules
Install HugoBlox features as Hugo Modules.
Quick start (most sites)
Add HugoBlox Kit core to config/_default/module.yaml (or hugo.yaml):
module:
imports:
- path: github.com/HugoBlox/kit/modules/blox
That’s it — analytics is already included when you use modules/blox.
Module map
- Core framework:
github.com/HugoBlox/kit/modules/blox- Layouts, blocks (Blox), Tailwind pipeline, shortcodes, defaults
- Includes:
github.com/HugoBlox/kit/modules/analytics
- Slides (content type):
github.com/HugoBlox/kit/modules/slides- Markdown slide decks (powered by Reveal.js)
- Integrations:
github.com/HugoBlox/kit/modules/integrations/*- Netlify:
github.com/HugoBlox/kit/modules/integrations/netlify
- Netlify:
Optional installs
Slides
module:
imports:
- path: github.com/HugoBlox/kit/modules/blox
- path: github.com/HugoBlox/kit/modules/slides
Netlify integration (security headers + redirects outputs)
module:
imports:
- path: github.com/HugoBlox/kit/modules/blox
- path: github.com/HugoBlox/kit/modules/integrations/netlify
Then enable Hugo outputs for Netlify:
outputs:
home: [HTML, RSS, headers, redirects]
Updating
hugo mod get -u github.com/HugoBlox/kit/modules/blox@main
hugo mod tidy