[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/denote 8565d36e7d 161/355: Add note in the manual about
From: |
ELPA Syncer |
Subject: |
[elpa] externals/denote 8565d36e7d 161/355: Add note in the manual about journal/diary |
Date: |
Sun, 26 Jun 2022 23:58:18 -0400 (EDT) |
branch: externals/denote
commit 8565d36e7dc86391cb4a7b64f5c51037f1c23c0a
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
Add note in the manual about journal/diary
---
README.org | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 71 insertions(+)
diff --git a/README.org b/README.org
index 610e5c5ee9..c6dd8a9551 100644
--- a/README.org
+++ b/README.org
@@ -742,10 +742,81 @@ This will allow things to work smoothly (e.g.
~denote-infer-keywords~).
Your default ~denote-directory~ does not need this, as it already is the
normal target that Denote uses.
+Want to automate aspects of note creation
([[#h:4a6d92dd-19eb-4fcc-a7b5-05ce04da3a92][Keep a journal or diary]])?
Have more ideas? Something does not work quite right? Areas you wish
were more abstract in the code? Please participate in the development
process.
+** Keep a journal or diary
+:PROPERTIES:
+:CUSTOM_ID: h:4a6d92dd-19eb-4fcc-a7b5-05ce04da3a92
+:END:
+
+While there are subtle technical differences between a journal and a
+diary, we will consider those equivalent in the interest of brevity:
+they both describe a personal space that holds a record of your thoughts
+about your experiences and/or view of events in the world.
+
+Suppose you are committed to writing an entry every day. Unlike what we
+demonstrated before, your writing will follow a regular naming pattern
+([[#h:f34b172b-3440-446c-aec1-bf818d0aabfe][Notes in multiple file types]]).
You know that the title of the new note
+must always look like =Tuesday 14 June 2022= and the keyword has to be
+=journal= or =diary=. As such, you want to automate the task instead of
+being prompted each time, as is the norm with ~denote~ and the relevant
+commands ([[#h:17896c8c-d97a-4faa-abf6-31df99746ca6][Points of entry]]). This
is easy to accomplish because ~denote~
+can be called from Lisp and given the required arguments of =TITLE= and
+=KEYWORDS= directly. All you need is a simple wrapper function:
+
+#+begin_src emacs-lisp
+(defun my-denote-journal ()
+ "Create an entry tagged 'journal' with the date as its title."
+ (interactive)
+ (denote
+ (format-time-string "%A %e %B %Y") ; format like Tuesday 14 June 2022
+ "journal")) ; multiple keywords are a list of strings: '("one" "two")
+#+end_src
+
+By invoking ~my-denote-journal~ you will go straight into the newly
+created note and commit to your writing outright.
+
+Sometimes journaling is done with the intent to hone one's writing
+skills. Perhaps you are learning a new language or wish to communicate
+your ideas with greater clarity and precision. As with everything that
+requires a degree of sophistication, you have to work for it---write,
+write, write!
+
+One way to test your progress is to set a timer. It helps you gauge
+your output and its quality. To use a timer with Emacs, consider the
+=tmr= package:
+
+#+begin_src emacs-lisp
+(defun my-denote-journal-with-tmr ()
+ "Like `my-denote-journal', but also set a 10-minute timer.
+The `tmr' command is part of the `tmr' package."
+ (interactive)
+ (denote
+ (format-time-string "%A %e %B %Y")
+ "journal")
+ (tmr 10 "Practice writing in my journal")) ; set 10 minute timer with a
description
+#+end_src
+
+Once the timer elapses, stop writing and review your performance.
+Practice makes perfect!
+
+[ As Denote matures, we may add hooks to control what happens before or
+ after the creation of a new note. We shall also document more
+ examples of tasks that can be accomplished with this package. ]
+
+Sources for =tmr=:
+
++ Package name (GNU ELPA): =tmr=
++ Official manual: <https://protesilaos.com/emacs/tmr>
++ Git repo on SourceHut: <https://git.sr.ht/~protesilaos/tmr>
+ - Mirrors:
+ + GitHub: <https://github.com/protesilaos/tmr>
+ + GitLab: <https://gitlab.com/protesilaos/tmr>
++ Mailing list: <https://lists.sr.ht/~protesilaos/tmr>
+
* Extending Denote
:PROPERTIES:
:CUSTOM_ID: h:8ed2bb6f-b5be-4711-82e9-8bee5bb06ece
- [elpa] externals/denote 0cb5c9f06e 122/355: Simplify attribution comment to ox-hugo, (continued)
- [elpa] externals/denote 0cb5c9f06e 122/355: Simplify attribution comment to ox-hugo, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 79fbe2493b 135/355: Merge pull request #11 from kaushalmodi/update-identifier-regexp, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 808a2c29f9 140/355: Acknowledge Peter Povinec for file-naming refinements, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 083b3bfc89 144/355: Use better example for file renaming, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 561553db8e 132/355: fix: Use the correct match subgroup in `denote-link--find-value`, ELPA Syncer, 2022/06/27
- [elpa] externals/denote e1c18f5f57 136/355: Remove potentially bad advice from the manual, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 7b719e6274 152/355: Add user option to disable multi-word keywords, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 25fa79e8d9 146/355: Refine denote-retrieve internals, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 0165b00ddb 145/355: Use only denote-retrieve functions in denote-link, ELPA Syncer, 2022/06/27
- [elpa] externals/denote f57e9c5c9f 165/355: Change internal variable symbols for consistency, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 8565d36e7d 161/355: Add note in the manual about journal/diary,
ELPA Syncer <=
- [elpa] externals/denote be58aec5db 163/355: Include journal sample that prompts for TITLE, ELPA Syncer, 2022/06/27
- [elpa] externals/denote d66312e517 172/355: Fix regression in file extension caused by f57e9c5, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 553c10a9cc 178/355: Tweak doc string, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 8e6e2736dc 174/355: Add generic denote-link-find-file, ELPA Syncer, 2022/06/27
- [elpa] externals/denote b54dd3404d 186/355: Tweak doc string, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 5195f13f55 197/355: Add optional absolute for denote--directory-files, ELPA Syncer, 2022/06/27
- [elpa] externals/denote a160d9f147 196/355: Fix typo in the manual, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 3654f902e6 210/355: Accept optional group in denote-retrieve--search, ELPA Syncer, 2022/06/27
- [elpa] externals/denote aab21a74dd 194/355: Register 'denote:' custom Org hyperlink type, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 4dc46d1b68 185/355: Set denote-link-fontify-backlinks to t by default, ELPA Syncer, 2022/06/27