1.2.0 (12-06-2020)

In this release, we improved the linking process by achieving feature parity between links to files and links to headlines. Before, we used the file:foo::*bar format to link to the headline bar in file foo, but this was prone to breakage upon renaming the file or modifying the headline. This is not the case anymore. Now, we use org-id to create IDs for those headlines, which are then stored in our database to compute the relationships and jump around. Note that this will work even if you’re not using org-id in your global configuration for Org-mode.

This is a major step forward. Supporting the in-file structure of Org-mode files means that we can interface with many of its core-features like TODOs, properties, priorities, etc. UX will have to be figured out, but this release ushers in a new age in terms of functionalities.

We also add org-roam-unlinked-references, which naively finds text that could be references to the current Org-roam file.

Breaking Changes

• #701 Use emacsql-sqlite3 instead of emacsql-sqlite for better Windows compatibility. This requires the presence of the standard sqlite3 binary on your machine.
• #750 Deprecate org-roam-buffer-no-delete-other-windows in favour of org-roam-buffer-window-parameters.

Features

• #787 Add org-roam-unlinked-references
• #783 Add support for headlines
• #757 Roam global properties are now case-insensitive
• #680 , #703, #708 Add org-roam-doctor checkers for ROAM_* properties
• #664 Add support for shelling out to rg and find in org-roam--list-files
• #679, #683 Building of the graph now happens in a separate process

Bugfixes

• #714 No longer print citelinks in backlinks buffer if there is no ROAM_KEY property or org-ref is not installed
• #759, #760 Tags are only added to the tags table if there are actually tags present
• #700, #733 Allow symlinks within the org-roam directory

Many thanks to those who have been participating actively and helping make Org-roam better. (shoutout to @TimQuelch , @nobiot , @alan-carroll!)

1.1.1 (18-05-2020)

In this release, we added two new features:

1. org-roam-doctor: a linting system that helps you discover possible problems with your Org-roam files. This is in the spirit of keeping notes in top quality.
2. A tagging system: one can now use sub-directories, and the #+ROAM_TAG key add additional meta data to notes. For more information, see here.

As usual, this release comes with a multitude of bug-fixes and refactorings.

Breaking Changes

• #523 remove org-roam-completion-fuzzy-match in favor of using completion mechanism's configuration options directly
• #547 Deprecate org-roam-db--maybe-update, in favour of org-roam-db--update-maybe
• #604 Deprecate org-roam-title-include-subdirs, org-roam-title-subdir-format org-roam-title-subdir-separator, for a more general tagging system built on subdirectories

Bugfixes

• #509 fix backup files being tracked in database
• #509 fix external org files being tracked in database
• #537 quote graphviz node and edge configuration options to allow multi-word configurations
• #545 fix org-roam--extract-links to ensure that multiple citations (cite:key1,key2) are split correctly
• #547 Fix unlinked citations
• #660 fix rename-file advice not working for renaming to directories
• #660 fix links breaking within file on file movement

Features

• #538 Optionally use text in first headline as title
• #553 Add prefix argument to org-roam-db-build-cache for forcing rebuilds
• #560 Apply 'error face to distinguish broken links
• #570 Add org-roam-doctor to diagnose org-roam files
• #625 Add org-roam-title-sources to control how titles are retrieved within notes
• #604 Add a tagging system. org-roam-tag-sources controls how tags are retrieved from notes

Internal Changes

• #547 Added type column to the refs table
• #606 Added org-roam-dev.el for developer coding standards
• #622 Online documentation now points to the Org-based documentation

1.1.0 (21-04-2020)

To the average user, this release is mainly a bugfix release with additional options to customize. However, the changes made to the source is significant. Most notably, in this release:

1. The codebase has been modularized into separate files, to ease future maintenance and adding of new features (mainly by @progfolio). Because of these changes, we had to rename many functions and variables: the old names are kept for backwards compatibility, but you are encouraged to use the new function names. You'll receive a warning when you're calling the function with its obsolete name.
2. @kljohann did some fantastic work on graph generation: allowing building images for connected components within the graph up to a specified distance
3. We also started supporting org-ref natively: cite links now show up in both the graph and the org-roam buffer.

In the coming months, you can expect work on bigger projects (e.g. revamping the org-roam buffer).

Breaking Changes

• #385 Deprecate org-roam-graph-node-shape in favour of org-roam-graph-node-extra-config.
• #473 Deprecate org-roam-date-filename-format and org-roam-date-title-format, in favour of org-roam-dailies-capture-templates.

New Features

• #350 Add org-roam-db-location to customize location of org-roam database.
• #359 Add org-roam-verbose to allow or silence printing of information.
• #374 Add support for org-ref cite: links
• #380 Allow org-roam-buffer-position to also be top or bottom
• #385 Add org-roam-graph-node-extra-config to configure Graphviz nodes
• #398, #418 Add graph building for connected components
• #435 Add org-roam-graph-edge-extra-config to configure Graphviz edges
• #439 Add support for org-ref citations to display as edges in graph. Add org-roam-graph-edge-cites-extra-config to configure these edges
• #465 Add org-roam-file-extensions to allow detection of org files with different file extensions
• #488 Allow a function for org-roam-graph-viewer
• #491 Use TITLE as description when linking before first heading

Bugfixes

• #470 Add workaround for undocumented file-truename behaviour in org-roam--org-roam-file-p.

Internal Changes

• #363, #473 Modularize org-roam features.
• #497 Simplify org-roam--list-files implementation

Org-roam v1.0.0 (23-03-2020)

Org-roam is now on MELPA! We have squashed most of the bugs, and Org-roam has been stable for the most part.

New Features

• [#269] Add org-roam-graphviz-extra-options
• [#257] Add a company-backend company-org-roam
• [#284], [#289] Configurable org-roam-completion-system with options 'default, 'ido, 'ivy and 'helm
• [#289] Add customizable org-roam-fuzzy-match to allow fuzzy-matching of candidates
• [#290] Add org-roam-date-title-format and org-roam-date-filename-format for customizing Org-roam's date files
• [#296] Allow multiple exclusion matchers in org-roam-graph-exclude-matcher

Bugfixes

• [#293] Fix capture templates not working as expected for org-roam-find-file
• [#275] Fix database rebuild when org-roam-directory is set locally

1.0.0-rc1 😮 (2020-06-03)

This is a pre-release before the push to MELPA. It contains large internal changes, with little user-facing changes. Most notably, the backing storage has been changed to a SQLite database, and a templating system using org-capture is introduced.

Breaking Changes

• [#200] Move Org-roam cache into a SQLite database.
• [#203] Roam protocol is deprecated, in favour of extending org-roam-protocol.

New Features

• [#182] Support file name aliases via #+ROAM_ALIAS.
• [#216] Adds templating functionality by extending org-capture.
• [#232] Adds a prefix key to org-roam-show-graph, to generate graph without opening it.
• [#233] Adds org-roam-graph-exclude-matcher, which allows exclusion of nodes from graph.

Bugfixes

• [#207], [#221] small bugfixes to Org-roam graph generation
• [#230] remove nonspacing marks from filenames, to prevent cross-platform errors

New Contributors

• @acowley
• @teesloane

Org-roam v0.1.2 🕺💃🏽 (2020-02-21)

This release brings with it some breaking changes, but as a whole the project feels a lot more stable.

Breaking Changes

• #143 org-roam-mode is now a global mode. The installation instructions have changed accordingly.
• #103 Change org-roam-file-format to a function: org-roam-file-name-function to allow more flexible file name customizaton. Also changes org-roam-use-timestamp-as-filename to org-roam-filename-noconfirm to better describe what it does.

New Features

• #145 org-roam-show-graph: Fallback to Emacs SVG viewer
• #141 add variable org-roam-new-file-directory for new Org-roam files
• #138 add org-roam-switch-to-buffer
• #124, #141 Maintain cache consistency on file rename and delete
• #87, #90 Support encrypted Org files
• #110 Add prefix to org-roam-insert, for inserting titles down-cased
• #99 Add keybinding so that <return> or mouse-1 in the backlinks buffer visits the source file of the backlink at point

Changes

• #108 Locally overwrite the link following behaviour in the org-roam-buffer to open files in the same window org-roam was called from

Bugfixes

• #86 Fix org-roam--parse-content incorrect :to computation for nested files
• #98 Fix org-roam--find-file picking up temporary files
• #136 Misc bugfixes

Internal

• #122, #128 Improve performance of post-command-hook
• #92, #105 Add tests for core functionality

New Contributors

We have a bunch of new contributors to this project, which is nice! Glad to transform this into a community effort.

• @frigge
• @juergenhoetzel
• @chip2n
• @l3kn
• @jdormit
• @herbertjones
• @CeleritasCelery
• @daniel-koudouna

Org-roam v0.1.1 🚢

Another release in 3 days?! I wasn't very happy with the state of the first release, so I'm cutting a new one. It's mostly a documentation and cleanup release, with no new features.

There's now a new documentation page, and CI is now enabled.

New Features

• #62 Add the options org-roam-use-timestamps-as-filename and org-roam-file-format, more in documentation.

Breaking Changes

• #62 The ID (file-name) workflow is no longer first-class, but a fallback when titles don't exist.

Changes

• #66, #68: Improved the quality of the package in preparation of submission to MELPA
• #73: Added CI to the project via Github Issues (Thanks @alphapapa for scripts and setup)
• #69, #72, #75: Major cleanup and de-duplication of code

Bugfixes

• #67: Fixed org-roam--make-file not creating files with extensions
• #71, #78: Fixed org-roam-insert not inserting correct paths
• #82: Fixed nested Org-roam files not being detected as part of Org-roam

Org-Roam's First Release 🎉

This tag marks the first stable-ish release of Org-roam. A lot of things were learnt when building this, and I still plan to make big changes to the project while it is still in its infancy. If you have already built a workflow around this release (hopefully not), you can continue using it as is.

From this point on, I'll be maintaining a proper changelog, and master branch will be the stable branch.