Hugo Themes
Jughead
Jughead is a minimal and clean theme for hugo with a markdown-ish UI.
- Author: Ananth Bhaskararaman
- GitHub Stars: 0
- Updated: 2024-06-22
- License: MIT
- Tags: Blog Minimal Personal Responsive
Jughead - A Hugo theme
Jughead is a minimal and clean theme for hugo with a markdown-ish UI.
Demo
Features
- Auto Dark Mode (based on system theme)
- GitHub Issues based comments powered by utterances
- Mermaid diagrams support
- MathJax and KaTeX support
Installation
Add jughead to your hugo config files in the modules section.
[module]
[[module.imports]]
path = 'github.com/ananthb/jughead'
For more information read the official setup guide.
Writing Posts
Create a new .md
file in the content/posts folder
---
title: Title of the post
description:
date:
tldr: (optional)
draft: true/false (optional)
tags: [tag names] (optional)
---
Add mermaid = true
to the front matter to enable mermaid diagrams.
Embed mermaid diagrams using the mermaid shortcode.
{{< mermaid >}}
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
{{< /mermaid >}}
Config Options
Custom CSS
Include your own styles by setting the customcss
config param to
a list of css files located in the assets
directory e.g. assets/css/custom.css
.
[params]
customcss = ["css/first.css", "css/second.css"]
Sample Config
baseURL = "https://ananthb.github.io/jughead/"
languageCode = "en-in"
title = "Jughead"
copyright = "© Your Name Here"
paginate = 3
# Code Highlight
pygmentsstyle = "monokai"
pygmentscodefences = true
pygmentscodefencesguesssyntax = true
[params]
mode = "auto" # color-mode → light,dark,toggle or auto
useCDN = false # don't use CDNs for fonts and icons, instead serve them locally.
subtitle = "Minimal and Clean [blog theme for Hugo](https://github.com/ananthb/jughead)"
mathjax = true # enable MathJax support
katex = true # enable KaTeX support
# Social Tags
[[params.social]]
name = "GitHub"
icon = "github"
url = "https://github.com/ananthb/jughead"
[[params.social]]
name = "Twitter"
icon = "twitter"
url = "https://twitter.com/your-name-here/"
[[params.social]]
name = "GitLab"
icon = "gitlab"
url = "https://gitlab.com/ananthb/"
# Main menu Items
[[menu.main]]
name = "Home"
url = "/"
weight = 1
[[menu.main]]
name = "Posts"
url = "/posts"
weight = 2
[[menu.main]]
name = "About"
url = "/about"
weight = 3
[[menu.main]]
name = "Tags"
url = "/tags"
weight = 4
License
Fork of archie which is a fork of Ezhil. Inspired by blog.jse.li.
Jughead is available under the terms of the MIT License.