This is a repository for org-roam notes. It is a fork of jethrokuan/braindump.
This braindump is generated via ox-hugo and uses the cortex theme.
The org files used to generate the markdown files are also hosted here for posterity. They can be found in the org folder.
In regular Emacs initialisation:
(with-eval-after-load 'ox
(require 'ox-hugo))
In the Org files, add strings like this at the top:
#+setupfile:./hugo_setup.org
#+hugo_slug: something_goes_here
#+title: ...
...
As a one-off export of a single file, you can run: C-c C-e H A
(or M-x org-export-dispatch RET H A
).
However, much better than that: we have added .dir-locals.el
to the top-level (~/notes)
directory, with contents as follows:
(("org/"
. ((org-mode . ((eval . (org-hugo-auto-export-mode)))))))
This automatically generate a markdown file in ~/notes/content/
any time an Org file in ~/notes/org/
is saved.
Install hugo. E.g., on a Mac with Homebrew:
$ brew install hugo
Make sure the submodule containing the Hugo theme is installed:
$ git submodule init
$ git submodule update
Now run hugo to generate the files (find them in /public
):
$ hugo
Or run the following to get an immediately browsable website on localhost:
$ hugo serve