A simple black theme for Hugo with KaTeX & mermaid support.
-
Create a new Hugo site (or use existing):
hugo new site my-site cd my-site -
Install the theme using Git submodule:
git init git submodule add https://github.com/Enerhim/enervoid-theme.git themes/enervoid
Or clone it directly:
git clone https://github.com/Enerhim/enervoid-theme.git themes/enervoid
-
Configure your site — Copy the example configuration:
cp themes/enervoid/example/hugo.toml ./hugo.toml
-
Start Hugo server:
hugo server -D
-
Visit
http://localhost:1313in your browser.
The default hugo.toml configuration file:
baseURL = 'https://example.com'
languageCode = 'en-us'
title = "Your Name"
theme = "enervoid"
[menus]
[[menus.main]]
name = 'Blog'
pageRef = '/blog'
weight = 10
[[menus.main]]
name = 'Personal'
pageRef = '/personal'
weight = 20
[[menus.main]]
name = 'Projects'
pageRef = '/projects'
weight = 30
[params]
avatar = "https://picsum.photos/200"
[[params.socials]]
link = "https://github.com/yourgithub"
icon = "devicon-github-original"
[[params.socials]]
link = "https://twitter.com/yourx"
icon = "devicon-twitter-original"
[[params.socials]]
link = "https://linkedin.in/yourlinkedin"
icon = "devicon-linkedin-plain"
[[params.socials]]
link = "https://itch.io/profile/youritch"
icon = "fa-brands fa-itch-io"
[markup]
[markup.goldmark]
[markup.goldmark.extensions.passthrough]
enable = true
[markup.goldmark.extensions.passthrough.delimiters]
block = [['$$','$$'], ['\\[','\\]']]
inline = [['$','$'], ['\\(','\\)']]
[markup.goldmark.parser]
[markup.goldmark.parser.attribute]
block = true
[markup.highlight]
noClasses = true
codeFences = true
guessSyntax = true
tabWidth = 4
style = "monokai"For markdown configuration,
- For katex/ math, see math.md
- For formatting, see formats.md
- For images and embeds, see embeds.md
- For code and mermaid, see code.md
Blog Post:
hugo new blog/my-first-post.md+++
title = "My first post"
date = 2024-03-22T14:45:30Z
tags = ["Your", "Tags"]
description = "Your description."
+++
Your content here...Note: Creating a personal post is identical to blog post. Just do
hugo new personal/my-personal-post.mdProject:
hugo new projects/my-project.md+++
title = "My first project"
date = 2024-03-22T14:45:30Z
tags = ["Your", "Project"]
summary = "Your project summary."
github= "Your Github"
website= "Or your website"
link= "Or any other link"
+++
Fallback contentThis theme is released under the MIT License. See LICENSE for details.
