gmdias727 / hugo-dead-simple

Dead simple Hugo theme.

Hugo Dead Simple

Simple hugo theme to be dead easy on the reader.

Features

• Light and dark themes
• Simple non-intrusive menu
• Dynamic wiki-style table of contents
• Code blocks with highlight
• Katex math (inline and block)
• Info boxes

Example site and overview of features.

Page parameters

title: "Post/Page title"
date: "2023-08-11"
toc: true # table of contents
bold: true # display post title in bold in posts list
math: true # load katex
categories:
  - ...
tags:
  - ...
next: true ## show link to next post in footer

Install

• Initialize go module

  hugo mod init

• Add theme to your config.yml

  module:
    imports:
      - path: github.com/barklan/hugo-dead-simple

• Fetch theme

  hugo mod get -u

Extra stuff

• Add favicon.ico to /static

• Deploy your site to Netlify with this netlify.toml

  [build]
  publish = "public"
  command = "hugo --gc --minify"
  
  [context.production]
  environment = { HUGO_VERSION = "0.111.3" }

Recommended markup settings:

markup:
  highlight:
    codeFences: true
    style: bw
    lineNumbersInTable: false
    noClasses: false
  goldmark:
    renderer:
      unsafe: true