How I Write and Publish These Notes

How I Write These Notes

I write my notes in Emacs, using the Doom Emacs configuration. You can look at my Dotfiles to see how I install and configure Doom Emacs. In particular, I use a tool called Org-roam to take the notes. This allows me to seamlessly create links between notes in a flat structure. I can see how my thoughts and ideas connect, and I don’t have to worry about making sure my files are structured perfectly.

How I Publish These Notes

This is a little tricky. You can look at the GitHub repository for this Digital Garden to see how I structure the website. I enable the +hugo flag in the org section in my Doom init.el file. This makes sure all of the Hugo features and functions are available to me without me having to configure much. Within my org directory, I do the following:

1. Create a new Hugo site

hugo new site digital-garden
cd digital-garden
git init
echo theme = \"cortex\" >> config.toml
mkdir content-org

2. Configure ox-hugo to auto-export with a .dir-locals.el file

(("content-org/"
. ((org-mode . ((org-hugo-base-dir . "../.")
(eval             . (org-hugo-auto-export-mode)))))))

3. Change some of the default layout settings. You can see how I do that in the repository.

4. Build & Serve the site

hugo
hugo serve