wilde at heart

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
    git submodule add https://github.com/jethrokuan/cortex.git themes/cortex
    echo theme = \"cortex\" >> config.toml
    mkdir content-org
  2. Configure ox-hugo to auto-export with a .dir-locals.el file

       . ((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 serve


Links to this note