Patchwork [O] Use id property as anchor in the Table of Contents

Pere Quintana Seguí <pquintana@obsebre.es> writes:

> 2011/9/8 Bernt Hansen <bernt@norang.ca>
>>
>> Pere Quintana Seguí <pquintana@obsebre.es> writes:
>>
>> > Hi,
>> >
>> > I'm using Org-mode to publish my website. One of my site's pages has
>> > a lot of sections and the number of sections is increasing rapidly.
>> >
>> > My problem is that the HTML exporter, in the Table of Contents, is
>> > using the section numbers as anchors. As the section numbers change
>> > with time, I can't get stable links across versions of the document.
>> >
>> > As many of the sections (headings) have id properties, I'd like the
>> > HTML exporter to use them as anchor for the Table of Contents, when
>> > available.
>> >
>> > Is this possible? I didn't find an answer in the manual.
>> >
>> > As an example. This is the document I'm working on:
>> > http://pere.quintanasegui.com/diccionari-tecnologia.html#sec-2-78
>> >
>> > As you can see, section 2.78, called RSS, has the anchor sec-2-78. If
>> > the anchor was its id "04E3903E-EAF1-499F-98CD-9E3E4BA0806A", the
>> > link would remain the same in the future. I don't mind if the URL is
>> > not human readable. Sec-2-78 isn't human readable too.
>>
>> Hi Pere,
>>
>> You can manually provide CUSTOM_ID properties.  These ids are used in
>> the TOC.
>>
>> e.g.
>>
>> * Reminders
>>  :PROPERTIES:
>>  :CUSTOM_ID: Reminders
>>  :END:
>>
>> for
>>
>> http://doc.norang.ca/org-mode.html#Reminders
>
> OK, thanks for the tip. That's an option, but unfortunately it is not
> automatic.
>
>> I don't know if there is a way to use the ID property automatically.
>
> Unfortunately I don't know lisp, so I can't modify org-mode to provide
> this feature :'(
>
> If anyone is willing, I would be very grateful.

You might try this *untested* patch. It is against git master.

How did you create ID properties for all entries? Have you exported your
org-files to icalendar?

And please, don't forget to backup your files!
Regards, Olaf

2011/9/13 Olaf Dietsche <olaf+list.orgmode@olafdietsche.de>:
> You might try this *untested* patch. It is against git master.

:D Thanks!!!

> How did you create ID properties for all entries? Have you exported your
> org-files to icalendar?

Most of them have ID properties because I often link them internally.
When I create the link with C-c l, org adds the id.

For those that do not have ID, I'll create them manually with
org-id-get-create. With a keyboard macro this will be fast.

> And please, don't forget to backup your files!

Of course! Fortunately I version control my ~/org folder with Bazaar.

With this patch, what happens if there is no id in a heading, does it
create it automatically?

At work I'm using stable versions of Org-mode. This weekend I'll try
the git version at home and test your patch.

Thanks

Pere Quintana Seguí <pquintana@obsebre.es> writes:

> 2011/9/13 Olaf Dietsche <olaf+list.orgmode@olafdietsche.de>:
>> How did you create ID properties for all entries? Have you exported your
>> org-files to icalendar?
>
> Most of them have ID properties because I often link them internally.
> When I create the link with C-c l, org adds the id.
>
> For those that do not have ID, I'll create them manually with
> org-id-get-create. With a keyboard macro this will be fast.

Ok, thanks for this explanation.

> With this patch, what happens if there is no id in a heading, does it
> create it automatically?

It is supposed to use the CUSTOM_ID, if set. Next, it tries the ID
property. At last, it falls back to "sec-...".

> At work I'm using stable versions of Org-mode. This weekend I'll try
> the git version at home and test your patch.

Regards, Olaf

2011/9/15 Olaf Dietsche <olaf+list.orgmode@olafdietsche.de>:
>> With this patch, what happens if there is no id in a heading, does it
>> create it automatically?
>
> It is supposed to use the CUSTOM_ID, if set. Next, it tries the ID
> property. At last, it falls back to "sec-...".

Ok, perfect. Thanks.