Hugo Themes

Prev/Next: All Themes

hulga

A simple hugo blog theme based on bulma

  • Author: wlh
  • GitHub Stars: 15
  • Updated: 2023-05-03
  • License: MIT
  • Tags: Blog Dark
Download
hulga

hugo-theme-hulga

hugo + bulma = hulga

Screenshot

build hugoBasicExample without any config of this theme

screenshot

Demo

build hugo site with configs

Demo site

My Blog

Features

  • small & fast
  • basic functions:
    • category list&term pages
    • tag list&term pages
    • archives pages
  • table of contents (TOC) sidebar
  • prefers-color-scheme media support
  • PWA support

Install

  1. clone to hugo site themes folder

    git submodule add https://github.com/wlh320/hugo-theme-hulga.git themes/hulga

  2. enable it in config.toml

    theme = "hulga"

    and then config it.

  3. to use postcss, you should have hugo extended version installed, then copy package.json and postcss.config.js to the root of your site folder, then npm install

  4. If your language is not en or zh-cn, you may need to add i18n files in i18n folder to show some i18n strings in this theme.

  5. Ensure the to put all content in a directory titled “post” for the theme to populate the articles. Ex. content\post

Config

An example of avaliable params:

baseURL = "https://example.com"
languageCode = "zh-cn"
DefaultContentLanguage = "zh-cn"
title = "My New Hugo Site"
paginate = 10
theme = "hulga"

[params]
  # show in HTML meta tag
  author = "xxx"
  keywords = "HTML, hugo, CSS"
  description = "xxx's blog, xxx xx xxxx"

  # change bulma's primary color
  primaryColor = "#1793d0"

  # subtitle on homepage
  subtitle = "This is a subtitle"

  # copyright text on footer
  copyright = "Copyright © 2020 wlh. All rights reserved."

  # enable katex rendering on every post page, default false
  math = false

  # enable postcss, mainly for css purge (129kB->20kB->4.8kB gzipped, but this makes build slower), default false
  postcss = true

  # enable showing content summary below post title in home page, default false
  showSummary = true

  # set paginate on taxonomy term page (tags or categories), default 10
  termPaginate = 3

  # enable toc on every post page, default false
  toc = true

  # enable TOC auto collapse, default false
  autoCollapseToc = true

  # enable prefers-color-scheme:dark, default false
  darkMedia = true

  # enable hero section's is-bold effect, default false
  heroBold = false

  # enable hero section that looks like steam deck's home page, default false
  heroSteamDeck = false

  # enable PWA, prepare your icons and DON'T forget to modify manifest.json, default false
  pwa = true

  # disable jsdelivr cdn, default false
  noCDN = false

# to enable different hightlight themes in light/dark mode 
[markup]
  [markup.highlight]
    noClasses = false

[menu]
  [[menu.main]]
    identifier = "index"
    name = "首页"
    url = "/"
    weight = 1
  [[menu.main]]
    identifier = "archives"
    name = "归档"
    url = "/archives/"
    weight = 2
  [[menu.main]]
    identifier = "about"
    name = "关于"
    url = "/about/"
    weight = 3
  [[menu.main]]
    identifier = "tags"
    name = "标签"
    url = "/tags/"
    weight = 4
  [[menu.main]]
    identifier = "categories"
    name = "类别"
    url = "/categories/"
    weight = 5

[taxonomies]
category = "categories"
tag = "tags"

Acknowledgement

本项目的诞生离不开以下开源项目：

See Also