ananthb/jughead
1
0
Fork 0
mirror of https://github.com/ananthb/jughead.git synced 2026-09-20 16:26:50 +00:00
Code Releases Packages Activity
A Hugo portfolio and blog theme.
258 commits 2 branches 90 tags 35 MiB
  • JavaScript 81.6%
  • CSS 18.1%
  • HTML 0.3%
Find a file
Exact
Ananth Bhaskararaman 36d77ea3d6 Fix template parse error in head.html 
The `if` keyword cannot be used as an expression value in a `:=`
assignment. Use `cond` for the home/non-home title selection instead.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 13:48:54 +05:30
.github/workflows Fix Garnix cache config for Determinate Nix installer 2026-04-04 23:48:42 +05:30
archetypes Differentiate blog and other content better 2025-02-05 03:56:35 +05:30
assets Fix logo+title alignment, update screenshots 2026-04-05 01:06:20 +05:30
exampleSite Add logo+title combo, hideTitle param, rename blog to articles 2026-04-05 00:58:26 +05:30
i18n Remove resume feature, make homepage content-driven 2026-04-04 23:58:03 +05:30
images Fix logo+title alignment, update screenshots 2026-04-05 01:06:20 +05:30
layouts Fix template parse error in head.html 2026-04-26 13:48:54 +05:30
scripts Remove resume feature, make homepage content-driven 2026-04-04 23:58:03 +05:30
static/feather-icons Load feather-icons using only CSS 2024-07-27 13:35:33 +05:30
.envrc New colours and themes 2026-02-08 15:29:17 +05:30
.gitignore fix license 2026-04-05 03:42:13 +05:30
flake.lock Use cachix/git-hooks.nix for pre-commit and garnix for CI 2026-04-04 22:36:25 +05:30
flake.nix Fix garnix CI: exclude vendored assets from pre-commit, fix nix build 2026-04-05 00:01:32 +05:30
go.mod fix calling partials 2025-04-24 11:19:19 +05:30
LICENSE Add LICENSE file 2026-02-09 12:26:25 +05:30
package-lock.json Improve theme design, styling, and HTML semantics 2026-04-04 23:10:39 +05:30
package.json Improve theme design, styling, and HTML semantics 2026-04-04 23:10:39 +05:30
README.md Remove resume feature, make homepage content-driven 2026-04-04 23:58:03 +05:30
theme.toml fix license 2026-04-05 03:42:13 +05:30

README.md

Jughead - Blog Theme for Hugo

Jughead

Jughead is a simple and powerful blog theme for Hugo. It features Giscus comments, Mermaid diagrams, and KaTeX formulae.

screenshot

More screenshots

Home Dark Mobile Mobile Dark

Features

  • Comments powered by giscus.
  • MermaidJS diagrams.
  • KaTeX for rendering math formulae.
  • Reading time indicators.
  • Offline caching with a service worker.
  • Two themes: ink (newspaper/OLED) and earth (rust/slate).
  • Auto light/dark mode with manual override option.
  • i18n support. Translations welcomed!

Installation

Add jughead to your hugo config files in the modules section.

[module]
[[module.imports]]
path = "github.com/ananthb/jughead"

Quickstart

Copy the hugo.toml configuration file from ./exampleSite. Edit parameters as needed.

Themes

Configure your theme in hugo.toml:

[params]
  theme = "ink"        # "ink" or "earth"
  themeMode = "auto"   # "auto", "light", or "dark"

Custom Homepage

By default the homepage shows featured and recent posts. To add custom content above the post listings, create content/_index.md:

---
title: "Home"
---

Welcome to my blog!

Write Posts

Use hugo new posts/my-first-post.md to create a new post. Edit the frontmatter and write your post in markdown. Add a featured category to your post to feature it on the homepage and blog page.

Toggle MermaidJS and KaTeX support in your post frontmatter. Set mermaid to true to enable MermaidJS support, and katex to true to enable KaTeX support.

+++
title = "Diagrams & Equations"
mermaid = true
katex = true
+++

MermaidJS and KaTeX are JavaScript heavy. Enable them when necessary.

License

Fork of archie which is MIT licensed.

This work is dual licensed under the terms of the MIT license for contributions up to January 2026 and under the terms of the GPL 3.0 for later contributions.