gnu-emacs-sources
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[GNU ELPA] Denote version 3.1.0


From: ELPA update
Subject: [GNU ELPA] Denote version 3.1.0
Date: Wed, 04 Sep 2024 17:04:52 -0400

Version 3.1.0 of package Denote has just been released in GNU ELPA.
You can now find it in M-x list-packages RET.

Denote describes itself as:

  =================================================
  Simple notes with an efficient file-naming scheme
  =================================================

More at https://elpa.gnu.org/packages/denote.html

## Summary:

             ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                   DENOTE: SIMPLE NOTES WITH AN EFFICIENT
                             FILE-NAMING SCHEME

                            Protesilaos Stavrou
                            info@protesilaos.com
             ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


  This manual, written by Protesilaos Stavrou, describes the customization
  options for the Emacs package called `denote' (or `denote.el'), and
  provides every other piece of information pertinent to it.

  The documentation furnished herein corresponds to stable version 3.1.0,
  released on 2024-09-04.  Any reference to a newer feature which does not
  yet form part of the latest tagged commit, is explicitly marked as such.

  Current development target is 3.2.0-dev.

## Recent NEWS:

                         ━━━━━━━━━━━━━━━━━━━━━━
                          CHANGE LOG OF DENOTE

                          Protesilaos Stavrou
                          info@protesilaos.com
                         ━━━━━━━━━━━━━━━━━━━━━━


This document contains the release notes for each tagged commit on the
project’s main git repository: <https://github.com/protesilaos/denote>.

The newest release is at the top.  For further details, please consult
the manual: <https://protesilaos.com/emacs/denote>.

Table of Contents
─────────────────

1. Version 3.1.0 on 2024-09-04


1 Version 3.1.0 on 2024-09-04
═════════════════════════════

  Denote is stable and reliable though we keep adding minor refinements
  to it. Remember that many—if not all—of these are intended for
  experienced users who have developed their own workflow and want to
  adapt Denote to its particularities. We may call them “power users”.

  New users do not need to know about every single feature. A basic
  configuration is enough and is why the original video I did about
  Denote (from even before I published version `0.1.0') is still
  relevant.  For example:

  ┌────
  │ ;; Start with something like this.
  │ (use-package denote
  │   :ensure t
  │   :bind
  │   (("C-c n n" . denote)
  │    ("C-c n r" . denote-rename-file)
  │    ("C-c n i" . denote-link) ; "insert" mnemonic
  │    ("C-c n b" . denote-backlinks))
  │   :config
  │   (setq denote-directory (expand-file-name "~/Documents/notes/")))
  └────

  And here is the same idea with a little bit more convenience:

  ┌────
  │ ;; Another basic setup with a little more to it.
  │ (use-package denote
  │   :ensure t
  │   :hook (dired-mode . denote-dired-mode)
  │   :bind
  │   (("C-c n n" . denote)
  │    ("C-c n r" . denote-rename-file)
  │    ("C-c n l" . denote-link)
  │    ("C-c n b" . denote-backlinks))
  │   :config
  │   (setq denote-directory (expand-file-name "~/Documents/notes/"))
  │ 
  │   ;; Automatically rename Denote buffers when opening them so that
  │   ;; instead of their long file name they have a literal "[D]"
  │   ;; followed by the file's title.  Read the doc string of
  │   ;; `denote-rename-buffer-format' for how to modify this.
  │   (denote-rename-buffer-mode 1))
  └────


1.1 The `denote-sort-dired' command is more configurable
────────────────────────────────────────────────────────

  The `denote-sort-dired' command asks for a literal string or regular
  expression and then produces a fully fledged Dired listing of matching
  files in the `denote-directory'. Combined with the efficient Denote
  file-naming scheme, this is a killer feature to collect your relevant
  files in a consolidated view and have the full power of Dired
  available.

  By default `denote-sort-dired' prompts for the file name component to
  sort by and then asks whether to reverse the sorting or not. Users who
  want a more streamlined experience can configure the user option
  `denote-sort-dired-extra-prompts'.

  It is possible to skip the prompts altogether and use the default
  values for (i) which component to sort by and (ii) whether to reverse
  the sort. To this end, users can have something like this in their
  configuration:

  ┌────
  │ ;; Do not issue any extra prompts.  Always sort by the `title' file
  │ ;; name component and never do a reverse sort.
  │ (setq denote-sort-dired-extra-prompts nil)
  │ (setq denote-sort-dired-default-sort-component 'title)
  │ (setq denote-sort-dired-default-reverse-sort nil)
  └────

  For me, Dired is one of the best things about Emacs and I like how it
  combines so nicely with Denote file names (this is the cornerstone of
  Denote, after all).


1.2 The `denote-sort-dired' sorting functions are customisable
──────────────────────────────────────────────────────────────

  Power users may want to control how the sorting works and what it is
  matching on a per file-name-component basis. The user options are
  these:

  • `denote-sort-title-comparison-function'.
  • `denote-sort-keywords-comparison-function'.
  • `denote-sort-signature-comparison-function'.

  One use-case is to match specific patterns inside of file names, such
  …  …

reply via email to

[Prev in Thread] Current Thread [Next in Thread]