org-roam has become a core part of my personal knowledge management system (and I should probably also update that 2019 post to reflect this).
Behind the scenes, Jethro Kuan (creator and maintainer of org-roam) and collaborators have been hard at work on v2.
The most important functional difference is that any org heading (section) can now also function as a “node”, or zettel, just like a standalone org-file.
Jethro Kuan was planning to release the v2 rewrite by the end of June, so this might soon become the default.
I’ve been using v2 for a week or two now, and the unification mentioned above has brought improvements in utility, as well as many sparks of joy.
In this post, I show how I used quelpa with my existing use-package setup in order to be able to install and update the latest v2 org-roam straight from its branch on github.
You can do the same in five easy steps.
Backup your org-roam files
You’re going to run a script that will transmogrify all of the org-files in
org-roam-directory, so make a backup before you start.
Really. Do it.
Configure quelpa and the quelpa-usepackage integration
Add the following code to your
init.el, close to the start. In my case, it’s
right after I extend my
package-archives list with the
Update your org-roam use-package sexp
org-roam use-package to look like the code below. Note that this
is different to your v1 in two ways: The quelpa invocation, and the org-roam
configuration, especially the
It would probably be safest to restart your Emacs at this point so it does the quelpa setup, and then installs org-roam v2 from github.
Convert all of your org-roam files
Copy the v2 migration script (in emacs-lisp of course) from this forum post by
Jethro Kuan into an empty buffer, and then do
I did eval
(org-roam--list-all-files) BEFORE I did that just to
double-check that it showed me the org-files I expected.
Step 5 is the nicest.