branch: externals/denote
commit d90695213cba83381b42609831b01d18b2e09a7f
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Add minor clarifications in the manual
---
README.org | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/README.org b/README.org
index 5fafbef28e..c68e16ec17 100644
--- a/README.org
+++ b/README.org
@@ -656,8 +656,8 @@ type. It is entirely possible to store notes in a variety
of formats
across multiple directories and Denote will still be able to work with
them, provided they follow the file-naming scheme and have an identifier
in their front matter (where relevant). Here we show how to create new
-notes that deviate from the default value of ~denote-file-type~, specify
-their own ~denote-directory~, and even tweak the file's front matter.
+notes that deviate from the default value of ~denote-file-type~ and
+specify their own ~denote-directory~.
Suppose you want to conform with the default of creating notes with the
=.org= extension but, for whatever reason, wish to have a way to quickly
@@ -672,10 +672,13 @@ produce a file with the =.md= extension and
TOML-compliant front matter.
(call-interactively #'denote)))
#+end_src
+With the above, =M-x my-denote-markdown-toml= produces Markdown+TOML
+notes while =M-x denote= uses Org.
+
This principle can be taken a step further by ~let~ binding a second
directory for those alternative notes. Maybe your standard notes are
-located in =~/Documents/notes/= but you plan to store those alternative
-notes in =~/blog/= ([[#h:337f9cf0-9f66-45af-b73f-f6370472fb51][Fontification
in Dired]]).
+located in =~/Documents/notes/= but you plan to store the other ones in
+=~/blog/= ([[#h:337f9cf0-9f66-45af-b73f-f6370472fb51][Fontification in
Dired]]).
#+begin_src emacs-lisp
(setq denote-file-type nil)
@@ -689,7 +692,7 @@ notes in =~/blog/=
([[#h:337f9cf0-9f66-45af-b73f-f6370472fb51][Fontification in
#+end_src
Given Denote's composable code, you can tweak the output however you
-like ([[#h:f69371d5-1843-493d-9ff5-c1ab3b43024e][Tweaking the front matter]]).
+like, including the contents of the file
([[#h:f69371d5-1843-493d-9ff5-c1ab3b43024e][Tweaking the front matter]]).
If you do place different types of notes in their own directories,
consider introducing directory-local variables to keep things working
