org-roam/CHANGELOG.md

Changelog

1.2.2 (TBD)

In this release we support fuzzy links of the form [[Title]], [[*Headline]] and [[Title*Headline]]. Completion for these fuzzy links is supported via completion-at-point.

Breaking Changes

• #910 Deprecate company-org-roam, using completion-at-point instead. To use this with company, add the company-capf backend instead.

Features

• #974 Protect region targeted by org-roam-insert
• #994 Simplify org-roam-store-link
• #910 Support fuzzy links of the form Title, [[Headline]] and [[TitleHeadline]]

Bugfixes

1.2.1 (27-07-2020)

This 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:

1. We made the backlinks more outline-friendly by also showing the outline hierarchy for a backlink (#863)
2. We now support nested captures, which is crucial for org-roam-protocol (#966)

Breaking Changes

• #908 Normalized titles in database. May break external packages that rely on unnormalized titles.

Features

• #814 Implement org-roam-insert-immediate
• #833 Add customization of file titles with org-roam-title-to-slug-function.
• #839 Return selected file from org-roam-insert
• #847 Add GC threshold org-roam-db-gc-threshold to temporarily change the threshold on expensive operations.
• #847 Use sqlite3 transactions instead of storing the values to be inserted.
• #851 Add 'first-directory' option for org-roam-tag-sources
• #863 Display outline hierarchy in backlinks buffer
• #898 Add org-roam-random-note to browse a random note.
• #900 Support and index all valid org links
• #966 Enable nested captures

Bugfixes

• #854 Warn instead of fail when duplicate refs and IDs exist.
• #857 Fix tag extraction for symlinked directories.
• #894 Perform link fixes on all Org-roam files
• #952 Cache ${foo} template variables so they do not need to be re-entered twice

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

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_tags 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

1.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 (06-03-2020)

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.
• #247 Add org-roam-backlink face, which allows customizing backlinks appearance
• #259 Add optional initial-prompt to org-roam-find-file

Bugfixes

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

New Contributors

• [@acowley][https://github.com/acowley]
• [@teesloane][https://github.com/teesloane]

0.1.2 (2020-02-21)

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

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

0.1.1 (2020-02-15)

Mostly a documentation/cleanup release.

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