~bandali/hugo-theme-divine

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

You can also use your local clone with git send-email.

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 ThemeScreenshot

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.