Hugo Themes
hugo-theme-hulga
hugo + bulma = hulga
Screenshot
build hugoBasicExample
without any config of this theme
Demo
build hugo site with configs
Features
- small & fast
- basic functions:
- category list&term pages
- tag list&term pages
- archives pages
- TOC sidebar
prefers-color-scheme
media support- PWA support
Install
clone to hugo site themes folder
git submodule add https://github.com/wlh320/hugo-theme-hulga.git themes/hulga
enable it in
config.toml
theme = "hulga"
and then config it.
to use
postcss
, you should have hugo extended version installed, then copypackage.json
andpostcss.config.js
to the root of your site folder, thennpm install
If your language is not
en
orzh-cn
, you may need to add i18n files in i18n folder to show some i18n strings in this theme.
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
math = true
# enable postcss, mainly for css purge (129kB->20kB->4.8kB gzipped, but this makes build slower)
postcss = true
# enable toc on every post page
toc = true
# enable TOC auto collapse
autoCollapseToc = true
# enable prefers-color-scheme:dark
darkMedia = true
# enable hero section's is-bold effect
heroBold = true
# enable PWA, prepare your icons and DON'T forget to modify manifest.json
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
[taxonomies]
category = "categories"
tag = "tags"
Acknowledgement
本项目的诞生离不开以下开源项目:
- hugo 静态页面生成
- bulma CSS框架
- bulmaswatch 借用了其中的 dark 主题
- purgecss cssnano 缩减CSS文件大小
- katex $\LaTeX$ 公式渲染
- anchorjs 添加锚链
- tocbot 生成目录
- vanilla-back-to-top 回到顶部 (好懒,这都不自己写)