Internal non-PROPERTY links don't export to HTML with the "a" IDs that were assigned

Internal non-PROPERTY links don't export to HTML with the "a" IDs that were assigned

[D. C. Toedt]

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

I'm using the latest update from the package updater, released 2016-03-28:
 Org-mode version 8.3.2 (release_8.3.2-164-g50a182).

I can best illustrate the problem with an example:

*Org source:  *

See also the [[IndemnNonAssign][Indemnity rights not
> ​​
> assignable]] provision.


*​Former exported HTML (correct):*


See also the <a href="#In <http://www.commondraft.org/#IndemnNonAssign>
> demnNonAssign <http://www.commondraft.org/#IndemnNonAssign>">Indemnity rig
> ​​
> hts not assignable</a> provision.

​​

*Current exported HTML (incorrect):*

​​
> See also the <
> ​​
> a href="#orgtarget21">Indemnity rights not assignable</a> provision.

​​

​​
This causes problems, because "orgtarget21" won't necessarily be assigned
to the same point in the text, which in turn means that "jump cite" ​​links
to specific points internal to the document will break.​​
​​
​​I scanned through the documentation but didn't see anything indicating
​that there's a setting to use assigned names instead of "orgtargetNN"


​​

D. C. Toedt III
*(My last name is pronounced "Tate")*
Attorney & arbitrator -- tech contracts & IP
O: +1 (713) 364-6545   C: +1 (713) 516-8968
​​

dc@toedt.com    @dctoedt <https://twitter.com/DCToedt>
​
Skype: dctoedt
​

www.OnContracts.com/About <http://www.oncontracts.com/About>
​​


Unless expressly stated otherwise,
this message is not intended to serve
as assent to an agreement or other document,
even if attached to this message.

[-- Attachment #2: Type: text/html, Size: 9741 bytes --]

Re: Internal non-PROPERTY links don't export to HTML with the "a" IDs that were assigned

[Nick Dokos]

"D. C. Toedt" <dc@toedt.com> writes:

> I'm using the latest update from the package updater, released 2016-03-28:  Org-mode version 8.3.2 (release_8.3.2-164-g50a182).  
>
> I can best illustrate the problem with an example:
>
> Org source:  
>
>     See also the [[IndemnNonAssign][Indemnity rights not
>     ​​
>     assignable]] provision. 
>
> ​Former exported HTML (correct):
>
>     See also the <a href="#IndemnNonAssign">Indemnity rig
>     ​​
>     hts not assignable</a> provision.
>
> ​​
>
> Current exported HTML (incorrect):
>
>     ​​
>     See also the <
>     ​​
>     a href="#orgtarget21">Indemnity rights not assignable</a> provision. 
>
> ​​
>
> ​​
> This causes problems, because "orgtarget21" won't necessarily be assigned to the same point in the text, which in turn means that "jump cite" ​​links to specific points internal to the
> document will break.​​
> ​​

Do you actually see breakage?  I get

<a href="#org1946c66">Indemnity rights not assignable</a>

coupled with

<a id="org1946c66"></a>

at the referent, which is correct I believe.

So what problems are you seeing (other than that the label looks funny)?

> ​​I scanned through the documentation but didn't see anything indicating
> ​that there's a setting to use assigned names instead of "orgtargetNN"

<mumble> CUSTOM_ID </mumble> - I'm muttering because I'm not
sure what problem you are having and whether CUSTOM_ID can
solve it.

LaTeX export can override these labels with org-latex-prefer-user-labels
(see its documentation for the rationale), but there is no similar
provision for HTML export.

The issue (actually not quite the same issue but it *is* related) last
came up about a month ago:

http://thread.gmane.org/gmane.emacs.orgmode/105329

and Nicolas indicated that he would be willing to accept a patch
to do something similar with HTML export:

http://thread.gmane.org/gmane.emacs.orgmode/105329/focus=105391

The underlying rationale in that thread was that one might want
predictable labels so that they could be used e.g. in CSS to style
something.

--
Nick

Re: Internal non-PROPERTY links don't export to HTML with the "a" IDs that were assigned

[D. C. Toedt]

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

> So what problems are you seeing (other than that the label looks funny)?

The problem is that the label can vary from export to export.  EXAMPLE:  I
added a <<TestIt>> target ID in the paragraph before the paragraph
containing <<IndemnNonAssign>>; the result was that <<IndemNonAssign>> now
exports as <a href="#orgtarget22" instead of <a href="#orgtarget21" --- so
if I had previously emailed someone saying "Please read
http://www.CommonDraft.org/#orgtarget21" the link would no longer point to
where it was supposed to.

> CUSTOM_ID

That works for heading properties, but I'm not aware that CUSTOM_ID can be
used in the text internal to a heading-designated section.




>
>
>
>

[-- Attachment #2: Type: text/html, Size: 3637 bytes --]