Commit graph

357 commits

Author SHA1 Message Date
Protesilaos Stavrou d4cbb974a5
Rewrite node on multi file types (due to b42f68c) 2022-06-13 15:04:25 +03:00
Protesilaos Stavrou b42f68c8e8
Add denote-type command 2022-06-13 15:04:08 +03:00
Protesilaos Stavrou e841a51ca7
Fix typo 2022-06-13 08:27:03 +03:00
Protesilaos Stavrou 6a286c97f8
Rephrase statement for clarity 2022-06-13 08:25:32 +03:00
Protesilaos Stavrou 97e8c30bcf
Rewrite the package Overview 2022-06-13 08:11:37 +03:00
Protesilaos Stavrou 7b719e6274
Add user option to disable multi-word keywords 2022-06-13 07:34:36 +03:00
Protesilaos Stavrou d90695213c
Add minor clarifications in the manual 2022-06-12 21:03:40 +03:00
Protesilaos Stavrou 86e437da43
Document .dir-locals.el for multi-type notes 2022-06-12 21:03:29 +03:00
Protesilaos Stavrou 890a335092
Add denote-dired-rename-expert user option 2022-06-12 17:17:25 +03:00
Protesilaos Stavrou e92137a548
Use file attribute for mod time while renaming
This means that if you are renaming "sample.pdf" from 2000-11-31 you
will get an identifier that reflects that date, instead of CURRENT-TIME.

Note that there are other file attributes for time.  Read the doc string
of 'file-attributes'.  If there is demand for it, we can add a user
option, otherwise I feel 'file-attribute-modification-time' is a
reasonable default.

Thanks to Jack Baty for proposing the idea over at the mailing list:
<https://lists.sr.ht/~protesilaos/denote/%3Cm2v8t6b45f.fsf@baty.net%3E>.
2022-06-12 16:54:22 +03:00
Protesilaos Stavrou ce41b421ef
Update denote-retrieve symbols in denote-link 2022-06-12 16:43:42 +03:00
Protesilaos Stavrou 25fa79e8d9
Refine denote-retrieve internals 2022-06-12 16:43:24 +03:00
Protesilaos Stavrou 0165b00ddb
Use only denote-retrieve functions in denote-link 2022-06-12 16:23:13 +03:00
Protesilaos Stavrou 083b3bfc89
Use better example for file renaming 2022-06-12 14:01:18 +03:00
Protesilaos Stavrou f55dee06b1
Add documentation about our minibuffer histories 2022-06-12 09:04:37 +03:00
Protesilaos Stavrou 171b873cb5
Require denote-retrieve (0e83bee) in denote-link
This should fix the error reported by Kaushal Modi in issue 12:
<https://github.com/protesilaos/denote/issues/12>.
2022-06-12 08:50:56 +03:00
Protesilaos Stavrou 0e83bee5b7
Add denote-retrieve for internal purposes
Basicallly we shall use it to extract data from a file.
2022-06-12 08:49:54 +03:00
Protesilaos Stavrou 808a2c29f9
Acknowledge Peter Povinec for file-naming refinements
Peter helped me make the file-naming scheme more effective.

I asked for permission to disclose this information, as it was done via
email.
2022-06-12 07:38:56 +03:00
Protesilaos Stavrou 0bda79ef19
Move heading further up in the manual 2022-06-12 05:45:28 +03:00
Protesilaos Stavrou 0e75e46b32
Improve denote-dired-rename-file
It now preserves the identifier, if it exists.  So if you want to change
the title/keywords in a note's front matter, this command can then be
called to also update the file name (maybe there is some way to automate
this, but let's leave it for now).
2022-06-12 05:34:33 +03:00
Protesilaos Stavrou bc93a8ecda
Update the manual on the matter of backlinks 2022-06-12 04:51:05 +03:00
Protesilaos Stavrou e1c18f5f57
Remove potentially bad advice from the manual
Thanks to Kaushal Modi for the feedback in issue 12 over at the GitHub
mirror: <https://github.com/protesilaos/denote/issues/12>.
2022-06-12 04:49:48 +03:00
Protesilaos Stavrou 79fbe2493b
Merge pull request #11 from kaushalmodi/update-identifier-regexp
Identifier regexp improvements (support TOML and Org ID)
2022-06-11 20:11:24 +03:00
Protesilaos Stavrou e394057985
Document how to store multiple types of notes 2022-06-11 20:06:42 +03:00
Kaushal Modi c9926a528e perf: Stop searching for the title or identifier after the 1st match
This also avoids any false matches with that regexp further down in
the note content.
2022-06-11 12:34:13 -04:00
Kaushal Modi 561553db8e fix: Use the correct match subgroup in denote-link--find-value
Also document that dependence on subgroup in doc strings.
2022-06-11 12:33:43 -04:00
Protesilaos Stavrou 28518416f3
Name the faces in the manual 2022-06-11 19:30:38 +03:00
Protesilaos Stavrou 112a12e6e5
Remove duplicate word from face names 2022-06-11 19:28:10 +03:00
Kaushal Modi 24371b4c86 fix: Update the identifier regexp to recognize TOML identifier too
Fixes issue 10 over at the Github mirror:
<https://github.com/protesilaos/denote/issues/10>.

This regexp update now also matches the ID property. Refer issue 8 at
the Github mirror: <https://github.com/protesilaos/denote/issues/8>.
2022-06-11 12:19:18 -04:00
Protesilaos Stavrou f91d2472c3
Make the field delimiter face a bit more subtle 2022-06-11 18:43:52 +03:00
Protesilaos Stavrou 142b628c2e
Apply distinct face to keyword delimiter
Thanks to svnsbck for suggesting the idea in issue 9 over at the GitHub
mirror: <https://github.com/protesilaos/denote/issues/9>.
2022-06-11 18:33:23 +03:00
Protesilaos Stavrou 8a35382067
Rename internal variable for clarity 2022-06-11 17:45:09 +03:00
Protesilaos Stavrou d83c166c0d
Fix regexp for keywords
Regression was caused by commit 7cba33e.  Thanks to svnsbck for
reporting the problem in issue 9 over at the GitHub mirror:
<https://github.com/protesilaos/denote/issues/9>.
2022-06-11 17:43:09 +03:00
Protesilaos Stavrou c225201c49
Use appropriate name for internal variable 2022-06-11 17:38:00 +03:00
Protesilaos Stavrou 11be1d6b40
Change "tml" to "toml" in denote-toml-front-matter
Thanks to Kaushal Modi for spotting the typo:
<73dc07ac00 (r75861972)>.
2022-06-11 17:32:22 +03:00
Protesilaos Stavrou 0cb5c9f06e
Simplify attribution comment to ox-hugo
Per its author's request:
<https://github.com/protesilaos/denote/issues/7#issuecomment-1152932554>.
2022-06-11 17:29:21 +03:00
Protesilaos Stavrou 0519be74a9
Add PROOF-OF-CONCEPT denote-link-backlinks 2022-06-11 16:37:39 +03:00
Protesilaos Stavrou a107fbf5d7
Make minor tweaks in the manual 2022-06-11 14:41:15 +03:00
Protesilaos Stavrou 7cba33e08e
LAST BREAKING CHANGE to file-naming scheme
The pattern now is:

    DATE--TITLE__KEYWORDS.EXTENSION

Multiple keywords are separated by underscores.  A multi-word keyword is
separated by hyphens:

    _two_keywords
    one-keyword-many-words

Also see the enforcement of sluggified keywords in commit 6000313.
2022-06-11 12:56:27 +03:00
Protesilaos Stavrou 6000313eec
Enforce sluggification of keywords; document it 2022-06-11 12:19:26 +03:00
Protesilaos Stavrou 60d64ca07c
Document ways to change the front matter 2022-06-11 09:38:13 +03:00
Protesilaos Stavrou c5a5748594
Abstract plain text front matter delimiter 2022-06-11 09:21:25 +03:00
Protesilaos Stavrou bca23b3e3d
Clarify how front matter variables are used
This "hidden option" lets the user do something like this (I prepend >
to escape the #):

>    (setq denote-org-front-matter
>          ":PROPERTIES:
>    :ID: %4$s
>    :END:
>    #+title:      %1$s
>    #+date:       %2$s
>    #+filetags:   %3$s
>    #+identifier: %4$s
>    \n")

Ultimately though, it gives us more flexibility if we ever want to
support extra features.

One such feature is the ability to create links using the org-id.el
library.  See issue 8 over at the GitHub mirror, with feedback from
Kaushal Modi: <https://github.com/protesilaos/denote/issues/8>.
2022-06-11 09:13:11 +03:00
Protesilaos Stavrou a70b4cd32d
Refine backlinks' heading per file type 2022-06-11 09:00:20 +03:00
Protesilaos Stavrou 73dc07ac00
Make front matter variables "public"
By removing the double hyphens, we indicate that these variables can be
relied upon by the user.  In other words: these are hidden customisation
options for those who want to maintain some Do-It-Yourself code.
2022-06-11 08:37:29 +03:00
Protesilaos Stavrou 254a6cd0f3
Update date function; enforce RFC3339 when needed
Thanks ot Kaushal Modi for the feedback in issue 7 over at the GitHub
mirror: <https://github.com/protesilaos/denote/issues/7>.
2022-06-11 08:33:46 +03:00
Protesilaos Stavrou 21e415e2e7
Remove obsolete symbol of command 2022-06-10 20:58:52 +03:00
Protesilaos Stavrou 82eeb381dc
Make all front matter abstractions consistent 2022-06-10 20:27:59 +03:00
Protesilaos Stavrou f1f9f757ef
Include markdown-toml sample in the manual
This concludes the work done on issue 4 over at the GitHub mirror with
the help of Kaushal Modi: <https://github.com/protesilaos/denote/issues/4>.
2022-06-10 20:16:11 +03:00
Protesilaos Stavrou 308322afab
Fix markdown-toml identifier value
Thanks to Kaushal Modi for the feedback in issue 4 over at the GitHub
mirror: <https://github.com/protesilaos/denote/issues/4>.
2022-06-10 20:11:48 +03:00