wompmacho/hugo-framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

updating background and logic for new background setting.

Browse Source
This commit is contained in:
Michael
2026-06-07 15:01:17 +00:00
Unverified
parent af4b69db1b
commit 711ddfb3d1
7 changed files with 9687 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
README.md
View File

@@ -49,6 +49,15 @@ The Blowfish theme is fully **decoupled/vendored** into this project's root fold
* No theme submodules are used, protecting the site from upstream updates breaking the build.
* Custom styling and layouts can be edited directly in the root directories.
### Global Background Injection
The framework injects a diffused global background image natively into `layouts/_default/baseof.html` using a conditional logic block directly in the body template.
- It pulls the image source from `defaultBackgroundImage` in `config/_default/params.toml`.
- It dynamically applies a `has-global-bg` CSS class to the `<body>` element. This class forces the standard Blowfish solid background colors to become transparent (handled in `assets/css/custom.css`), allowing the background div to show through.
- **Bypass Logic**: The template logic automatically bypasses rendering the global background if the page is explicitly configured to use the Blowfish `background` or `hero` layouts (e.g. `layout = "background"` on the homepage or `heroStyle = "background"` on an article). This ensures the framework's native full-page feature images are never broken or layered incorrectly.
- The global background mimics the exact structure of the native homepage `background` layout, utilizing a `h-[1000px]` fixed height container with `object-cover` and honoring the `imagePosition` parameter from `params.toml` for pixel-perfect consistency.
- Project cards (using `layout: card`) have their styling overridden in `assets/css/custom.css` to use a darker, semi-transparent "dark web" palette to contrast nicely with the diffused background.
---
## 🚀 CI/CD Pipeline & Deployment