blog/content/posts/hugo.md
2021-09-11 00:43:01 -07:00

57 lines
2.2 KiB
Markdown

---
title: Building my Blog with Hugo
description: Why I'm switching away from simple bash scripts
category: article
draft: false
date: 2021-09-10
---
For a while now I've been using `pandoc` and a combination of shell scripts to build and deploy my site via a gitlab CI/CD pipeline.
Given that I want to start sharing my site to more people I realized I need a way to generate some meta data for each page.
In order to this I have to somehow:
* Tag each page with meta data that other sites can look at
* Make sure the build system is aware of this new meta-data
Inserting meta data into posts and page source code isn't too hard but there is the problem of standardizing a format which meets my criteria of:
* Easy to write
* Easy to parse
* Preferably not verbose to keep things small
* As robust as possible
That last one is the part that makes this really hard to implement if I'm being honest.
Yes I could come up with a format and use something like `sed` or `awk` to replace markdown with inline HTML and do some wizardy on the compilation script to `cat` partial html files together properly but...
After having already done similar things for other projects I know exactly how painful that can be, especially to do it well.
## Why Hugo
1. Instant support for yaml meta data in each markdown file
2. Pages are built out of go-templates with javascript
3. Templates
It's literally just the templates.
The fact is I have two templates that I care about right now: `posts` and `index`.
> What about styling and making sure you don't lose the charm of the site?
I can literally re-use the same style sheet from before with Hugo and fonts can also stay where they are.
No Javascript is ever compiled and sent to the browser.
> What build advantages do you get from this?
Robustness. I can build out tons of pages in reasonable amounts of time with no mysterious errors and have a ton of flexibility when it comes to adapting templates to be something new.
> Aren't you locked into a single theme this way?
Yes but most people's themes send a ton of Javascript which I don't want to do ever
> Can I see what the theme looks like?
Sure: [click here for the theme](https://gitlab.com/shockrah/shockrah-city/-/tree/master/themes/shockrah.xyz)