HugoBlog

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-11View source

What stands out

A quick read of the recorded project description.

01

Heavily customized based on the Hugo theme Blowfish

02

Integrates the Gallery element from Track3's personal blog Zakee's Planet

03

Includes sample gallery content sourced from Track3's blog

04

Repository code is under the MIT license

05

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.

HugoBlog

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. 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. 2

    When switching to a user site or custom domain as the baseURL, revert the above path changes

  3. 3

    Sample gallery content comes from Track3's blog under CC BY-NC 4.0; verify before use

  4. 4

    Repository code is under the MIT license; retain copyright and license notices when distributing

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

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.

Original README
https://github.com/crabcracker/blowfish-with-gallery/blob/main/LICENSEhttps://github.com/crabcracker/blowfish-with-gallery/blob/main/README.md

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

![GitHub repo size](https://img.shields.io/github/repo-size/crabcracker/blowfish-with-gallery?style=flat-square)
[![Powered by](https://img.shields.io/badge/powered%20by-hugo-ff4088?style=flat-square)](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)
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.