e05ee1240d
* (feat) cond display relative subdir in title for selection A title can now be constructed as ‘subdir/file-title’ where ‘subdir’ is the sub-directory relative from ‘org-roam-directory’. When ‘org-roam-title-include-subdirs’ is non-nil, ‘org-roam--extract-titles’ now outputs titles in this format. * (fix) improve docstrings * (feat) add var for modifying subdir-separator * (fix) nitpick docstring * (doc) document subdir creation in templates with :file-name * (feat) make subdir-format accept a function * (fix) respect docstring one-line-description * (fix) address checkdoc errors * (fix) also add subdirs when db--update-titles * (feat) improve modularisation `org-roam--extract-titles' is now reverted to its default definition, i.e. it doesn’t format the titles. In its stead, `org-roam--extract-and-format-titles' is created to both extract the titles and process all of them with `org-roam--format-title', which is a much better way to do this. * Refactor with ->> * Refactor with let* Pretty sure I got confused because I thought I needed to use the result of the db-queryr. * Remove useless ->> |
||
---|---|---|
.github | ||
doc | ||
tests | ||
.gitignore | ||
.readthedocs.yml | ||
CHANGELOG.md | ||
LICENSE | ||
Makefile | ||
makem.sh | ||
mkdocs.yml | ||
org-roam-buffer.el | ||
org-roam-capture.el | ||
org-roam-compat.el | ||
org-roam-completion.el | ||
org-roam-dailies.el | ||
org-roam-db.el | ||
org-roam-graph.el | ||
org-roam-macs.el | ||
org-roam-protocol.el | ||
org-roam.el | ||
README.md |
Synopsis
Org-roam is a Roam replica built on top of the all-powerful Org-mode.
Org-roam is a solution for effortless non-hierarchical note-taking with Org-mode. With Org-roam, notes flow naturally, making note-taking fun and easy. Org-roam should also work as a plug-and-play solution for anyone already using Org-mode for their personal wiki.
Org-roam aims to implement the core features of Roam, leveraging the mature ecosystem around Org-mode where possible. Eventually, we hope to further introduce features enabled by the Emacs ecosystem.
@technovangelist has produced a video describing Org-roam and the concepts behind it:
As of February 2020, it is in a very early stage of development.
Important links:
A Preview
Here's a screenshot of org-roam
. The org-roam
buffer shows
backlinks for the active org buffer in the left window, as well as the
surrounding content in the backlink file. The database is built once,
and updated incrementally. The graph is generated from the link
structure, and can be used to navigate to the respective files.
Installation
You can install org-roam
using package.el
:
M-x package-install RET org-roam RET
Here's a sample configuration with using use-package
:
(use-package org-roam
:hook
(after-init . org-roam-mode)
:custom
(org-roam-directory "/path/to/org-files/")
:bind (:map org-roam-mode-map
(("C-c n l" . org-roam)
("C-c n f" . org-roam-find-file)
("C-c n g" . org-roam-show-graph))
:map org-mode-map
(("C-c n i" . org-roam-insert))))
For more detailed installation and configuration instructions (including for Doom and Spacemacs users), please see the documentation.
Knowledge Bases using Org-roam
Changelog
A changelog is being maintained here
Contributing
To report bugs and suggest new feature use the issue tracker. If you have some code which you would like to be merged, then open a pull request. Please also see CONTRIBUTING.md.
License
Copyright © Jethro Kuan and contributors. Distributed under the GNU General Public License, Version 3