Theme introduction#
Helloblog is a Hugo theme built for personal writing. Visually it is glassmorphism with soft gradients; functionally it ships the pieces a blog usually needs: light and dark modes, bilingual content, local search, table of contents, reading progress, syntax highlighting, writing components, comments and analytics. There is no front-end build step — a single hugo command produces the whole site.
Content first: typography, TOC and search are resolved at build time, so the first paint is complete HTML that does not depend on scripts.
Features#
| Area | What you get |
|---|---|
| Appearance | Glassmorphism, five palettes, light/dark toggle, custom background and avatar |
| Reading | Table of contents, reading progress, prev/next, related posts, archive and tags |
| Content | Bilingual content, RSS, Open Graph, Sitemap, robots.txt |
| Writing | Admonitions, details, tabs, code groups, steps, timeline, file tree, flow, Q&A, compare, quote |
| Code | Chroma highlighting, terminal block, diff, mermaid |
| Interaction | Local search, giscus comments, sharing, back to top, music player |
| Analytics | Page views and a homepage activity heatmap |
Writing components#
Every component renders to HTML at build time; only browser-dependent features ship a small script. Admonitions come in four semantic levels with an optional custom title:
tip / info / warning / danger map to different meanings; without a title the theme falls back to its localized default label.
Tabs are handy when several angles of one topic sit side by side:
Write content in Markdown and let the theme handle typography.
Theme options live under [params] in hugo.toml.
The output is plain static files — host it anywhere.
Adding a post always follows the same path:
Quick start#
The theme requires Hugo 0.146.0 or later and does not need Node.js; CSS and JS are compiled by Hugo Pipes.
See the configuration guide for every option, the minimum setup and common pitfalls.
Directory layout#
- content
- postsPosts, organized by directory
- theme-introduction
- index.mdChinese content
- index.en.mdEnglish translation
- config-guideConfiguration docs
- theme-introduction
- aboutAbout page
- linkLinks page
- postsPosts, organized by directory
- data
- link.jsonFriend links data
- music.jsonPlaylist data
License and feedback#
The theme is open source under the MIT license. Issues and pull requests are welcome.