Migrating from Hugo to org-mode

This variable holds all the projects to be build, usually a good practice is to split static content from dynamic one. In the code above, "org-notes" are the actual blog posts, while "org-static" publish, as its name says, all the static content.

As I have more than 500 posts written since I started blogging (First on blogger, then self-hosted Wordpress, Jekyll, Hugo…) and it was a high time investment trying to migrate all of them without breaking links and style, I decided to leave all of them as they were on Hugo.

I copied the static files generated by hugo to a folder called static/hugo. But org-mode does nothing with this content, since I do not want it to be handled by it. I will elaborate more on this later.

As I want to leave disqus behind, I have found an usefull Github bot called utterance/utterances that enable users to post comments on every page of the blog, go to the end of the pages and try it out!. The only thing required is a github account, but since this is a tech blog, hopefully almost all readers have one.

In order to write a github actions one needs to create a file called action.yml at the root of the repository. This one in particular is very simple, since it only specify that it will execute docker using a Dokerfile:

name: 'Build Blog'
description: 'Build an org-mode project and publish also old hugo blog content'
runs:
  using: 'docker'
  image: 'Dockerfile'

The Dockerfile I've used is based on alpine-emacs and it is also very simple:

• Installs npm and html-minifier-terser
• Copy the necessary files with the org-mode project
• Copy some org-templates.
• Copy the old version of the blog, build with Hugo
• Execute the following script:

 1: #!/bin/sh
 2: 
 3: PUBLIC_DIR="${GITHUB_WORKSPACE}/public"
 4: 
 5: function print_info() {
 6:     echo -e "\e[36mINFO: ${1}\e[m"
 7: }
 8: 
 9: emacs --batch --no-init-file --load ./projects.lisp --funcall toggle-debug-on-error
10: 
11: html-minifier-terser --collapse-whitespace --remove-comments --remove-optional-tags --remove-redundant-attributes --remove-script-type-attributes --remove-tag-whitespace --use-short-doctype --minify-css true --minify-js true --input-dir ${PUBLIC_DIR} --output-dir ${PUBLIC_DIR} --file-ext html
12: 
13: html-minifier-terser --collapse-whitespace --remove-comments --remove-optional-tags --remove-redundant-attributes --remove-script-type-attributes --remove-tag-whitespace --use-short-doctype --minify-css true --minify-js true --input-dir ${PUBLIC_DIR} --output-dir ${PUBLIC_DIR} --file-ext css
14: 
15: mv ${GITHUB_WORKSPACE}/static/hugo/* ${PUBLIC_DIR}/
16: mv ${GITHUB_WORKSPACE}/static/googlee20ada3c6370fb77.html ${PUBLIC_DIR}/

emacs --batch --no-init-file --load ./projects.lisp --funcall toggle-debug-on-error runs emacs on batch mode to execute the project.lisp file and generate the blog, then it copies the old version of the blog in Hugo and minimize the contents.