From d1c6075a5f7d2902b82594c9ab3a92ae7f6d8d22 Mon Sep 17 00:00:00 2001
From: Gerard Vermeulen <gerard.vermeulen@neel.cnrs.fr>
Date: Thu, 17 Feb 2022 13:15:30 +0100
Subject: [PATCH] Explain how to use citar and print the bibliography

---
 README.org | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.org b/README.org
index dae1790..4b714fd 100644
--- a/README.org
+++ b/README.org
@@ -1342,6 +1342,26 @@ and =org=.
     (define-key org-mode-map (kbd "C-c b") #'org-cite-insert))
 #+end_src
 
+Ref. [cite:@Schulte.MCSE.2011.41] shows that [[https://orgmode.org/][Org-mode]] is a simple, plain-text
+markup language for hierarchical documents allowing intermingling of data, code,
+and prose.  It serves as an example link to to show how to use [[https://github.com/bdarcus/citar][Citar]] within this
+setup, provided that =citar-bibliography= and =citar-library-paths= point to
+valid directories and files.  In an [[https://orgmode.org/][Org-mode]] buffer this setup allows to:
+1. Insert an [[https://orgmode.org/][Org-mode]] cite link:
+   1. Type {{{kbd(C-c b)}}} or {{{kbd(M-x org-cite-insert)}}}.
+   2. Navigate to the bibliographic entry to insert.
+   3. Select it.
+2. View an electronic copy of an [[https://orgmode.org/][Org-mode]] cite link:
+   1. Move point to the [[https://orgmode.org/][Org-mode]] cite link.
+   2. Type {{{kbd(C-:)}}} or {{{kbd(M-x embark-dwim)}}}.
+   3. Navigate to the corresponding library file.
+   4. Select it.
+3. Open the DOI of an [[https://orgmode.org/][Org-mode]] cite link:
+   1. Move point to the [[https://orgmode.org/][Org-mode]] cite link.
+   2. Type {{{kbd(C-:)}}} or {{{kbd(M-x embark-dwim)}}}.
+   3. Navigate to the corresponding link.
+   4. Select it.
+
 *** TODO Compare bibtex and biblatex
 1. [[https://www.economics.utoronto.ca/osborne/latex/BIBTEX.HTM][Using bibtex: a short guide]]
 2. [[https://www.tug.org/texlive//devsrc/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf][The biblatex package]]
@@ -3156,6 +3176,8 @@ Listing [[lst:configure-goto-address-mode]]:
 
 Only the [[info:org#Top][Org]] source file shows the local variables footer.
 
+\printbibliography
+
 # Emacs looks for "Local variables:" after the last "\?n\?f".
 
 # Local Variables: