moving to Zola
After using hugo for a couple of years for this, I recently switched
to zola, basically because I found hugo to be incredibly confusing
and to require a lot of complexity I don't care about. I just want to
render some markdown files and scrape some of them to generate ATOM
and RSS feeds, more or less.
The process I want through to do this was:
-
be annoyed for two years.
-
play around with
zolafor ten minutes and decide it's nice. -
spend a couple of evenings writing yet more Go code to read in
hugomarkdown files, and write them out again with the frontmatter converted fromhugo's fairly sloppy-tolerantyamlformat tozola's more stringenttoml. -
add a basic
zolaconfig file. -
run the converter.
-
get a bunch of errors from
zolaabout quite legit things, like nonsense timestamps on sections, revert the changes from the converter and fix them in the originalhugomarkdown files. -
repeat several times.
-
run the converter and get no errors.
-
look at the warnings.
-
fix the language on a bunch of code fence blocks, e.g.
nginx->conf, with commands like:(cd content && fd --glob '*.md' --type file --exec sd '```nginx' '```conf')(edit: *I spent fiveminutes trying to get the backticks to work in both markdown and sh and have now given up*).
-
add
sort_by="date"to some sections, since the default is ... not that. -
realise I'd fucked up the trailing newline in every file and fix that (and fix it in the converter, too).
-
port over my shortcodes, which was very easy, then rewrite the uses of them by hand (there were only a few).
-
add some missing redirects, they go the opposite direction in
zola- a page can declare aliases, whereas inhugoaliases declare which page they point to.
Overall, some top class procrastination. A++ would faff again.