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 five minutes 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.