published-date: 05 Feb 2023 15:10 +0700

categories: hugo-theme-update

tags: static-site-generator html

Woah

Now you can use slug theme I made solely for this blog. Link to github repo. Although the more I think about how I structured this theme, the less I’m willing to put this into hugo marketplace. Thus as for now installation can be done by either:

1. Cloning this repository into ./themes subfolder
2. Wait until I change my mind.

As a whole this theme is quite a bit of a mess. For example there are few additional frontmatter options available in the archetypes, which were a side effects of having trouble automating mathjax and katex import (which as told by many other how-to hugo blog, just does not seem to work in my case). So there will be some deviation to a standard frontmatter and archetypes compared to other public theme in the marketplace, which could introduce to some difficulty in content migration if you decided to switch theme.

Addendum

This is my truncated config.toml you can use as reference.

baseURL = 'http://your-site-url/'
languageCode = 'en-us'
title = 'title'
theme = 'hugo-slug'
summaryLength = 20


[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true

  [markup.highlight]
    anchorLineNos = false
    codeFences = true
    guessSyntax = false
    hl_Lines = ''
    hl_inline = false
    lineAnchors = ''
    lineNoStart = 1
    lineNos = true
    lineNumbersInTable = false
    noClasses = false
    noHl = false
    style = 'onedark'
    tabWidth = 8

Since the theme itself is going to be updated irregularly I’ve made a simple shell to install and/or update the theme.

#!/bin/bash
rm -rf ./themes/hugo-slug
git clone https://github.com/previoip/hugo-slug ./themes/hugo-slug

Save it as update-theme.sh for example.