tfelypoc/-._protesilaos-s-___denote___.-
tfelypoc/-._protesilaos-s-___denote___.-
1
1
Fork 0
Code Issues Projects 1 Releases Activity

Note the features of filenames for search/filter

Browse source
This commit is contained in:
Protesilaos Stavrou 2022-06-21 08:36:45 +03:00
parent 047b396f16
commit a5986742be
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
1 changed files with 31 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
README.org
View file

@ -245,7 +245,7 @@ say, ="\\([0-9T]+?\\)--\\(.*?\\)_"= captures the date in group =\1= and
the title in =\2= (test any regular expression in the current buffer by
invoking =M-x re-builder=).
[[#h:8ed2bb6f-b5be-4711-82e9-8bee5bb06ece][Extending Denote]].
[[#h:1a953736-86c2-420b-b566-fb22c97df197][Features of the file-naming scheme for searching or filtering]].
While Denote is an Emacs package, notes should work long-term and not
depend on the functionality of a specific program. The file-naming
@ -270,6 +270,36 @@ holds the relevant value. In simple terms:
+ Keywords should not have spaces or other delimiters. If they do, they
are converted into hyphens. Keywords are always downcased.
** Features of the file-naming scheme for searching or filtering
:PROPERTIES:
:CUSTOM_ID: h:1a953736-86c2-420b-b566-fb22c97df197
:END:
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.
* Points of entry
:PROPERTIES:
:CUSTOM_ID: h:17896c8c-d97a-4faa-abf6-31df99746ca6