Chris, could you, please, be more specific with your complains?
Templates are described in the manual in the sections you cited.
Notice that manual may be accessed from emacs
M-x info RET org RET
or
M-: (info "(org) The capture protocol")
or using [[info:org#The capture protocol]] links in org files or as a
single long HTML page https://orgmode.org/org.html
On 31/01/2022 11:23, chris wrote:
> Provided I have opened at least one org buffer before hand, otherwise it
> opens a buffer named
> `"org-protocol://capture?template=l&url=URL&title=TITLE&body=BODY" ` at
> what point it can get messy. Probably I have to "start" somehow
"org-mode"
> first, and it doesn't get enough started from my `init.el`.
You need something like
(require 'org-protocol)
in your emacs init file to setup handlers for specific "file names".
Org-protocol URIs are just relative paths to files from standpoint of
emcasclient. Certainly this line should be executed when directory with
org package is already known. The pitfall of such line is that it makes
impossible to temporary try another org version using just
emacs -L ~/src/org-mode/lisp test.org
it must be combined with -q or -Q.
So, reverse-engineering the example I've eventually found the relevant
points of the documentation:
What do you mean by "reverse-engineering"? %:link, %:description, %i are
described in "The capture protocol"
https://orgmode.org/manual/The-capture-protocol.html known to you. Upper
"Protocols for External Access" section contains link to "Capture"
section where a couple of examples (unrelated to org-protocol however)
may be found. "Template elements" and (known to you) "Template
expansion" sections have detailed reference of template constituents.
https://orgmode.org/worg/org-contrib/org-protocol.html
Notice that some information on this page is outdated.
(setq org-capture-templates
`(("l" "org-protocol-capture" entry
(file "~/path/inbox.org")
"* TODO [[%:link][%:description]]\n\n %:initial"
:immediate-finish t)))
:immediate-finish should be added when everything already works.
