org-capture-templates with multi charachter keys

org-capture-templates with multi charachter keys

[Roland Everaert]

[-- Attachment #1: Type: text/plain, Size: 690 bytes --]

Hello,

Is there somewhere in the org documentation or on the internet a complete
example of using multi-character keys in org-capture.

This excerpt from the documentation is not clear to me :/

"The keys that will select the template, as a string, characters only, for
example "a" for a template to be selected with a single key, or "bt" for
selection with two keys. When using several keys, keys using the same
prefix key must be sequential in the list and preceded by a 2-element entry
explaining the prefix key, for example

                   ("b" "Templates for marking stuff to buy")

"

Moreover, can a prefix be composed of multiple characters or only one?

Thanks for your help.

[-- Attachment #2: Type: text/html, Size: 934 bytes --]

Re: org-capture-templates with multi charachter keys

[Marco Wahl]

Hi,

Roland Everaert <reveatwork@gmail.com> writes:

> Is there somewhere in the org documentation or on the internet a complete
> example of using multi-character keys in org-capture.
>
> This excerpt from the documentation is not clear to me :/
>
> "The keys that will select the template, as a string, characters only, for
> example "a" for a template to be selected with a single key, or "bt" for
> selection with two keys. When using several keys, keys using the same
> prefix key must be sequential in the list and preceded by a 2-element entry
> explaining the prefix key, for example
>
>                    ("b" "Templates for marking stuff to buy")
>
> Moreover, can a prefix be composed of multiple characters or only one?

The following example might help you understand.  It's cut and paste
from a customize buffer for org-capture-templates.

With this customization one can use the keys x t p to get to the "tree poem"
capture.  (Tree and poem is completely artificial.)  And in the same way x t n
brings up the capture for "tree new".


#v+
For help using this buffer, see Easy Customization in the Emacs manual.

Operate on all settings in this buffer:
 Revert...   Apply   Apply and Save 

Hide Org Capture Templates:
INS DEL Choice: Value Menu Multikey description:
            Keys       : x
            Description: my multikeys starting with x
INS DEL Choice: Value Menu Multikey description:
            Keys       : xt
            Description: my submultikeys starting with xt (trees)
INS DEL Choice: Value Menu Template entry:
            Keys           : xtp
            Description    : tree poem
            Capture Type   : Value Menu Org entry
            Target location: Value Menu File:
            Filename       : Value Menu Literal: ~/org/refile.org
            Template       : Value Menu String: 
            Plist:
            [ ] Key: :prepend t
            [ ] Key: :immediate-finish t
            [ ] Key: :jump-to-captured t
            [ ] Key: :empty-lines 1
            [ ] Key: :empty-lines-before 1
            [ ] Key: :empty-lines-after 1
            [ ] Key: :clock-in t
            [ ] Key: :clock-keep t
            [ ] Key: :clock-resume t
            [ ] Key: :unnarrowed t
            [ ] Key: :table-line-pos t
            [ ] Key: :kill-buffer t
                        INS
INS DEL Choice: Value Menu Template entry:
            Keys           : xtn
            Description    : new tree
            Capture Type   : Value Menu Org entry
            Target location: Value Menu File:
            Filename       : Value Menu Literal: ~/org/refile.org
            ...
#v-


HTH,  Marco

org-capture-templates with multi charachter keys

[tenspd137 .]

Hi all,

I can't seem to find an answer for this, maybe someone could tell me
what I am doing wrong.  Based on what I read in the manual and
examples I have seen, the following is valid for creating
org-capture-templates:

(setq org-capture-templates
      '(("t" "Todo" entry (file+headline (concat org-directory
"/default.org") "Tasks")
         "* TODO %?\n %i\n %a")
        ("j" "Journal" entry (file+datetree (concat org-directory
"/journal.org"))
         "* %?\nEntered on %U\n  %i\n  %a")
        ;;product stuff - I would like to move these to files and have
        ;;them loaded - maybe in the future
        ("bf" "Bluefin Todo" entry (file+headline (concat
org-directory "/bluefin.org") "Tasks")
         "* TODO %?\n %i\n %a")))

the last one I am using "bf" as a key.  When I go to use org capture,
the following is shown in the menu

Select a capture template
===================

[t] Todo
[j] Journal
[bf] Bluefin Todo
----------------------------------------
[C] Customize org-capture-templates
[q]  Abort

but when I hit b (as in bf), the mini-buffer just says invalid key `b'

How do I use multiple keys?

Thanks!

-C

Re: org-capture-templates with multi charachter keys

[Kyle Meyer]

Hello,

"tenspd137 ." <dcday137@gmail.com> writes:

> (setq org-capture-templates
>       '(("t" "Todo" entry (file+headline (concat org-directory
> "/default.org") "Tasks")
>          "* TODO %?\n %i\n %a")
>         ("j" "Journal" entry (file+datetree (concat org-directory
> "/journal.org"))
>          "* %?\nEntered on %U\n  %i\n  %a")
>         ;;product stuff - I would like to move these to files and have
>         ;;them loaded - maybe in the future
>         ("bf" "Bluefin Todo" entry (file+headline (concat
> org-directory "/bluefin.org") "Tasks")
>          "* TODO %?\n %i\n %a")))
>
> the last one I am using "bf" as a key.  When I go to use org capture,
> the following is shown in the menu
>
> Select a capture template
> ===================
>
> [t] Todo
> [j] Journal
> [bf] Bluefin Todo
> ----------------------------------------
> [C] Customize org-capture-templates
> [q]  Abort
>
> but when I hit b (as in bf), the mini-buffer just says invalid key `b'
>
> How do I use multiple keys?

I think you're missing this bit from org-capture-templates's docstring:

    When using several keys, keys using the same prefix key must be
    together in the list and preceded by a 2-element entry explaining
    the prefix key, for example

            ("b" "Templates for marking stuff to buy")


--
Kyle