From mboxrd@z Thu Jan  1 00:00:00 1970
From: Baptiste <bateast@bat.fr.eu.org>
Subject: Internal link with custom caption
Date: Fri, 17 May 2013 15:31:24 +0200
Message-ID: <87ehd5ohr1.fsf@bat.fr.eu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:48280)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bateast@bat.fr.eu.org>) id 1UdKlM-0004aB-Ho
	for Emacs-orgmode@gnu.org; Fri, 17 May 2013 09:32:06 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bateast@bat.fr.eu.org>) id 1UdKlG-0007k0-HC
	for Emacs-orgmode@gnu.org; Fri, 17 May 2013 09:32:00 -0400
Received: from mail-wg0-x229.google.com ([2a00:1450:400c:c00::229]:58420)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bateast@bat.fr.eu.org>) id 1UdKlG-0007jb-90
	for Emacs-orgmode@gnu.org; Fri, 17 May 2013 09:31:54 -0400
Received: by mail-wg0-f41.google.com with SMTP id y10so572639wgg.0
	for <Emacs-orgmode@gnu.org>; Fri, 17 May 2013 06:31:51 -0700 (PDT)
Received: from ubuntu (52.101.11.109.rev.sfr.net. [109.11.101.52])
	by mx.google.com with ESMTPSA id dj7sm9545703wib.6.2013.05.17.06.31.47
	for <Emacs-orgmode@gnu.org>
	(version=TLSv1.2 cipher=RC4-SHA bits=128/128);
	Fri, 17 May 2013 06:31:50 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=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: "Emacs-orgmode@gnu.org" <Emacs-orgmode@gnu.org>

Hi,

I would like to be able to  manage internal link that is exported with a
custom reference text. I mean define somewhere an anchor *plus the reference caption* and then use link mechanism to create a reference to this point with its given caption.

I do not find a way to do so.

Has I imagine it, it would look like

#+BEGIN_EXAMPLE
* Books
Presentation of the <<ref_book_1|/Important Book/>>.
… some text …

* What you have to read
… you should have a look at [[ref_book_1]] …

… some text …

* Where to find books
… [[ref_book_1]] is a free book from …
#+END_EXAMPLE

that would export as
#+BEGIN_EXAMPLE
* Books
Presentation of the /Important Book/.
… some text …

* What you have to read
… you should have a look at /Important Book/ …  ### (as a link to <<ref_book_1>>)

… some text …

* Where to find books
… /Important Book/ is a free book from …        ### (as a link to <<ref_book_1>>)
#+END_EXAMPLE

Did I miss something and there is a way to achieve this ? Or am-I the only one looking for such a function ?

Thank you

--

: ~^v^~ Bat