HugoTool Site

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.

1 previews
Author preview
Author-provided previewTop of page

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.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Blue-and-white Hugo theme with screenshots of list and article pages included in the repository

02

Configure site title, language, Google Analytics, and Disqus via config.toml

03

Optional author block supporting display of name and twitter, linkedin, github, and tumblr accounts

04

Optional share buttons covering twitter, facebook, tumblr, google, and pocket, with hatena reserved

05

Optional Google AdSense support, inserting sidebar and content ads via custom templates under layouts/partials

06

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.

HugoTool 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. 1

    Run mkdir themes in the project root and enter that directory, then clone the repository as hugo-theme-geppaku

  2. 2

    Set theme = "hugo-theme-geppaku" in config.toml, and fill in baseurl, languageCode, title, and other basic items as needed

  3. 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. 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. 5

    Create articles as Markdown files via hugo new post/...; front matter can use fields such as date, draft, title, slug, categories, and tags

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

googleAnalytics = "" disqusShortname = ""

Original README
https://github.com/masa0221/hugo-theme-geppaku/blob/master/LICENSE.mdhttps://github.com/masa0221/hugo-theme-geppaku/blob/master/README.md

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 / repository
Geppaku
=============================
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
![list](https://github.com/masa0221/hugo-theme-geppaku/blob/master/images/list.png)

### Post page
![post](https://github.com/masa0221/hugo-theme-geppaku/blob/master/images/screenshot.png)

## 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)
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.