[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/denote 80eb7528aa 335/355: doc: Update documentation
From: |
ELPA Syncer |
Subject: |
[elpa] externals/denote 80eb7528aa 335/355: doc: Update documentation |
Date: |
Sun, 26 Jun 2022 23:58:37 -0400 (EDT) |
branch: externals/denote
commit 80eb7528aa06558314a5a363da1b623c669c531d
Author: Kaushal Modi <kaushal.modi@gmail.com>
Commit: Kaushal Modi <kaushal.modi@gmail.com>
doc: Update documentation
---
README.org | 87 +++++++++++++++++++++++++++++++++-----------------------------
1 file changed, 47 insertions(+), 40 deletions(-)
diff --git a/README.org b/README.org
index d297c97d0c..68e3f933a1 100644
--- a/README.org
+++ b/README.org
@@ -485,36 +485,38 @@ derived automatically.
This is how it looks for Org mode (~denote-file-type~ is nil):
-#+begin_example
-#+title: This is a sample note
-#+date: 2022-06-10
-#+filetags: denote testing
-#+identifier: 20220610T202537
-#+end_example
+#+begin_src org
+:PROPERTIES:
+:ID: 20220610T202537
+:END:
+,#+title: This is a sample note
+,#+date: 2022-06-10
+,#+filetags: denote testing
+#+end_src
For Markdown with YAML, it looks like this (~denote-file-type~ has the
=markdown-yaml= value):
-#+begin_example
+#+begin_src md
---
title: "This is a sample note"
date: 2022-06-10
tags: denote testing
identifier: "20220610T202021"
---
-#+end_example
+#+end_src
For Markdown with TOML, it looks like this (~denote-file-type~ has the
=markdown-toml= value):
-#+begin_example
+#+begin_src md
+++
title = "This is a sample note"
date = 2022-06-10
tags = ["denote", "testing"]
identifier = "20220610T201510"
+++
-#+end_example
+#+end_src
And for plain text, we have the following (~denote-file-type~ has the
=text= value):
@@ -567,10 +569,12 @@ what we have in =denote.el=:
#+begin_src emacs-lisp
(defvar denote-org-front-matter
- "#+title: %s
+ ":PROPERTIES:
+:ID: %4$s
+:END:
+#+title: %s
#+date: %s
#+filetags: %s
-#+identifier: %s
\n"
"Org front matter value for `format'.
The order of the arguments is TITLE, DATE, KEYWORDS, ID. If you
@@ -579,43 +583,46 @@ how front matter is produced, consider using something
like %2$s
to control where Nth argument is placed.")
#+end_src
-The default front matter is:
+Notice how we can pass a number to the =%s= specifier for the =:ID:=
+property. This is what allows us to change the placement of the
+provided arguments.
-#+begin_example
-#+title: This is a sample note
-#+date: 2022-06-10
-#+filetags: denote testing
-#+identifier: 20220610T202537
-#+end_example
+The default Org mode front matter is formatted as:
+
+#+begin_src org
+:PROPERTIES:
+:ID: 20220610T202537
+:END:
+,#+title: This is a sample note
+,#+date: 2022-06-10
+,#+filetags: denote testing
+#+end_src
-We can add a =PROPERTIES= drawer to it, with something like this:
+If the user does not need =org-id= compatible ID property drawer, they
+can do this instead:
#+begin_src emacs-lisp
(setq denote-org-front-matter
- ":PROPERTIES:
-:ID: %4$s
-:END:
-#+title: %1$s
-#+date: %2$s
-#+filetags: %3$s
-#+identifier: %4$s
-\n")
+ "#+title: %s
+,#+date: %s
+,#+filetags: %s
+,#+identifier: %s
+\n"
+ "Org front matter value for `format'.
+The order of the arguments is TITLE, DATE, KEYWORDS, ID. If you
+are an avdanced user who wants to edit this variable to affect
+how front matter is produced, consider using something like %2$s
+to control where Nth argument is placed.")
#+end_src
The output is now formatted thus:
-#+begin_example
-:PROPERTIES:
-:ID: 20220611T092444
-:END:
-#+title: This is a sample note
-#+date: 2022-06-11
-#+filetags: denote testing
-#+identifier: 20220611T092444
-#+end_example
-
-Notice how we can pass a number to the =%s= specifier. This is what
-allows us to change the placement of the provided arguments.
+#+begin_src org
+,#+title: This is a sample note
+,#+date: 2022-06-10
+,#+filetags: denote testing
+,#+identifier: 20220610T202537
+#+end_src
For another example, we will use the plain text variant, as it differs a
bit from the above. By default it is formatted this way:
- [elpa] externals/denote 941258d8d4 263/355: Remove faulty MUSTMATCH from file prompt, (continued)
- [elpa] externals/denote 941258d8d4 263/355: Remove faulty MUSTMATCH from file prompt, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 8eb27246a5 267/355: Refine buffer-local 'denote-directory'; update doc, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 385c7e9689 287/355: Clarify use of uspecified face attribute, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 90875d5419 233/355: Sort backlinks from oldest to newest, ELPA Syncer, 2022/06/27
- [elpa] externals/denote efd9d537cd 278/355: Give appropriate name to backlink button object, ELPA Syncer, 2022/06/27
- [elpa] externals/denote a062d9a351 294/355: Update link-related docs (cover buttonization), ELPA Syncer, 2022/06/27
- [elpa] externals/denote 750f8bf95c 307/355: Add FAQ about handling "last modified" scenario, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 627250dc0b 306/355: Make minor rewordings or clarifications to FAW, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 2e13b3451d 347/355: Update denote-link.el Commentary section, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 2d3a6fd8f3 327/355: Reword comment about multi-line button recognition, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 80eb7528aa 335/355: doc: Update documentation,
ELPA Syncer <=
- [elpa] externals/denote 0fac78ada3 338/355: Refine how link format for target is done, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 1f5077181a 326/355: Remove completed to-do about Embark, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 8182604ff3 343/355: Increase max-mini height for rename prompt, ELPA Syncer, 2022/06/27
- [elpa] externals/denote b14b5e201e 339/355: Make denote-link-add-links use id: when necessary, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 4f85d0ece8 355/355: Rephrase description about zk.el alternative, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 84ff0fb674 352/355: Fix alignment in sample front matter, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 1be0255183 340/355: Reword some statements in the manual, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 5c13cf4c1c 354/355: Rename internal id front matter rx for consistency, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 733a89ead5 007/355: Add missing autoload, ELPA Syncer, 2022/06/27
- [elpa] externals/denote 8e7d42b160 016/355: Fix all (?) problems with org-capture integration, ELPA Syncer, 2022/06/27