Rudimentary Roam replica with Org-mode
org-roam-file-exclude-regexp
char-or-string-p
org-attach-id-dir by defaultJust a minor release, with no huge changes.
#2054 node: simplify default org-roam-node-display-template.
This was done so completions work fine by default on all completion systems. To restore the tabular vertical completion interface, set this in your configuration:
(setq org-roam-node-display-template
(concat "${title:*} "
(propertize "${tags:10}" 'face 'org-tag)))
org-roam-db-extra-links-elements and org-roam-db-extra-links-exclude-keys for fine-grained control over additional link parsingorg-roam-capture-templates
FILTER-FN to org-roam-node-random
keys argument to the remaining dailies functions org-roam-dailies-goto-yesterday/-today/-tomorrow/-date and org-roam-dailies-capture-yesterday/-tomorrow/-date to give the abilty to get into a capture buffer bypassing the selection screen in all dailies commands. Extension of #2055:ref info captured in all cases.org-roam-backlinks-section
org-roam-node-toggle reuses windoworg-roam-node-insert places cursor after inserted link where appropriateorg-roam-mode-section-functions renamed to org-roam-mode-sections, supports passing args into the section-rendering functionkeys argument to org-roam-dailies-capture-today and org-roam-dailies--capture functions to give the abilty to get into a capture buffer bypassing the selection screen:if-new property of each capture template is now renamed to :target
:if-new template for existing nodesOrg-roam v2.1.0 is the first release since Org-roam v2.0. It contains fixes for many issues users have faced during migration. In addition, the codebase has undergone major refactorings, making it easier to navigate and contribute to (thanks @Wetlize).
org-roam-extract-subtree
org-roam-db-update-on-save
org-roam-db-autosync-mode, replacing org-roam-setup and org-roam-teardown
org-roam-get-keyword is now obsolete: prefer org-collect-keywords
org-roam-capture- keys in interactive commandsorg-id-locations-file
This is the first official release of Org-roam v2. Org-roam v2 is not backwards compatible with v1!
Please read the wiki for more information on the changes. For some internal insights, the author has also written a post on this release.
This is the first alpha release of Org-roam v2.
For more information about migrating, see the wiki
Sample configuration:
(use-package org-roam
:custom
(org-roam-directory "/path/to/org-files/")
:bind (("C-c n l" . org-roam-buffer-toggle)
("C-c n f" . org-roam-node-find))
:config
(org-roam-setup))
Read more about Org-roam v2 here
You should be able to (for the most part) convert your v1 files to the v2 format as follows:
https://gist.github.com/jethrokuan/02f41028fb4a6f81787dc420fb99b6e4
roam: links, and roam_tags are not automatically converted.
Stick to Org-roam v1 if:
org-roam-server and org-roam-bibtex
Final release of Org-roam prior to Org-roam v2.
Mostly just small bug fixes I guess.
Primarily a stabilization and bug-fix release.
Org-roam-dailies has also been revamped to include new features, see this video for a quick overview.
org-roam-alias-add, org-roam-alias-delete, org-roam-tag-add, and org-roam-tag-delete.ROAM_KEY keywords can now be specified in one file. This allows bibliographical entries to share the same note file.org-roam-prefer-id-links variable to select linking methodorg-roam-protocol to capture the webpage's selection, and add a toggle for storing the links to the pagesorg-roam-db-update-method to control when the cache is rebuilt.org-roam-update-db-idle-seconds to org-roam-db-idle-idle-seconds
org-roam--extract-links to handle content boundaries.org-roam-db-build-cache by not killing temporary buffer in org-roam--extract-links.org-roam-link-title-format everywhere.org-roam-db-build-cache failing in scenarios involving duplicate IDs and deleted files.In this release we support fuzzy links of the form [[roam:Title]], [[roam:*Headline]] and [[roam:Title*Headline]]. Completion for these fuzzy links is supported via completion-at-point.
Org-roam now does not resolve symlinks. This significantly speeds up cache builds, but may result in some workflows breaking. In particular, Org-roam now cannot figure out if two distinct file paths in the Org-roam directory are the same file, and both files will be processed as if they were different files. This error seems to be unavoidable now that symlinks are not resolved, but this workflow is rare and should not affect most users.
This change requires you to set org-roam-directory to the resolved path of a folder. That is:
(setq org-roam-directory (file-truename "/path/to/directory/"))
company-org-roam, using completion-at-point instead. To use this with company, add the company-capf backend instead.vanilla org-roam-tag-source to extract buffer Org tagsorg-roam-tag-face to customize appearance of tags in interactive commandsorg-roam-rename-file-on-title-change is non-nil.org-roam-insert
org-roam-completions-everywhere allows for completions everywhere from word at pointThis release consisted of a big deal of refactoring and bug fixes. Notably, we fixed several catastrophic failures on db builds with bad setups (#854), and modularized tag and title extractions.
We also added some new features that had been a long time coming:
org-roam-protocol (#966)org-roam-insert-immediate
org-roam-title-to-slug-function.org-roam-insert
org-roam-db-gc-threshold to temporarily change the threshold on expensive operations.'first-directory' option for org-roam-tag-sources
org-roam-random-note to browse a random note.