GNU-devel ELPA - denote-review

Open and revew a denote note. Add or update the date in the the frontmatter field reviewdate. with the command M-x denote-review-set-date.

To make this easy, bind this command to a key, f.e.:

(define-key global-map (kbd "C-c n x") #'denote-review-set-date)

• When the frontmatter of the note doesn't contain the reviewdate field, it will be inserted, with the current date as review date.
• When the reviewdate field is already part of the frontmatter, the review date will be updated with the current date.

The default location of the reviewdate frontmatter is right below the identifier frontmatter line. This can be customized by setting the useroption denote-review-insert-after.

For example, to insert the reviewdate right below the "date" frontmatter, add the following to your Emacs configuration:

(setopt denote-review-insert-after "date")

Example screenshot of the frontmatter of a note:

The command M-x denote-review-display-list creates a tabulated list of the notes that contain the reviewdate frontmatter. Notes without a reviewdate are ignored.

It evaluates the value of the variables denote-directory and denote-silo-directories. When there is more than one directory, it prompts the user to select a directory, using completion.

Example screenshot of the tabulated list with some notes:

[Note: The filenames in the screenshots based on headers in the README from Protesilaos Stavrou, see https://protesilaos.com/emacs/denote ]

Default the list is ordered by review date, from the oldest to the newest. Click on a column header to change the order.

• Click on a column to order according to the column contents.
• Click again to reverse the order.
• The key S (shift-s) in a column performs the same actions.

Move point up or down to select a note. Open or view the note with one of the keys RET, e, or o. Or request a random file from the list with r. After editing and/or updating the review date, refresh the list with g.

Key bindings in the tabulated list:

Specific key bindings:

• RET : Open and edit the note in another window.
• e : Open and edit the note.
• o : Open the note in read only mode in another window.
• r : Open a random note from the list in another window.

General tabulated list key bindings:

• g : Update the tabulated list.
• n : Goto next line.
• p : Goto previous line.
• SPC : Scroll up.
• DEL : (Backspace) Scroll down.
• S-SPC: Scroll down.
• q : Close the buffer with the tabulated list.

For more, use M-x describe-mode (C-h m) in the buffer.

There is no undo for this function. To play it safe, first commit your notes to a revision management system like Git, or make a backup of the directory.

• Open a denote directory in Dired.
• Mark one or more notes.
• Issue the command M-x denote-review-set-date-dired-marked-files.

This will insert the reviewdate frontmatter in all selected notes, with a date according to the identifier in the filename.

For example, the note 20240117T203111--add-a-query-link__demo_denote.org will get 2024-01-17 as review date.

Notes where the reviewdate field is already part of the frontmatter will be left untouched.

There is no undo for this function. To play it safe, first commit your notes to a revision management system like Git, or make a backup of the directory.

How to bulk insert the current date as review date:

• Open the denote directory in Dired.
• Mark one or more notes.
• Enter the Universal Argument C-u
• Issue the command M-x denote-review-set-date-dired-marked-files.

This will insert the reviewdate frontmatter in all selected notes, with the current date as review date.

Notes where the reviewdate field is already part of the frontmatter, will be left untouched.