Blue-and-white Hugo theme with screenshots of list and article pages included in the repository
hugo-theme-geppaku — Hugo Tool Template
By masa0221
hugo-theme-geppaku is a blue-and-white theme for the Hugo static website generator, developed by masa0221 and released under the MIT license. It supports optional configuration for author information, social share buttons, and Google AdSense.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Configure site title, language, Google Analytics, and Disqus via config.toml
Optional author block supporting display of name and twitter, linkedin, github, and tumblr accounts
Optional share buttons covering twitter, facebook, tumblr, google, and pocket, with hatena reserved
Optional Google AdSense support, inserting sidebar and content ads via custom templates under layouts/partials
Includes an exampleSite for reference on configuration and content structure
Template Details
Geppaku is a theme for the Hugo static website generator, described by its author in the README as having a "blue-and-white color scheme." The repository provides screenshots of the list page and article page, along with an exampleSite for reference on configuration and content organization.
Installation involves creating a themes directory in the project root, cloning the repository as hugo-theme-geppaku, and then specifying the theme in the site configuration. The configuration example is based on config.toml and includes basic items such as baseurl, languageCode, title, googleAnalytics, and disqusShortname, as well as two optional blocks: author and params.
The author block is used to display author information, where you can fill in name and account IDs for twitter, linkedin, github, and tumblr. Under params, there are two configuration groups: sharebutton and adsense. sharebutton allows toggling share buttons for twitter, facebook, tumblr, google, and pocket individually, with a commented-out hatena (a Japanese social service); enabling facebook requires providing a facebookAppId. adsense inserts ad code into the sidebar and main content by specifying template file paths under layouts/partials. The README states that these are all optional parameters and should be removed if not needed.
For content, articles are created as Markdown files, with front matter examples including fields such as date, draft, title, slug, categories, and tags. The README does not describe the theme's responsive behavior, browser compatibility, or performance; these aspects need to be verified by reviewing the source code and example site.
Is it right for your project?
Use Cases
- Building a blog site with Hugo that primarily features article lists and article details
- Sites that need to provide social share buttons on article pages
- Sites that want to integrate Google Analytics, Disqus, or Google AdSense through configuration files
- Projects looking to reference Hugo theme configuration and example site structure for further modification
Suitable For
- Developers using the Hugo static website generator
- Bloggers who prefer a blue-and-white color scheme and a clean article list and detail layout
- Users who need to freely modify and distribute the theme code under the MIT license
- Developers who want to adjust configuration and templates based on the example site
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Run mkdir themes in the project root and enter that directory, then clone the repository as hugo-theme-geppaku
- 2
Set theme = "hugo-theme-geppaku" in config.toml, and fill in baseurl, languageCode, title, and other basic items as needed
- 3
The author block and the sharebutton and adsense groups under params are all optional; remove parameters you do not need. Enabling facebook sharing requires providing a facebookAppId
- 4
To use AdSense, first write the ad tags into the layouts/partials directory, then specify the file path without that directory prefix in the configuration
- 5
Create articles as Markdown files via hugo new post/...; front matter can use fields such as date, draft, title, slug, categories, and tags
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version available in the public repository under the MIT license; 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
- You are allowed to use, modify, use commercially, and distribute this version's code for free.
- 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 limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Enabling the Facebook share button requires providing your own Facebook App ID (facebookAppId), which depends on external Facebook services and account configuration.
- Using Google AdSense ad slots requires creating and writing the AdSense tag template file yourself, and depends on external Google AdSense services and an account.
- If you need site analytics or comments, you must fill in your own Google Analytics and Disqus account identifiers, which are external third-party services.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
- External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Please set id when you want to display facebook facebookAppId = "your app id"
Original README
# 1. Create file written of the adsense tag into the directory "layouts/partials"
Original README
https://github.com/masa0221/hugo-theme-geppaku/blob/master/LICENSE.mdhttps://github.com/masa0221/hugo-theme-geppaku/blob/master/README.mdgoogleAnalytics = "" disqusShortname = ""
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. 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 · 72 / 100
- Technologies
- Hugo
- Website type
- Tool Site
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
- 2022-02-01
- Screenshot last checked
- 2026-10-02
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.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 8e61a23d29b59b6f450f23a358303eaf29eebc8725e14c9b040fd51e5741366d
2026-10-02T08:06:32.702Z
Source file / repositoryGeppaku
=============================
Geppaku is bluish white theme for [Hugo](http://gohugo.io/).
Note that it is not in the "Seppuku".
I'm not Samurai.
Please check [http://2626.info/](http://2626.info/), if you are interested in this theme.
## Screenshot
### Index page

### Post page

## Installation
```
$ mkdir themes
$ cd themes
$ git clone https://github.com/masa0221/hugo-theme-geppaku hugo-theme-geppaku
```
See the Hugo documentation for more information.
## Config
Example of config.toml file:
```toml
baseurl = "http://your-site-here/"
languageCode = "en-us"
title = "your site title"
theme= "hugo-theme-geppaku"
googleAnalytics = ""
disqusShortname = ""
[author]
# If you want to display author information set these
# This is Optional values
name = "Your name"
# Please set account ids
# This is Optional values
twitter = "your twitter id"
linkedin = "your linkedin id"
github = "your github id"
tumblr = "your tumblr id"
[params]
[params.sharebutton]
# If you want to display share buttons set these
# This is Optional values
twitter = true
facebook = true
tumblr = true
# hatena = true # hatena is Japanese social media
google = true
pocket = true
# Please set id when you want to display facebook
facebookAppId = "your app id"
[params.adsense]
# If you want to display Google adsense set these
# This is Optional values
# 1. Create file written of the adsense tag into the directory "layouts/partials"
# 2. Please set file path name omitted "layouts/partials"
sidebar = "adsense/sidebar.html"
content = "adsense/content.html"
```
You can delete optional parameter.
Please delete unnecessary parameter.
### Post
Create markdown file:
```sh
hugo new post/2016/05/hello-hugo.md
```
Example of the markdown file:
```md
+++
date = "2016-04-30T16:44:45+09:00"
draft = false
title = "Hello Hugo!"
slug = "hello-hugo"
categories = ["tech"]
tags = [
"hugo",
"golang",
]
+++
Hello Hugo!
```
### Example
Please check sample.
[https://github.com/masa0221/hugo-theme-geppaku/tree/master/exampleSite](
https://github.com/masa0221/hugo-theme-geppaku/tree/master/exampleSite)
Explore similar templates
Compare previews and descriptions within the same stack and category.

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

doks
Doks is a Hugo documentation theme in the Thulite ecosystem, built for long-form reading with a minimal responsive layout and documentation-optimized typography. It includes FlexSearch-powered configurable search, dark/light mode, code syntax highlighting, i18n, multi-version documentation management, and blog pages.
Hugo · Tool Site

hugo-theme-introduction
Introduction is a minimal Hugo theme that can be configured as a single-page site or a full site with multiple sections. Homepage sections are generated from Markdown files under content/home/, with weight sorting and optional images.
Hugo · Portfolio

lotusdocs
Lotus Docs is a free, MIT-licensed Hugo documentation theme by Colin Wilson, built on Bootstrap 5. It provides responsive documentation layouts, dark mode, i18n, FlexSearch-based static search, Prism.js highlighting, KaTeX, Mermaid, and landing page templates.
Hugo · Documentation

airspace-hugo
Airspace is a multipurpose Hugo theme by Themefisher for portfolio, blog, and business sites.
Hugo · Portfolio

kross-hugo
Kross is a Hugo personal portfolio theme by Themefisher, offering more than 8 pre-built pages including home, about, blog, portfolio, and contact.
Hugo · Portfolio
