[elpa] externals/denote 8cea6af04c 1/2: Expand node for directory silos

[ELPA Syncer]

branch: externals/denote
commit 8cea6af04c27b2cd4730059c80486dfeeadad89b
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Expand node for directory silos
    
    Thanks to Viktor Haag for asking a question on the mailing list that
    inspired me to produce this entry:
    
<https://lists.sr.ht/~protesilaos/denote/%3CCANnkwC6NLd0VneUEqFrjh7TCUBLBgEtLCcPwM37JDvJXJCShVQ%40mail.gmail.com%3E>.
---
 README.org | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 57 insertions(+), 2 deletions(-)

diff --git a/README.org b/README.org
index 3ccbdd6892..c0ac2771cf 100644
--- a/README.org
+++ b/README.org
@@ -593,6 +593,61 @@ In concrete terms, this is a representation of the 
directory structures
 `-- 20220620T181255--the-third-test__keyword.org
 #+end_example
 
+It is possible to configure other user options of Denote to have a
+silo-specific value.  For example, this one changes the
+~denote-known-keywords~ only for this particular silo:
+
+#+begin_src emacs-lisp
+;;; Directory Local Variables.  For more information evaluate:
+;;;
+;;;     (info "(emacs) Directory Variables")
+
+((nil . ((denote-directory . default-directory)
+         (denote-known-keywords . ("food" "drink")))))
+#+end_src
+
+This one is like the above, but also disables ~denote-infer-keywords~:
+
+#+begin_src emacs-lisp
+;;; Directory Local Variables.  For more information evaluate:
+;;;
+;;;     (info "(emacs) Directory Variables")
+
+((nil . ((denote-directory . default-directory)
+         (denote-known-keywords . ("food" "drink"))
+         (denote-infer-keywords . nil))))
+#+end_src
+
+To expand the list of local variables to, say, cover specific major
+modes, we can do something like this:
+
+#+begin_src emacs-lisp
+;;; Directory Local Variables.  For more information evaluate:
+;;;
+;;;     (info "(emacs) Directory Variables")
+
+((nil . ((denote-directory . default-directory)
+         (denote-known-keywords . ("food" "drink"))
+         (denote-infer-keywords . nil)))
+ (org-mode . ((org-hide-emphasis-markers . t)
+              (org-hide-macro-markers . t)
+              (org-hide-leading-stars . t))))
+#+end_src
+
+As not all user options have a "safe" local value, Emacs will ask the
+user to confirm their choice and to store it in the Custom code
+snippet that is normally appended to init file (or added to the file
+specified by the user option ~custom-file~).
+
+Finally, it is possible to have a =.dir-locals.el= for subdirectories
+of any ~denote-directory~.  Perhaps to specify a different set of
+known keywords, while not making the subdirectory a silo in its own
+right.  We shall not expand on such an example, as we trust the user
+to experiment with the best setup for their workflow.
+
+Feel welcome to ask for help if the information provided herein is not
+sufficient.  The manual shall be expanded accordingly.
+
 * Renaming files
 :PROPERTIES:
 :CUSTOM_ID: h:532e8e2a-9b7d-41c0-8f4b-3c5cbb7d4dca
@@ -3354,8 +3409,8 @@ Denote is meant to be a collective effort.  Every bit of 
help matters.
   Federico Stilman, Florian, Frank Ehmsen, Guo Yong, Hanspeter Gisler,
   Jack Baty, Jeremy Friesen, Juanjo Presa, Kaushal Modi, M. Hadi
   Timachi, Paul van Gelder, Peter Prevos, Shreyas Ragavan, Summer
-  Emacs, Sven Seebeck, Taoufik, Yi Liu, Ypot, atanasj, hpgisler,
-  pRot0ta1p, sienic, sundar bp.
+  Emacs, Sven Seebeck, Taoufik, Viktor Haag, Yi Liu, Ypot, atanasj,
+  hpgisler, pRot0ta1p, sienic, sundar bp.
 
 Special thanks to Peter Povinec who helped refine the file-naming
 scheme, which is the cornerstone of this project.