blob: 81a283b3eb0c995725b755873eb25c94f82cb396 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
* nroam
nroam is a supplementary package for [[https://github.com/org-roam/org-roam][org-roam]] that replaces the
backlink side buffer of Org-roam. Instead, it displays org-roam
backlinks at the end of org-roam buffers. The user can also click a
button to see unlinked occurrences of the buffer title (as defined by
=org-roam-unlinked-references=).
** Screenshots
*** Backlinks
[[file:screenshots/backlinks.png][file:screenshots/backlinks.png]]
*** Unlinked references
[[file:screenshots/unlinked-references.png][file:screenshots/unlinked-references.png]]
* Rationale
One of the ideas behind nroam is to remove the friction and effort it
takes to consult backlinks. I consider backlinks to be a very central
piece of information about a note. Backlinks can even be the most
important content of a note, for instance when using page links as
tags.
It is easy to miss backlinks when they are not always visible with the
main content of a note. The side buffer will not always be open, and
even if it is, the information it contains is visually far away from
the note you're looking at.
By making them an integral part of the org buffer, backlinks also
become more powerful. You could for instance make a sparse tree—see
=org-sparse-tree= — to filter the contents of a note and its backlinks
at the same time.
* Setup & usage
To setup nroam for all =org-mode= buffer, evaluate the following:
#+begin_src elisp
(add-hook 'org-mode-hook #'nroam-setup-maybe)
#+end_src
The linked references section will be updated after each buffer save.
It can also be manually updated by typing =C-c C-c= anywhere in the
linked references section.
* Warning
This package is in its infancy. Be careful when using it as it
modifies your =org-mode= buffers—it should not modify your files
though. Backup your data often.
|
