Huginn is a minimalist, responsive blog theme for the Hugo static site generator, distributed on GitLab by Vincent Tam, that bundles a baguetteBox.js lightbox, Isso and Staticman comment support, and full-text RSS feeds.
What is Huginn?
Huginn is a Hugo theme that turns Markdown content into a responsive blog. It consumes Hugo site content and produces static HTML pages with light colors, dark syntax highlighting, responsive layout, and integrated JavaScript features. The repository includes the theme's layouts, assets, i18n, exampleSite, and static directories, plus a theme.toml manifest. The theme began as a port of iKevinY's Pelican theme "pneumatic" and was later rewritten for Hugo.
What makes Huginn stand out?
- Responsive design — Uses CSS media queries to adapt the layout to mobile and desktop screens.
- Light color scheme with dark syntax highlighting — Colors are taken from the snow.vim Vim color scheme.
- Hugo built-in integrations — Supports automatic table of contents when posts contain headers, related content links, and RSS feeds with a tweaked layout for full-text rendering.
- baguetteBox.js lightbox — Ships with the JavaScript library and provides a
lightboxshortcode that resizes thumbnails to 256x with quality 80. - Gallery partial — Displays all images placed in
images/galleryinside a page bundle as a thumbnail grid at the end of a post. - Song front-matter — Lets you declare a
songtitle and link in a post's front matter, and the theme displays what you were listening to while writing. - Comment engines — Supports self-hosted Isso via the
isso_serverparameter and Staticman v3 for static comments via merge requests. - Internationalization — Includes an
i18ndirectory for multilingual support.
Who should use Huginn?
- Individual bloggers on Hugo — Writers who want a clean, distraction-free layout for personal posts without pulling in a heavy framework.
- Static site enthusiasts — Developers who prefer static hosting and want comment functionality without a third-party SaaS, using Self-hosted Isso or Staticman.
- Photography/flânerie bloggers — Users who regularly embed images and want the built-in lightbox and gallery partials to arrange them.
What can you do with Huginn?
- Add image galleries — Drop images into
images/galleryinside a page bundle and the gallery partial renders them as thumbnails at the post's end. - Show the song you were listening to — Add a
songblock to front matter with a title and link, and Huginn displays it in the post. - Enable static comments — Set the
isso_serverconfig parameter or run Staticman v3 with the provided setup instructions for GitHub, GitLab, or Framagit. - Make RSS full-text — Use the tweaked RSS template to deliver complete article content to subscribers.
How do I set up Huginn?
To use Huginn, copy the theme into your Hugo site's themes directory, reference its name in your site's config.toml, and optionally configure the isso_server parameter or Staticman integration. To use the lightbox and gallery shortcodes, your posts must be organized as Hugo Page Bundles (introduced in Hugo 0.32) with images under images/lightbox/ or images/gallery/. For Staticman, you need to add the bot to your repository on GitHub, GitLab, or Framagit, create a root-level staticman.yml, and optionally set moderation: false to allow direct commits.
Pros and cons
- Pros — Lightweight with no JavaScript framework; comments can be self-hosted; page bundle shortcodes are simple; full-text RSS.
- Cons — The lightbox and gallery require Hugo Page Bundles and Hugo 0.32+; Staticman setup is multi-step and requires an external bot endpoint; the theme is tailored to the author's needs.
FAQ
Does Huginn require JavaScript for the lightbox?
Yes, the lightbox feature is powered by baguetteBox.js, a small JavaScript library bundled with the theme. Without JavaScript, thumbnails still link to full-size images, but the lightbox overlay won't work.
What comment systems does Huginn support?
Huginn supports both Isso, a self-hosted commenting server configured via the isso_server parameter, and Staticman v3, which turns comments into merge requests on GitHub, GitLab, or Framagit.
Can I change the colors?
The theme's light color palette and dark syntax highlighting come from the snow.vim color scheme. The README does not document a theme customization option for colors, so you would need to edit the stylesheets in assets to change them.
Does Huginn work without Page Bundles?
The basic theme works without Page Bundles, but the lightbox shortcode and the gallery partial explicitly depend on Hugo's Page Bundle feature to resolve image resources, so they will not function with plain static images.
