From 1c730b7d649d6d0223c7920c8c6d525c43aa776e Mon Sep 17 00:00:00 2001 From: jethrokuan Date: Sun, 29 Aug 2021 11:33:45 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=2034021?= =?UTF-8?q?5a16aa379bdd6121303c729a405cb481bef=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- manual.html | 195 +++++++++++++++++++++++++++++++++++--------------- org-roam.org | 43 +++++++++++ org-roam.texi | 78 +++++++++++++++++--- 3 files changed, 248 insertions(+), 68 deletions(-) diff --git a/manual.html b/manual.html index e3070d6..aa7c923 100644 --- a/manual.html +++ b/manual.html @@ -93,7 +93,9 @@ General Public License for more details. • Node Properties   -• Completion   +• Citations   + +• Completion   • Encryption   @@ -125,6 +127,8 @@ General Public License for more details. • Variable Index   +• Bibliography   + 
 
 
— The Detailed Node Listing —
@@ -189,6 +193,12 @@ Node Properties
 
 
 
+Citations
+
+
• Using the Cached Information  
+
+
+
 Completion
 
 
• Completing within Link Brackets  
@@ -361,7 +371,7 @@ Next: Org-roam is a tool that will appear unfriendly to anyone unfamiliar with Emacs
 and Org-mode, but it is also extremely powerful to those willing to put effort
-inn mastering the intricacies. Org-roam stands on the shoulders of giants. Emacs
+in mastering the intricacies. Org-roam stands on the shoulders of giants. Emacs
 was first created in 1976, and remains the tool of choice for many for editing
 text and designing textual interfaces. The malleability of Emacs allowed the
 creation of Org-mode, an all-purpose plain-text system for maintaining TODO
@@ -777,8 +787,8 @@ for notes. This variable needs to be set before any calls to Org-roam functions.
 inside org-roam-directory: Org-roam does not resolve symbolic links.
 

 
Next, we setup Org-roam to run functions on file changes to maintain cache
-consistency. This is achieved by running M-x org-roam-db-autosync-mode~.
-To ensure that Org-roam is available on startup, place this in your Emacs
+consistency. This is achieved by running M-x org-roam-db-autosync-mode. To
+ensure that Org-roam is available on startup, place this in your Emacs
 configuration:
 

 

@@ -1052,7 +1062,7 @@ Previous: 
 

 

-Next: , Previous: , Up: Top   [Index]

+Next: , Previous: , Up: Top   [Index]

 

 
8 Node Properties

 
@@ -1189,12 +1199,70 @@ ref to add.
 
Remove a ref from the node at point.
 

 
+

+

+

+Next: , Previous: , Up: Top   [Index]

+

+
9 Citations

+
+
Since version 9.5, Org has first-class support for citations. Org-roam supports
+the caching of both these in-built citations (of form [cite:@key]) and org-ref
+citations (of form (NO_ITEM_DATA:key)).
+

+
Org-roam attempts to load both the org-ref and org-cite package when
+indexing files, so no further setup from the user is required for citation
+support.
+

+
+
+
• Using the Cached Information  
+

+
+

+

+

+Up: Citations   [Index]

+

+
9.1 Using the Cached Information

+
+
It is common to use take reference notes for academic papers. To designate the
+node to be the canonical node for the academic paper, we can use its unique
+citation key:
+

+

+
* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: @thrun2005probabilistic
+:END:
+

+
+
for org-cite, or:
+

+

+
* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: cite:thrun2005probabilistic
+:END:
+

+
+
for org-ref.
+

+
When another node has a citation for that key, we can see it using the
+Reflinks section of the Org-roam buffer.
+

+
Extension developers may be interested in retrieving the citations within their
+notes. This information can be found within the citation table of the Org-roam
+database.
+

 

 

 

-Next: , Previous: , Up: Top   [Index]

+Next: , Previous: , Up: Top   [Index]

 

-
9 Completion

+
10 Completion

 
 
Completions for Org-roam are provided via completion-at-point. Org-roam
 currently provides completions in two scenarios:
@@ -1225,7 +1293,7 @@ popularity is orderless.
 

 Next: , Up: Completion   [Index]

 

-
9.1 Completing within Link Brackets

+
10.1 Completing within Link Brackets

 
 
Completions within link brackets are provided by
 org-roam-complete-link-at-point.
@@ -1239,7 +1307,7 @@ of choice.
 

 Previous: , Up: Completion   [Index]

 
-
9.2 Completing anywhere

+
10.2 Completing anywhere

 
 
The same completions can be triggered anywhere for the symbol at point if not
 within a bracketed link. This is provided by org-roam-complete-everywhere.
@@ -1265,7 +1333,7 @@ to t:
 

 Next: , Previous: , Up: Top   [Index]

 
-
10 Encryption

+
11 Encryption

 
 
Emacs has support for creating and editing encrypted gpg files, and Org-roam need
 not provide additional tooling. To create encrypted files, simply add the .gpg
@@ -1287,7 +1355,7 @@ should also ensure the database is encrypted.
 

 Next: , Previous: , Up: Top   [Index]

 
-
11 Org-roam Protocol

+
12 Org-roam Protocol

 
 
Org-roam provides extensions for capturing content from external applications
 such as the browser, via org-protocol. Org-roam extends org-protocol with 2
@@ -1307,7 +1375,7 @@ protocols: the roam-node and roam-ref protocols.
 

 Next: , Up: Org-roam Protocol   [Index]

 
-
11.1 Installation

+
12.1 Installation

 
 
To enable Org-roam’s protocol extensions, simply add the following to your init
 file:
@@ -1333,7 +1401,7 @@ file:
 

 Next: , Up: Installation (1)   [Index]

 
-
11.1.1 Linux

+
12.1.1 Linux

 
 
For Linux users, create a desktop application in
 ~/.local/share/applications/org-protocol.desktop:
@@ -1380,7 +1448,7 @@ make the new policy take effect.
 

 Next: , Previous: , Up: Installation (1)   [Index]

 
-
11.1.2 Mac OS

+
12.1.2 Mac OS

 
 
For Mac OS, we need to create our own application.
 

@@ -1449,7 +1517,7 @@ the default handler instead, run:
 

 Previous: , Up: Installation (1)   [Index]

 
-
11.1.3 Windows

+
12.1.3 Windows

 
 
For Windows, create a temporary org-protocol.reg file:
 

@@ -1480,7 +1548,7 @@ file.
 

 Next: , Previous: , Up: Org-roam Protocol   [Index]

 
-
11.2 The roam-node protocol

+
12.2 The roam-node protocol

 
 
The roam-node protocol opens the node with ID specified by the node key (e.g.
 org-protocol://roam-node?node=node-id). org-roam-graph uses this to make the
@@ -1491,7 +1559,7 @@ graph navigable.
 

 Previous: , Up: Org-roam Protocol   [Index]

 
-
11.3 The roam-ref protocol

+
12.3 The roam-ref protocol

 
 
This protocol finds or creates a new note with a given ROAM_REFS:
 

@@ -1524,7 +1592,7 @@ Previous: 
, Previous: , Up: Top   [Index]

 
-
12 The Templating System

+
13 The Templating System

 
 
Org-roam extends the org-capture system, providing a smoother note-taking
 experience. However, these extensions mean Org-roam capture templates are
@@ -1547,7 +1615,7 @@ will be no prompt for template selection.
 

 Next: , Up: The Templating System   [Index]

 
-
12.1 Template Walkthrough

+
13.1 Template Walkthrough

 
 
To demonstrate the additions made to org-capture templates. Here, we explain
 the default template, reproduced below. You will find some most of the elements
@@ -1575,12 +1643,12 @@ here.
 
  •  "%?" is the template inserted on each call to org-roam-capture-.
 This template means don’t insert any content, but place the cursor here.
 
-
  •  :target is a compulsory specification in the Org-roam capture
-template. The first element of the list indicates the type of the
-target, the second element indicates the location of the captured
-node, and the rest of the elements indicate prefilled template that
-will be inserted and the position of the point will be adjusted for.
-The latter behavior various from type to type of the capture target.
+
  •  :target is a compulsory specification in the Org-roam capture template. The
+first element of the list indicates the type of the target, the second
+element indicates the location of the captured node, and the rest of the
+elements indicate prefilled template that will be inserted and the position
+of the point will be adjusted for. The latter behavior various from type to
+type of the capture target.
 
 
  •  :unnarrowed t tells org-capture to show the contents for the whole file,
 rather than narrowing to just the entry. This is part of the Org-capture
@@ -1595,7 +1663,7 @@ customization options.
 
    
 Previous: , Up: The Templating System   [Index]
    
 
-
    12.2 Org-roam Template Expansion
    
+
    13.2 Org-roam Template Expansion
    
 
 
    Org-roam’s template definitions also extend org-capture’s template syntax, to
 allow prefilling of strings. We have seen a glimpse of this in Template
@@ -1642,7 +1710,7 @@ minibuffer completion.
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    13 Graphing
    
+
    14 Graphing
    
 
 
    Org-roam provides basic graphing capabilities to explore interconnections
 between notes, in org-roam-graph. This is done by performing SQL queries and
@@ -1709,7 +1777,7 @@ the second option to set the browser and network file path:
 
    
 Up: Graphing   [Index]
    
 
-
    13.1 Graph Options
    
+
    14.1 Graph Options
    
 
 
    Graphviz provides many options for customizing the graph output, and Org-roam
 supports some of them. See https://graphviz.gitlab.io/_pages/doc/info/attrs.html
@@ -1748,7 +1816,7 @@ Example: '(("dir" . "back"))
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    14 Org-roam Dailies
    
+
    15 Org-roam Dailies
    
 
 
    Org-roam provides journaling capabilities akin to
 Org-journal with org-roam-dailies.
@@ -1765,7 +1833,7 @@ Org-journal with org-roam-dailies.
 
    
 Next: , Up: Org-roam Dailies   [Index]
    
 
-
    14.1 Configuration
    
+
    15.1 Configuration
    
 
 
    For org-roam-dailies to work, you need to define two variables:
 
    
@@ -1800,7 +1868,7 @@ Next: , Up: , Up: Org-roam Dailies   [Index]
    
 
-
    14.2 Usage
    
+
    15.2 Usage
    
 
 
    org-roam-dailies provides these interactive functions:
 
    
@@ -1878,7 +1946,7 @@ creating an entry.
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    15 Performance Optimization
    
+
    16 Performance Optimization
    
 
 
    
 
    • Garbage Collection  
@@ -1890,7 +1958,7 @@ Next: 
    Performance Optimization   [Index]
    
 
-
    15.1 Garbage Collection
    
+
    16.1 Garbage Collection
    
 
 
    During the cache-build process, Org-roam generates a lot of in-memory
 data-structures (such as the Org file’s AST), which are discarded after use.
@@ -1910,7 +1978,7 @@ operations. To reduce the number of garbage collection processes, one may set
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    16 The Org-mode Ecosystem
    
+
    17 The Org-mode Ecosystem
    
 
 
    Because Org-roam is built on top of Org-mode, it benefits from the vast number
 of packages already available.
@@ -1941,7 +2009,7 @@ of packages already available.
 
    
 Next: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.1 Browsing History with winner-mode
    
+
    17.1 Browsing History with winner-mode
    
 
 
    winner-mode is a global minor mode that allows one to undo and redo changes in
 the window configuration. It is included with GNU Emacs since version 20.
@@ -1964,7 +2032,7 @@ interactive functions:
 
    
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.2 Versioning Notes
    
+
    17.2 Versioning Notes
    
 
 
    Since Org-roam notes are just plain text, it is trivial to track changes in your
 notes database using version control systems such as Git. Simply initialize
@@ -1980,7 +2048,7 @@ versions of a tracked Org-roam note.
 
    
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.3 Full-text search with Deft
    
+
    17.3 Full-text search with Deft
    
 
 
    Deft provides a nice interface for browsing and filtering org-roam notes.
 
    
@@ -2004,7 +2072,7 @@ Next: , Previ
 
    
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.4 Org-journal
    
+
    17.4 Org-journal
    
 
 
    Org-journal provides journaling capabilities to Org-mode. A lot of its
 functionalities have been incorporated into Org-roam under the name
@@ -2027,7 +2095,7 @@ journal entries from the ideas you would write on a scratchpad.
 
    
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.5 Org-download
    
+
    17.5 Org-download
    
 
 
    Org-download lets you screenshot and yank images from the web into your notes:
 
    
@@ -2049,7 +2117,7 @@ Next: , Previous: 
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.6 mathpix.el
    
+
    17.6 mathpix.el
    
 
 
    mathpix.el uses Mathpix’s API to convert clips into latex equations:
 
    
@@ -2071,7 +2139,7 @@ Next: 
    , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.7 Org-noter / Interleave
    
+
    17.7 Org-noter / Interleave
    
 
 
    Org-noter and Interleave are both projects that allow synchronised annotation of
 documents (PDF, EPUB etc.) within Org-mode.
@@ -2081,7 +2149,7 @@ documents (PDF, EPUB etc.) within Org-mode.
 
    
 Next: , Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.8 Bibliography
    
+
    17.8 Bibliography
    
 
 
    org-roam-bibtex offers tight integration between org-ref, helm-bibtex and
 org-roam. This helps you manage your bibliographic notes under org-roam.
@@ -2095,7 +2163,7 @@ file with the right ROAM_REFS.
 
    
 Previous: , Up: The Org-mode Ecosystem   [Index]
    
 
-
    16.9 Spaced Repetition
    
+
    17.9 Spaced Repetition
    
 
 
    Org-fc is a spaced repetition system that scales well with a large number of
 files. Other alternatives include org-drill, and pamparam.
@@ -2108,7 +2176,7 @@ Org-mode, and sync your cards to Anki via , Previous: , Up: Top   [Index]
    
 
-
    17 FAQ
    
+
    18 FAQ
    
 
 
    
 
    • How do I have more than one Org-roam directory?  
@@ -2126,7 +2194,7 @@ Next: 
    , Up: FAQ   [Index]
    
 
-
    17.1 How do I have more than one Org-roam directory?
    
+
    18.1 How do I have more than one Org-roam directory?
    
 
 
    Emacs supports directory-local variables, allowing the value of
 org-roam-directory to be different in different directories. It does this by
@@ -2150,7 +2218,7 @@ that directory, at least once.
 
    
 Next: , Previous: , Up: FAQ   [Index]
    
 
-
    17.2 How do I migrate from Roam Research?
    
+
    18.2 How do I migrate from Roam Research?
    
 
 
    Fabio has produced a command-line tool that converts markdown files exported
 from Roam Research into Org-roam compatible markdown. More instructions are
@@ -2161,7 +2229,7 @@ provided in the reposito
 
    
 Next: , Previous: , Up: FAQ   [Index]
    
 
-
    17.3 How do I create a note whose title already matches one of the candidates?
    
+
    18.3 How do I create a note whose title already matches one of the candidates?
    
 
 
    This situation arises when, for example, one would like to create a note titled
 “bar” when “barricade” already exists.
@@ -2182,7 +2250,7 @@ the candidate list.
 
    
 Previous: , Up: FAQ   [Index]
    
 
-
    17.4 How can I stop Org-roam from creating IDs everywhere?
    
+
    18.4 How can I stop Org-roam from creating IDs everywhere?
    
 
 
    Other than the interactive commands that Org-roam provides, Org-roam does not
 create IDs everywhere. If you are noticing that IDs are being created even when
@@ -2195,7 +2263,7 @@ is a popular option.
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    18 Migrating from Org-roam v1
    
+
    19 Migrating from Org-roam v1
    
 
 
    Those coming from Org-roam v1 will do well treating v2 as entirely new software.
 V2 has a smaller core and fewer moving parts, while retaining the bulk of its
@@ -2229,7 +2297,7 @@ the ROAM_TAGS property for headline nodes
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    19 Developer’s Guide to Org-roam
    
+
    20 Developer’s Guide to Org-roam
    
 
 
    
 
    • Org-roam's Design Principle  
@@ -2243,7 +2311,7 @@ Next: , Previous: 
 Next: , Up: Developer's Guide to Org-roam   [Index]
    
 
-
    19.1 Org-roam’s Design Principle
    
+
    20.1 Org-roam’s Design Principle
    
 
 
    Org-roam is primarily motivated by the need for a dual representation. We
 (humans) love operating in a plain-text environment. The syntax rules of
@@ -2288,7 +2356,7 @@ queries on their Org files.
 
    
 Previous: , Up: Developer's Guide to Org-roam   [Index]
    
 
-
    19.2 Building Extensions and Advanced Customization of Org-roam
    
+
    20.2 Building Extensions and Advanced Customization of Org-roam
    
 
 
    Because Org-roam’s core functionality is small, it is possible and sometimes
 desirable to build extensions on top of it. These extensions may one or more of
@@ -2327,7 +2395,7 @@ load when support is available.
 
    
 Next: , Up: Building Extensions and Advanced Customization of Org-roam   [Index]
    
 
-
    19.2.1 Accessing the Database
    
+
    20.2.1 Accessing the Database
    
 
 
    Access to the database is provided singularly by org-roam-db-query, for
 example:
@@ -2347,7 +2415,7 @@ that extensions/customizations are robust to change, extensions should only use
 
    
 Next: , Previous: , Up: Building Extensions and Advanced Customization of Org-roam   [Index]
    
 
-
    19.2.2 Accessing and Modifying Nodes
    
+
    20.2.2 Accessing and Modifying Nodes
    
 
 
    The node interface is cleanly defined using cl-defstruct. The primary
 method to access nodes is org-roam-node-at-point and org-roam-node-read:
@@ -2396,7 +2464,7 @@ making it available for use in capture templates.
 
    
 Previous: , Up: Building Extensions and Advanced Customization of Org-roam   [Index]
    
 
-
    19.2.3 Extending the Capture System
    
+
    20.2.3 Extending the Capture System
    
 
 
    Org-roam applies some patching over Org’s capture system to smooth out the user
 experience, and sometimes it is desirable to use Org-roam’s capturing system
@@ -2433,7 +2501,7 @@ When GOTO is non-nil, go the note without creating an entry."
 
    
 Next: , Previous: , Up: Top   [Index]
    
 
-
    20 Appendix
    
+
    21 Appendix
    
 
 
    
 
    • Note-taking Workflows  
@@ -2447,7 +2515,7 @@ Next: , P
 
    
 Next: , Up: Appendix   [Index]
    
 
-
    20.1 Note-taking Workflows
    
+
    21.1 Note-taking Workflows
    
 
 
    
 
+
    
+
    
+
    
+Previous: , Up: Top   [Index]
    
+
    
+
    E Bibliography
    
+
+
    NO_ITEM_DATA:key
+
    
 
    Emacs 28.0.50 (Org mode 9.5)
 
    
 
    
diff --git a/org-roam.org b/org-roam.org
index 33817d6..17c7c25 100644
--- a/org-roam.org
+++ b/org-roam.org
@@ -646,6 +646,49 @@ Org-roam also provides some functions to add or remove refs.
 
   Remove a ref from the node at point.
 
+* Citations
+
+Since version 9.5, Org has first-class support for citations. Org-roam supports
+the caching of both these in-built citations (of form ~[cite:@key]~) and [[https://github.com/jkitchin/org-ref][org-ref]]
+citations (of form cite:key).
+
+Org-roam attempts to load both the ~org-ref~ and ~org-cite~ package when
+indexing files, so no further setup from the user is required for citation
+support.
+
+** Using the Cached Information
+
+It is common to use take reference notes for academic papers. To designate the
+node to be the canonical node for the academic paper, we can use its unique
+citation key:
+
+#+begin_src org
+,* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: @thrun2005probabilistic
+:END:
+#+end_src
+
+for ~org-cite~, or:
+
+#+begin_src org
+,* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: cite:thrun2005probabilistic
+:END:
+#+end_src
+
+for ~org-ref~.
+
+When another node has a citation for that key, we can see it using the
+~Reflinks~ section of the Org-roam buffer.
+
+Extension developers may be interested in retrieving the citations within their
+notes. This information can be found within the ~citation~ table of the Org-roam
+database.
+
 * Completion
 
 Completions for Org-roam are provided via ~completion-at-point~. Org-roam
diff --git a/org-roam.texi b/org-roam.texi
index dc310c8..a07f6ea 100644
--- a/org-roam.texi
+++ b/org-roam.texi
@@ -70,6 +70,7 @@ General Public License for more details.
 * Customizing Node Caching::
 * The Org-roam Buffer::
 * Node Properties::
+* Citations::
 * Completion::
 * Encryption::
 * Org-roam Protocol::
@@ -86,6 +87,7 @@ General Public License for more details.
 * Command Index::
 * Function Index::
 * Variable Index::
+* Bibliography: Bibliography (1). 
 
 @detailmenu
 --- The Detailed Node Listing ---
@@ -126,6 +128,10 @@ Node Properties
 * Tags::
 * Refs::
 
+Citations
+
+* Using the Cached Information::
+
 Completion
 
 * Completing within Link Brackets::
@@ -250,7 +256,7 @@ available to Emacs.
 
 Org-roam is a tool that will appear unfriendly to anyone unfamiliar with Emacs
 and Org-mode, but it is also extremely powerful to those willing to put effort
-inn mastering the intricacies. Org-roam stands on the shoulders of giants. Emacs
+in mastering the intricacies. Org-roam stands on the shoulders of giants. Emacs
 was first created in 1976, and remains the tool of choice for many for editing
 text and designing textual interfaces. The malleability of Emacs allowed the
 creation of Org-mode, an all-purpose plain-text system for maintaining TODO
@@ -637,8 +643,8 @@ The @code{file-truename} function is only necessary when you use symbolic links
 inside @code{org-roam-directory}: Org-roam does not resolve symbolic links.
 
 Next, we setup Org-roam to run functions on file changes to maintain cache
-consistency. This is achieved by running @code{M-x org-roam-db-autosync-mode~}.
-To ensure that Org-roam is available on startup, place this in your Emacs
+consistency. This is achieved by running @code{M-x org-roam-db-autosync-mode}. To
+ensure that Org-roam is available on startup, place this in your Emacs
 configuration:
 
 @lisp
@@ -995,6 +1001,55 @@ ref to add.
 Remove a ref from the node at point.
 @end defun
 
+@node Citations
+@chapter Citations
+
+Since version 9.5, Org has first-class support for citations. Org-roam supports
+the caching of both these in-built citations (of form @code{[cite:@@key]}) and @uref{https://github.com/jkitchin/org-ref, org-ref}
+citations (of form (NO@math{_ITEM}@math{_DATA}:key)).
+
+Org-roam attempts to load both the @code{org-ref} and @code{org-cite} package when
+indexing files, so no further setup from the user is required for citation
+support.
+
+@menu
+* Using the Cached Information::
+@end menu
+
+@node Using the Cached Information
+@section Using the Cached Information
+
+It is common to use take reference notes for academic papers. To designate the
+node to be the canonical node for the academic paper, we can use its unique
+citation key:
+
+@example
+* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: @@thrun2005probabilistic
+:END:
+@end example
+
+for @code{org-cite}, or:
+
+@example
+* Probabilistic Robotics
+:PROPERTIES:
+:ID:       51b7b82c-bbb4-4822-875a-ed548cffda10
+:ROAM_REFS: cite:thrun2005probabilistic
+:END:
+@end example
+
+for @code{org-ref}.
+
+When another node has a citation for that key, we can see it using the
+@code{Reflinks} section of the Org-roam buffer.
+
+Extension developers may be interested in retrieving the citations within their
+notes. This information can be found within the @code{citation} table of the Org-roam
+database.
+
 @node Completion
 @chapter Completion
 
@@ -1331,12 +1386,12 @@ here.
 This template means don't insert any content, but place the cursor here.
 
 @item
-@code{:target} is a compulsory specification in the Org-roam capture
-template. The first element of the list indicates the type of the
-target, the second element indicates the location of the captured
-node, and the rest of the elements indicate prefilled template that
-will be inserted and the position of the point will be adjusted for.
-The latter behavior various from type to type of the capture target.
+@code{:target} is a compulsory specification in the Org-roam capture template. The
+first element of the list indicates the type of the target, the second
+element indicates the location of the captured node, and the rest of the
+elements indicate prefilled template that will be inserted and the position
+of the point will be adjusted for. The latter behavior various from type to
+type of the capture target.
 
 @item
 @code{:unnarrowed t} tells org-capture to show the contents for the whole file,
@@ -2121,5 +2176,10 @@ When GOTO is non-nil, go the note without creating an entry."
 
 @printindex vr
 
+@node Bibliography (1)
+@chapter Bibliography
+
+NO@math{_ITEM}@math{_DATA}:key
+
 Emacs 28.0.50 (Org mode 9.5)
 @bye