* Completion mechanism for headlines when creating a link between 2 Org files?
@ 2023-09-04 7:31 Alain.Cochard
2023-09-04 8:14 ` Ihor Radchenko
2023-09-05 21:35 ` David Masterson
0 siblings, 2 replies; 3+ messages in thread
From: Alain.Cochard @ 2023-09-04 7:31 UTC (permalink / raw)
To: emacs-orgmode
Hello. For internal links, the manual states that
To insert a link targeting a headline, in-buffer completion can be
used. Just type a star followed by a few optional letters into the
buffer and press ‘M-<TAB>’. All headlines in the current buffer
are offered as completions."
Is there a similar mechanism for links from one Org file to a headline
of another Org file? In the 'Handling Links' section of the manual:
C-c C-l (org-insert-link)
[...]
Completion support
Completion with TAB helps you to insert valid link prefixes
like ‘http’ or ‘ftp’, including the prefixes defined
through link abbreviations (see Link Abbreviations). If you
press RET after inserting only the prefix, Org offers
specific completion support for some link types.
but, after I complete for a given file, I cannot find a way to further
complete for a specific (sub)headline. Is there a way that I missed,
even after searching the Internet a bit?
If not, I am making it a feature request. Indeed it would be great,
especially if one does not really remember where, in a (known) file,
the headline is, nor --even more importantly-- what its name exactly
is.
(In my naive view, as the completion mechanism already exists for
internal files, it should be easy to extend it for external files...)
Regards
^ permalink raw reply [flat|nested] 3+ messages in thread* Re: Completion mechanism for headlines when creating a link between 2 Org files?
2023-09-04 7:31 Completion mechanism for headlines when creating a link between 2 Org files? Alain.Cochard
@ 2023-09-04 8:14 ` Ihor Radchenko
2023-09-05 21:35 ` David Masterson
1 sibling, 0 replies; 3+ messages in thread
From: Ihor Radchenko @ 2023-09-04 8:14 UTC (permalink / raw)
To: alain.cochard; +Cc: emacs-orgmode
Alain.Cochard@unistra.fr writes:
> C-c C-l (org-insert-link)
>
> [...]
>
> Completion support
>
> Completion with TAB helps you to insert valid link prefixes
> like ‘http’ or ‘ftp’, including the prefixes defined
> through link abbreviations (see Link Abbreviations). If you
> press RET after inserting only the prefix, Org offers
> specific completion support for some link types.
>
> but, after I complete for a given file, I cannot find a way to further
> complete for a specific (sub)headline. Is there a way that I missed,
> even after searching the Internet a bit?
You would need to extend the default file: link completion function -
`org-link-complete-file'.
You can override it with any custom function:
(org-link-set-parameters "file" :complete #'your-custom-completion-function)
> If not, I am making it a feature request. Indeed it would be great,
> especially if one does not really remember where, in a (known) file,
> the headline is, nor --even more importantly-- what its name exactly
> is.
>
> (In my naive view, as the completion mechanism already exists for
> internal files, it should be easy to extend it for external files...)
It is, although even more common request is simply inserting a link to a
heading in _a_ file (not known).
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: Completion mechanism for headlines when creating a link between 2 Org files?
2023-09-04 7:31 Completion mechanism for headlines when creating a link between 2 Org files? Alain.Cochard
2023-09-04 8:14 ` Ihor Radchenko
@ 2023-09-05 21:35 ` David Masterson
1 sibling, 0 replies; 3+ messages in thread
From: David Masterson @ 2023-09-05 21:35 UTC (permalink / raw)
To: Alain.Cochard; +Cc: emacs-orgmode
Alain.Cochard@unistra.fr writes:
> (In my naive view, as the completion mechanism already exists for
> internal files, it should be easy to extend it for external files...)
I believe the auto-complete package will do that.
--
David Masterson
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-09-05 21:41 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-09-04 7:31 Completion mechanism for headlines when creating a link between 2 Org files? Alain.Cochard
2023-09-04 8:14 ` Ihor Radchenko
2023-09-05 21:35 ` David Masterson
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).