org-mode/doc
Rick Lupton 95554543b9
org-id.el: Add search strings, inherit parent IDs
* lisp/ol.el (org-store-link): Refactor org-id links to use standard
`org-store-link-functions'.
(org-link-search): Create new headings at appropriate level.
(org-link-precise-link-target): New function extracting logic to
identify a precise link target, e.g. a heading, named object, or text
search.
(org-link-try-link-store-functions): Extract logic to call external
link store functions. Pass them a new `interactive?' argument.
* lisp/ol-bbdb.el (org-bbdb-store-link):
* lisp/ol-bibtex.el (org-bibtex-store-link):
* lisp/ol-docview.el (org-docview-store-link):
* lisp/ol-eshell.el (org-eshell-store-link):
* lisp/ol-eww.el (org-eww-store-link):
* lisp/ol-gnus.el (org-gnus-store-link):
* lisp/ol-info.el (org-info-store-link):
* lisp/ol-irc.el (org-irc-store-link):
* lisp/ol-man.el (org-man-store-link):
* lisp/ol-mhe.el (org-mhe-store-link):
* lisp/ol-rmail.el (org-rmail-store-link): Accept optional arg.
* lisp/org-id.el (org-id-link-consider-parent-id): New option to allow
a parent heading with an id to be considered as a link target.
(org-id-link-use-context): New option to add context to org-id links.
(org-id-get): Add optional `inherit' argument which considers parents'
IDs if the current entry does not have one.
(org-id-store-link): Consider IDs of parent headings as link targets
when current heading has no ID and `org-id-link-consider-parent-id' is
set.  Add a search string to the link when enabled.
(org-id-store-link-maybe): Function set as :store option for custom id
link property. Move logic from `org-store-link' here to determine when
an org-id link should be stored using `org-id-store-link'.
(org-id-open): Recognise search strings after "::" in org-id links.
* lisp/org-lint.el: Add checker for "::" in ID properties.
* testing/lisp/test-ol.el: Add tests for
`org-link-precise-link-target' and `org-id-store-link' functions,
testing new options.
* doc/org-manual.org: Update documentation about links.
* etc/ORG-NEWS: Document changes and new options.

These feature allows for more precise links when using org-id to link to
org headings, without requiring every single headline to have an id.

Link: https://list.orgmode.org/118435e8-0b20-46fd-af6a-88de8e19fac6@app.fastmail.com/
2024-02-24 15:56:44 +03:00
..
.aspell.org.conf Fix typos 2019-11-16 17:17:36 -05:00
.nosearch Add .nosearch file to the doc/ subdirectory. 2008-12-17 17:25:31 +01:00
Documentation_Standards.org org-manual: Inline single-sentence footnotes 2022-10-04 10:18:26 +08:00
Makefile doc/Makefile: Limit memory consumption when generating docs 2022-06-17 13:18:39 +08:00
dir Add org-guide.org to the build process 2019-03-19 02:25:18 +01:00
doc-setup.org Backport commit 8e1c56ae4 from Emacs 2024-01-06 15:48:23 -05:00
fdl.org Prefer HTTPS to HTTP in most links 2021-03-21 15:21:22 -04:00
htmlxref.cnf Prefer HTTPS to HTTP for links to gnu.org 2021-03-21 14:29:13 -04:00
org-guide.org Merge branch 'bugfix' 2024-01-06 16:02:02 -05:00
org-manual.org org-id.el: Add search strings, inherit parent IDs 2024-02-24 15:56:44 +03:00
orgcard.tex orgcard.tex: Allow correct rendering in PDF format and US letter page size 2024-01-17 12:42:37 +01:00
pdflayout.sty Prefer HTTPS to HTTP for links to gnu.org 2021-03-21 14:29:13 -04:00
texinfo.tex Prefer HTTPS to HTTP in most links 2021-03-21 15:21:22 -04:00