[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/denote 9f3047be4a 17/22: Update file-naming scheme feat
From: |
ELPA Syncer |
Subject: |
[elpa] externals/denote 9f3047be4a 17/22: Update file-naming scheme features to cover optional signatures |
Date: |
Mon, 20 Mar 2023 05:58:01 -0400 (EDT) |
branch: externals/denote
commit 9f3047be4a953276193bfa89e747f8d072f16c5b
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
Update file-naming scheme features to cover optional signatures
---
README.org | 50 +++++++++++++++++++++++++++++---------------------
1 file changed, 29 insertions(+), 21 deletions(-)
diff --git a/README.org b/README.org
index a9fc8b3392..565f6f8368 100644
--- a/README.org
+++ b/README.org
@@ -1268,30 +1268,38 @@ holds the relevant value. In simple terms:
:CUSTOM_ID: h:1a953736-86c2-420b-b566-fb22c97df197
:END:
-File names have three fields and two sets of field delimiters between
-them:
+By default, file names have three fields and two sets of field
+delimiters between them:
: DATE--TITLE__KEYWORDS.EXTENSION
-The first field delimiter is the double hyphen, while the second is the
-double underscore. These practically serve as anchors for easier
-searching. Consider this example:
-
-: 20220621T062327--introduction-to-denote__denote_emacs.txt
-
-You will notice that there are two matches for the word =denote=: one in
-the title field and another in the keywords' field. Because of the
-distinct field delimiters, if we search for =-denote= we only match the
-first instance while =_denote= targets the second one. When sorting
-through your notes, this kind of specificity is invaluable---and you get
-it for free from the file names alone!
-
-Users can get a lot of value out of this simple arrangement, even if
-they have no knowledge of regular expressions. One thing to consider,
-for maximum effect, is to avoid using multi-word keywords as those get
-hyphenated like the title and will thus interfere with the above: either
-set the user option ~denote-allow-multi-word-keywords~ to nil or simply
-insert single words at the relevant prompts.
+When a signature is present, this becomes:
+
+: DATE==SIGNATURE--TITLE__KEYWORDS.EXTENSION
+
+[ Signatures are part of {{{development-version}}}. ]
+
+Field delimiters practically serve as anchors for easier searching.
+Consider this example:
+
+: 20220621T062327==1a2--introduction-to-denote__denote_emacs.txt
+
+You will notice that there are two matches for the word =denote=: one
+in the title field and another in the keywords' field. Because of the
+distinct field delimiters, if we search for =-denote= we only match
+the first instance while =_denote= targets the second one. When
+sorting through your notes, this kind of specificity is
+invaluable---and you get it for free from the file names alone!
+Similarly, a search for ==1= will show all notes that are related to
+each other by virtue of their signature.
+
+Users can get a lot of value out of this simple yet effective
+arrangement, even if they have no knowledge of regular expressions.
+One thing to consider, for maximum effect, is to avoid using
+multi-word keywords as those get hyphenated like the title and will
+thus interfere with the above: either set the user option
+~denote-allow-multi-word-keywords~ to nil or simply insert single
+words at the relevant prompts.
* Front matter
:PROPERTIES:
- [elpa] externals/denote bb8af7362c 14/22: Document 'denote-prompts' signature in the manual, (continued)
- [elpa] externals/denote bb8af7362c 14/22: Document 'denote-prompts' signature in the manual, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 833fa1a210 02/22: Make denote--path use signature only if present, ELPA Syncer, 2023/03/20
- [elpa] externals/denote d73b0429c7 06/22: Add signature to 'denote-prompts' :type, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 84425fc328 11/22: Notify users that 'denote-faces-signature' was added in development version, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 6cd886cc52 10/22: Relocate denote-retrieve-filename-signature, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 0ea65a07c6 12/22: Refine denote-faces--file-name-regexp for fontification, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 33a59e0c8b 15/22: Document 'denote-signature' helper command, ELPA Syncer, 2023/03/20
- [elpa] externals/denote f6aa81a961 16/22: Update file-naming scheme docs to cover optional signatures, ELPA Syncer, 2023/03/20
- [elpa] externals/denote d7dc32cb42 21/22: Rename development-version to 2.0.0, ELPA Syncer, 2023/03/20
- [elpa] externals/denote ccdee2e549 20/22: Document all SIGNATURE symbols in section for developers, ELPA Syncer, 2023/03/20
- [elpa] externals/denote 9f3047be4a 17/22: Update file-naming scheme features to cover optional signatures,
ELPA Syncer <=
- [elpa] externals/denote 62c6853480 22/22: MAJOR UPDATE towards version 2.0.0: Merge branch 'signature', ELPA Syncer, 2023/03/20