Heavily customized based on the Hugo theme Blowfish
blowfish-with-gallery — Hugo Blog Template
By crabcracker
A deeply customized version based on the Hugo theme Blowfish, adding a Gallery component from Track3's personal blog, suitable for building a Hugo blog with an image gallery.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Integrates the Gallery element from Track3's personal blog Zakee's Planet
Includes sample gallery content sourced from Track3's blog
Repository code is under the MIT license
README documents how to handle gallery thumbnail path issues under GitHub Pages project sites
Template Details
This is a Hugo blog theme template. The repository description states that it is heavily customized based on the Hugo theme Blowfish and integrates the Gallery element from Track3's personal blog Zakee's Planet. As a result, it combines Blowfish's blog page structure with a gallery homepage centered on image thumbnails.
The template includes sample gallery content sourced from Track3's personal blog under a CC BY-NC 4.0 license; the repository code itself is under the MIT license. The README specifically notes a deployment limitation: when the Hugo blog's baseURL uses the GitHub Pages project site form (https://<username>.github.io/<repository>), the gallery homepage thumbnails will not display correctly due to incorrect paths. The repository's temporary workaround is to prepend the repository name to each preview image's file link in Gallery/photo folder/index.md, for example changing /gallery/2020-06-20/DSCF2839_t.webp to /blowfish-with-gallery/gallery/2020-06-20/DSCF2839_t.webp; if switching to the user site form (https://<username>.github.io) or a custom domain as the baseURL, the above change must be reverted.
The README's acknowledgments section lists three sources: nunocoracao/blowfish, Track3/blog, and lxgw/LxgwWenKai. The repository does not provide further information about configuration options, feature scope, or maintenance status.
Is it right for your project?
Use Cases
- Building a Hugo personal blog with an image gallery page
- Experimenting with gallery component customization on top of the Blowfish theme
- Hosting a Hugo blog on GitHub Pages and displaying image thumbnails
Suitable For
- Bloggers using Hugo
- Personal sites needing an image gallery page
- Deployers willing to adjust image paths as instructed in the README
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
When using a GitHub Pages project site as the baseURL, prepend the repository name to each preview image link in Gallery/photo folder/index.md
- 2
When switching to a user site or custom domain as the baseURL, revert the above path changes
- 3
Sample gallery content comes from Track3's blog under CC BY-NC 4.0; verify before use
- 4
Repository code is under the MIT license; retain copyright and license notices when distributing
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in a public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and liability limitations are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; the code's MIT license alone is not sufficient to determine this.
- External services such as domains, hosting, databases, payments, or AI may incur additional fees.
- The Gallery sample album content included in the repository comes from Track3's personal blog under CC BY-NC 4.0, which is limited to non-commercial use; for commercial use, you must replace it or obtain separate authorization. This license differs from the repository code's MIT license.
- When the Hugo blog's baseURL uses the GitHub Pages project site form (https://<username>.github.io/<repository>), the gallery homepage thumbnails will not display correctly due to incorrect paths; manually adjust the image links as instructed in the README.
- If switching to the GitHub Pages user site form (https://<username>.github.io) or a custom domain as the baseURL, you must revert the aforementioned change of prepending the repository name to preview image links; otherwise, the paths will also be incorrect.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
The sample content in the Gallery comes from Track3's personal blog [Zakee's Planet](https://github.com/Track3/blog), which is licensed under the Creative Commons BY-NC 4.0 license.
Original README
When using the GitHub Pages link `https://<username>.github.io/<repository>` in the form of a project site as the baseURL for a Hugo blog, the thumbnail images on the Gallery homepage cannot be displayed properly due to incorrect paths.
Original README
https://github.com/crabcracker/blowfish-with-gallery/blob/main/LICENSEhttps://github.com/crabcracker/blowfish-with-gallery/blob/main/README.mdIf you use user site format of GitHub Pages link `https://<username>.github.io`, or custom domain as baseURL for your Hugo blog, you need to reverse the aforementioned changes.
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-11. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 65 / 100
- Technologies
- Hugo
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2023-03-31
- Screenshot last checked
- 2026-10-11
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-13
Inspect the recorded source material
SHA-256: 4865de66aa9844304e681ef825a98669e204668ad4a02f03b19901ee0a886f08
2026-10-11T21:35:24.265Z
Source file / repository# blowfish-with-gallery  [](https://gohugo.io) A radically customized version of Hugo theme [blowfish](https://github.com/nunocoracao/blowfish), incorporating the Gallery element from [Track3](https://github.com/Track3)’s personal blog [Zakee's Planet](https://github.com/Track3/blog). ## Notice When using the GitHub Pages link `https://<username>.github.io/<repository>` in the form of a project site as the baseURL for a Hugo blog, the thumbnail images on the Gallery homepage cannot be displayed properly due to incorrect paths. The temporary solution adopted by this repository is to add the repository name before the file link of each preview image in `Gallery/photo folder/index.md`, such as changing `/gallery/2020-06-20/DSCF2839_t.webp` to `/blowfish-with-gallery/gallery/2020-06-20/DSCF2839_t.webp`. If you use user site format of GitHub Pages link `https://<username>.github.io`, or custom domain as baseURL for your Hugo blog, you need to reverse the aforementioned changes. The sample content in the Gallery comes from Track3's personal blog [Zakee's Planet](https://github.com/Track3/blog), which is licensed under the Creative Commons BY-NC 4.0 license. ## Thanks - [nunocoracao/blowfish](https://github.com/nunocoracao/blowfish) - [Track3/blog](https://github.com/Track3/blog) - [lxgw/LxgwWenKai](https://github.com/lxgw/LxgwWenKai)
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
