[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] Anchors in texinfo export
From: |
Nicolas Goaziou |
Subject: |
Re: [O] Anchors in texinfo export |
Date: |
Wed, 13 Feb 2013 19:21:57 +0100 |
address@hidden (Thomas S. Dye) writes:
> Nicolas Goaziou <address@hidden> writes:
>
>> Hello,
>>
>> address@hidden (Thomas S. Dye) writes:
>>
>>> Currently, the texinfo exporter translates a dedicated target in a comment:
>>>
>>> # <<x-export-to-odt>>
>>
>> This isn't a target. This is a comment that contains some text looking
>> like Org syntax.
>>
>
> OK. I see I have a note from you to revise the manual @ 4.2 Internal links:
>
> The preferred match for a text link is a dedicated target: the same
> string in double angular brackets. Targets may be located anywhere;
> sometimes it is convenient to put them into a comment line. For example
>
> # <<My Target>>
>
>>> to this:
>>>
>>> @c <<x-export-to-odt>>
>>>
>>> I was expecting to see a texinfo anchor:
>>>
>>> @anchor{x-export-to-odt}
>>>
>>> There are a handful of these dedicated target comments cum anchors in the
>>> Org
>>> mode manual. I believe all of them are in places where it would be easy
>>> to replace them with links directly to the corresponding headline/node.
>>>
>>> Should I edit them away? Or, are dedicated target comments/anchors
>>> something the texinfo exporter should handle?
>>
>> There are no such things as "dedicated targets". Though
>> <<x-export-to-odt>> within a paragraph should be translated into some
>> sort of anchor. Isn't it the case?
>
> I don't know yet. AFAICT there isn't a need for this construct in the
> Org mode manual.
>
> At any rate, I'll go ahead and get rid of the comments that contain this
> text with apparent Org mode syntax and replace the links to them with
> links back to the corresponding headlines.
For completeness, when you put a target <<target>> somewhere, optimally
(this obviously depends on the back-end):
- [[target]] should link to it and be displayed as the ordinal of the
environment containing it (a.k.a cross-reference).
- [[target][text]] should link to it and be displayed as "text".
Also, there is a special #+TARGET: keyword. It will never be exported
and links to it will be ignored. It allows for quick navigation in an
Org buffer without impacting export.
Regards,
--
Nicolas Goaziou