From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Anchors in texinfo export Date: Wed, 13 Feb 2013 19:21:57 +0100 Message-ID: <87d2w49ire.fsf@gmail.com> References: <8738x0b1q6.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:50651) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U5gyM-0001oS-0b for emacs-orgmode@gnu.org; Wed, 13 Feb 2013 13:22:25 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U5gyE-0004hu-4u for emacs-orgmode@gnu.org; Wed, 13 Feb 2013 13:22:21 -0500 Received: from mail-we0-x236.google.com ([2a00:1450:400c:c03::236]:39001) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U5gyD-0004hn-VP for emacs-orgmode@gnu.org; Wed, 13 Feb 2013 13:22:14 -0500 Received: by mail-we0-f182.google.com with SMTP id t57so1282275wey.27 for ; Wed, 13 Feb 2013 10:22:12 -0800 (PST) In-Reply-To: (Thomas S. Dye's message of "Wed, 13 Feb 2013 08:04:00 -1000") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: "Thomas S. Dye" Cc: Org-mode tsd@tsdye.com (Thomas S. Dye) writes: > Nicolas Goaziou writes: > >> Hello, >> >> tsd@tsdye.com (Thomas S. Dye) writes: >> >>> Currently, the texinfo exporter translates a dedicated target in a comment: >>> >>> # <> >> >> 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 > > # <> > >>> to this: >>> >>> @c <> >>> >>> 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 >> <> 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 <> 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