Start playing with `org-capture-templates'

README.org

@@ -1555,6 +1555,12 @@ Listing [[lst:enable-marginalia-mode]] enables =marginalia-mode=.
 [[info:consult#Top][Consult (info)]] provides practical commands based on the Emacs minibuffer
 completion function [[info:elisp#Minibuffer Completion][completing-read]].  Listing [[lst:bind-consult-commands][bind =consult= commands]] binds
 =consult= commands to different key maps.
+Consult usage tips are:
+1. Add a buffer position to the mark ring by means of {{{kbd(C-SPACE C-SPACE)}}}
+   and jump to one of the marks in the ring by means of {{{kbd(M-x
+   consult-mark)}}} or {{{kbd(M-g m)}}}.  See [[https://arialdomartini.github.io//emacs-mark-ring][Emacs: Mark Ring]].
+2. {{{kbd(M-x consult-org-heading)}}} or {{{kbd(C-c C-h)}}} is an alternative to
+   {{{kbd(M-x org-goto)}}} or {{{kbd(C-c C-j)}}}.
 
 #+attr_latex: :booktabs yes :float table
 #+caption[Configuration specific key bindings]:
@@ -2144,22 +2150,13 @@ configuration objectives:
 (when (ensure-package-installation 'markdown-mode))
 #+end_src
 
-** Writing [[info:org#Top][Org (info)]] files
+** Writing [[info:org#Top][Org (info)]] files and [[info:org#Activation][Org activation (info)]]
 :PROPERTIES:
 :CUSTOM_ID: sec:writing-org-files
 :END:
 
-Here are links to Org-mode videos:
-1. [[yt:o6rE18Mxu9U][Analyze Your Time with Org Mode Clocktables]]
-2. [[yt:EgOBBiomfGo][Basic Task Management with Org: Checklists, TODOs, and Org-Agenda]]
-3. [[yt:oJTwQvgfgMM][Emacs Org-mode: a system for note-taking and project planning]]
-4. [[yt:SzA2YODtgK4][Getting Started With Org Mode]]
-5. [[yt:zqAYHWv36X0][Org Mode Time and Task Tools]]
-
-*** [[info:org#Activation][Org activation (info)]]
-:PROPERTIES:
-:CUSTOM_ID: sec:activate-org
-:END:
+Listing [[lst:bind-org-commands]] activates [[info:org#Top][Org (info)]] by means of global key
+bindings.
 
 #+caption[Bind =Org= commands globally]:
 #+caption: Bind =Org= commands globally.
@@ -2171,38 +2168,47 @@ Here are links to Org-mode videos:
   (global-set-key (kbd "C-c l") #'org-store-link))
 #+end_src
 
+Links to Org-mode videos are:
+1. [[yt:o6rE18Mxu9U][Analyze Your Time with Org Mode Clocktables]]
+2. [[yt:EgOBBiomfGo][Basic Task Management with Org: Checklists, TODOs, and Org-Agenda]]
+3. [[yt:oJTwQvgfgMM][Emacs Org-mode: a system for note-taking and project planning]]
+4. [[yt:SzA2YODtgK4][Getting Started With Org Mode]]
+5. [[yt:zqAYHWv36X0][Org Mode Time and Task Tools]]
+
 *** Setup Org
 :PROPERTIES:
 :CUSTOM_ID: sec:setup-org
+:ID:       0D725DA1-7431-40BD-85FF-EFF4F7E4EC95
 :END:
 
-I have split the initial [[https://orgmode.org/][Org-mode]] setup over fourteen listings.  Here, follows a
+I have split the initial [[https://orgmode.org/][Org-mode]] setup over fifteen listings.  Here, follows a
 list detailing and motivating each listing:
 1. Listing [[lst:set-org-options]] handles basic [[https://orgmode.org/][Org-mode]] options.
-2. Listing [[lst:undo-org-ctags]] undoes ~org-ctags~.  See [[https://list.orgmode.org/87mt43agk6.fsf@localhost/][org-ctags land grab]] for
+2. Listing [[lst:org-capture-templates]] initializes a simple capture template.
+3. Listing [[lst:undo-org-ctags]] undoes ~org-ctags~.  See [[https://list.orgmode.org/87mt43agk6.fsf@localhost/][org-ctags land grab]] for
    more information.
-3. Listing [[lst:setup-org-babel]] sets ~ob-core~, ~ob-latex~, and ~ob-lisp~ options.
+4. Listing [[lst:setup-org-babel]] sets ~ob-core~, ~ob-latex~, and ~ob-lisp~ options.
    See [[info:org#Working with Source Code][working with source code (info)]] for Org Babel information.
-4. Listing [[lst:no-org-babel-eval]] prevents evaluation of blocks without an
+5. Listing [[lst:no-org-babel-eval]] prevents evaluation of blocks without an
  =org-babel-execute:<LANG>= function and adds fake =org-babel-execute:<LANG>=
    functions to silence {{{kbd(M-x org-lint)}}} warnings.
-5. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
+6. Listing [[lst:set-org-link-options]] handles [[https://orgmode.org/][Org-mode]] options specific to
    [[info:org#Hyperlinks][hyperlinks (info)]].
-6. Listing [[lst:looking-at-org-id]] enables recent ~org-id~ features.
-7. Listing [[lst:setup-org-mode-map-1]] and [[lst:setup-org-mode-map-2]] extend the
+7. Listing [[lst:looking-at-org-id]] enables recent ~org-id~ features.
+8. Listing [[lst:setup-org-mode-map-1]] and [[lst:setup-org-mode-map-2]] extend the
  =org-mode-map= with useful key-bindings.
-8. Listing [[lst:setup-org-src]] facilitates [[info:org#Editing Source Code][editing source code blocks]], and it
+9. Listing [[lst:setup-org-src]] facilitates [[info:org#Editing Source Code][editing source code blocks]], and it
    provides functions to change the indentation of all =org-src-mode= blocks.
-9. Listing [[lst:setup-ob-python]] allows to pretty-print Python session source
+10. Listing [[lst:setup-ob-python]] allows to pretty-print Python session source
     block values with [[https://github.com/psf/black#readme][black]] instead of [[https://docs.python.org/3/library/pprint.html][pprint]].  This snippet may break in the
     future, because it sets =org-babel-python--def-format-value= which is a
     constant declared "private" by two dashes in its name!
-10. Listing [[lst:set-org-export-options]] selects the =non-intrusive= expert user
+11. Listing [[lst:set-org-export-options]] selects the =non-intrusive= expert user
     interface for export dispatching.
-11. Listing [[lst:setup-org-for-lualatex-export]] and
+12. Listing [[lst:setup-org-for-lualatex-export]] and
     [[lst:set-ox-latex-options-for-lualatex-export]] configure [[https://orgmode.org/][Org-mode]] to generate
     output for the LuaLaTeX compiler.
-12. Listing [[lst:setup-org-latex-classes]] defines [[info:org#LaTeXspecificexportsettings][org-latex-classes (info)]] for
+13. Listing [[lst:setup-org-latex-classes]] defines [[info:org#LaTeXspecificexportsettings][org-latex-classes (info)]] for
     backward compatibility.  For an explanation of the code in listing
     [[lst:setup-org-latex-classes]], type {{{kbd(C-h v org-latex-classes)}}}.
 
@@ -2249,6 +2255,17 @@ list detailing and motivating each listing:
    org-use-property-inheritance t))
 #+end_src
 
+#+caption[Setup =org-capture-templates=]:
+#+caption: Setup =org-capture-templates=.
+#+name: lst:org-capture-templates
+#+begin_src emacs-lisp -n :results silent
+(with-eval-after-load 'org-capture
+  (setopt org-capture-templates
+          '(("f" "Flat capture database" entry (file "flat.org")
+             "* %^{Prompt}t %?
+%a"))))
+#+end_src
+
 #+caption[Undo calling =org-ctags-enable= ]:
 #+caption: Undo calling =org-ctags-enable=.
 #+name: lst:undo-org-ctags