divine theme for Hugo
remove right margin from .picture__avatar
format git commit hash link for cgit
fix the recently-broken commit address in footer

refs

master
browse log

clone

read-only
https://git.sr.ht/~bandali/hugo-theme-divine
read/write
git@git.sr.ht:~bandali/hugo-theme-divine

The divine theme for Hugo is a clean and minimalist theme, based off of the hugo-bare-min-theme.

Theme components

This theme is composed of the base theme hugo-theme-divine, and the hugo-debugprint component.

To use this theme, you need to clone this theme and the component(s) too:

cd HUGO_SITE_DIR/themes
git clone https://git.sr.ht/~aminb/hugo-theme-divine
git clone https://github.com/kaushalmodi/hugo-search-fuse-js
git clone https://github.com/kaushalmodi/hugo-debugprint

Do not change the cloned repo directory names.

Theme Concept

It was designed to:

  • Get rid of all visual clutter and be minimalistic
  • Allow easily seeing debug information (debugprint.html partial) while developing Hugo sites, where focus stays on content development.

Screenshots

Bare Min Theme
Screenshot

TODO: add screenshots of divine

Examples

This theme is being used by:

  1. the author's personal website, aminb.org.
  2. your site! (feel free to reach out to me if you use divine and like your site listed here.

Configuration options

These theme provides few customization hooks.

# In the site's config.toml

[Params]
  description = "Description of the site."

  intro = """
Text here is added to the header of each page.

This can contain <b>HTML</b> and/or **Markdown**
and can be multiple lines.
"""
  footer = """
Text here is added to the footer of each page.

This can contain <b>HTML</b> and/or **Markdown**
and can be multiple lines.
"""

  # Custom favicon HTML
  favicon = """
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/manifest.json">
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#5bbad5">
<meta name="theme-color" content="#ffffff">
"""

  custom_css = ["css/style.css"]  # assuming that you have the "static/css/style.css" file

  [Params.source]
    url = "https://your/site/repo/url"   # Needed if you want to see .GitInfo for a page
    md_dir = "content"                   # Needed if you want to get a link to Markdown source for each page
    org_dir = "content-org"              # Needed if you want to get a link to the Org source (e.g. when using ox-hugo!)

Note: It is mandatory to set .Site.Params.source.url if you set .Site.Params.source.md_dir or .Site.Params.source.org_dir.

See the Params section in the config.toml of this theme's exampleSite to get an example.