Org version 9.7 and id: links

Org version 9.7 and id: links

[Sébastien Gendre]

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

Hello,

On the Org-mode version 9.7 release note [1], there is a new feature I do
not understand. It's the "id:" links support search options.

The release note say:


> id: links support search options; org-id-store-link adds search option
> by default
> 
> Adding search option by org-id-store-link can be disabled by setting
> org-id-link-use-context to nil, or toggled for a single call by
> passing universal argument.
> 
> When using this feature, IDs should not include ::, which is used in
> links to indicate the start of the search string. For backwards
> compatibility, existing IDs including :: will still be matched (but
> cannot be used together with search option). A new org-lint checker
> has been added to warn about this.

What are the id: search options ? How does it work and how to use it ?


Best regards

-------
Gendre Sébastien


[1] https://orgmode.org/Changes.html

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 849 bytes --]

Re: Org version 9.7 and id: links

[Rick Lupton]

Hi,

See https://orgmode.org/manual/Search-Options.html

Best
Rick

On Fri, 8 Nov 2024, at 4:14 PM, Sébastien Gendre wrote:
> Hello,
>
> On the Org-mode version 9.7 release note [1], there is a new feature I do
> not understand. It's the "id:" links support search options.
>
> The release note say:
>
>
>> id: links support search options; org-id-store-link adds search option
>> by default
>> 
>> Adding search option by org-id-store-link can be disabled by setting
>> org-id-link-use-context to nil, or toggled for a single call by
>> passing universal argument.
>> 
>> When using this feature, IDs should not include ::, which is used in
>> links to indicate the start of the search string. For backwards
>> compatibility, existing IDs including :: will still be matched (but
>> cannot be used together with search option). A new org-lint checker
>> has been added to warn about this.
>
> What are the id: search options ? How does it work and how to use it ?
>
>
> Best regards
>
> -------
> Gendre Sébastien
>
>
> [1] https://orgmode.org/Changes.html
>
> Attachments:
> * signature.asc

Re: Org version 9.7 and id: links

[Sébastien Gendre]

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

Hi,

Thank you for you reply.

So, if I understand correctly:

* On a "file:" link, it is possible to add "::#custom-id" at the end to
  tel Org-mode to search the "custom-id" as a target of the link

* With Org 9.7, an "id:" can also have "::#custom-id" at the end

* "org-id-store-link" add it by default


But an "id:" link already contain an ID, why adding it a second time at
the end of the link ?



"Rick Lupton" <mail@ricklupton.name> writes:

> Hi,
>
> See https://orgmode.org/manual/Search-Options.html
>
> Best
> Rick
>
> On Fri, 8 Nov 2024, at 4:14 PM, Sébastien Gendre wrote:
>> Hello,
>>
>> On the Org-mode version 9.7 release note [1], there is a new feature I do
>> not understand. It's the "id:" links support search options.
>>
>> The release note say:
>>
>>
>>> id: links support search options; org-id-store-link adds search option
>>> by default
>>> 
>>> Adding search option by org-id-store-link can be disabled by setting
>>> org-id-link-use-context to nil, or toggled for a single call by
>>> passing universal argument.
>>> 
>>> When using this feature, IDs should not include ::, which is used in
>>> links to indicate the start of the search string. For backwards
>>> compatibility, existing IDs including :: will still be matched (but
>>> cannot be used together with search option). A new org-lint checker
>>> has been added to warn about this.
>>
>> What are the id: search options ? How does it work and how to use it ?
>>
>>
>> Best regards
>>
>> -------
>> Gendre Sébastien
>>
>>
>> [1] https://orgmode.org/Changes.html
>>
>> Attachments:
>> * signature.asc

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 849 bytes --]

Re: Org version 9.7 and id: links

[Ihor Radchenko]

Sébastien Gendre <seb@k-7.ch> writes:

> * With Org 9.7, an "id:" can also have "::#custom-id" at the end
>
> * "org-id-store-link" add it by default
>
>
> But an "id:" link already contain an ID, why adding it a second time at
> the end of the link ?

Example 1:

You have top-level property drawer in a file:
:PROPERTIES:
:ID: file-id
:END:

Then, you can refer to headings in the file as
[[id:file-id::heading-id]] instead of
[[file:/path/to/file/that/may/change::heading-id]].

Example 2:

You have a subtree with only the topmost heading with ID. You do not
want to pollute child headings with PROPERTIES drawer, but you cannot
reference them using [[*heading]] links either because the child heading
titles are not unique. Then, you can do
[[id:parent-id::*child title]] to refer to a child.

-- 
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>