Hugo Theme Windy

Simple blog theme for HUGO.

demo: https://zetton86.github.io/hugo_theme_windy/

Screenshot

Features

responsive
dark
table of contents
json-ld
MathJax

Getting Started

Prerequirements

hugo extended >= v0.128.2
Node.js
- cf. Installing Node.js via package manager | Node.js

Create a site with exampleSite

$ git clone https://github.com/zEttOn86/hugo_theme_windy.git
$ cd hugo_theme_windy
$ npm install
$ make dev

Access the following site.

http://localhost:1313/

Customize a site with this theme

$ cd themes
$ git submodule add https://github.com/zEttOn86/hugo_theme_windy.git
$ cd ..
$ npm install themes/hugo_theme_windy
$ cp -r themes/hugo_theme_windy/static \
        themes/hugo_theme_windy/assets \
        themes/hugo_theme_windy/i18n \
        themes/hugo_theme_windy/layouts \
        themes/hugo_theme_windy/exampleSite/config \
        .

Edit the module.mounts section in config/_default/hugo.toml to specify a proper node_modules directory.

Example:

[[module.mounts]]
-    source = '../node_modules/mathjax' # Must specify a proper directory for node_modules.
+    source = 'node_modules/mathjax'
    target = 'assets/mathjax'

Finaly, run the following command to confirm your site

hugo server

Usage (Configuration)

Basic configuration

Please edit the config/_default/hugo.toml to change blog title.

title = 'Hugo Theme Windy'              # To change the blog title.
baseURL = 'https://example.org/'        # To change the base address

copyright = "2024. zEttOn86 - All rights reserved."
languageCode = 'ja-JP'
defaultContentLanguage = "en"
hasCJKLanguage = true
enableInlineShortcodes = true
enableRobotsTXT = true
enableEmoji = true
enableGitInfo = true
theme = "hugo_theme_windy"

...

# Edit the following if you want to enable comment fields by Disqus.
[services]
  [services.disqus]
    shortname = 'your-disqus-shortname'
  [services.googleAnalytics]
    ID = 'G-MEASUREMENT_ID'

[privacy]
    [privacy.googleAnalytics]
      disable = true
...