From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: HTML Export of Links to Source Blocks seems broken
Date: Mon, 20 Jun 2016 14:52:37 +0200
Message-ID: <87fus82fai.fsf@saiph.selenimh>
References: <CAAX25XA3dSreTbqeTfBajcrKv8kj2fDapdpFUu05UD7HkVZ-dA@mail.gmail.com>
	<874m8sxngx.fsf@saiph.selenimh>
	<CAAX25XDAETVCrUp=PR7humTDDL2cDTbS5muWESGLb6s3h6YwKQ@mail.gmail.com>
	<87r3bwvxke.fsf@saiph.selenimh>
	<CAAX25XD+4kDzEEW=dMRWEzYkJwjafOUNbnups_nd2CGbUoz=3w@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54554)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1bEyh3-0006JJ-Qn
	for emacs-orgmode@gnu.org; Mon, 20 Jun 2016 08:52:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1bEyh2-0007Vp-WC
	for emacs-orgmode@gnu.org; Mon, 20 Jun 2016 08:52:45 -0400
Received: from relay3-d.mail.gandi.net ([2001:4b98:c:538::195]:59873)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1bEyh2-0007Vl-Pc
	for emacs-orgmode@gnu.org; Mon, 20 Jun 2016 08:52:44 -0400
In-Reply-To: <CAAX25XD+4kDzEEW=dMRWEzYkJwjafOUNbnups_nd2CGbUoz=3w@mail.gmail.com>
	(timor's message of "Mon, 20 Jun 2016 10:18:51 +0200")
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"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: timor <timor.dd@gmail.com>
Cc: emacs-orgmode@gnu.org

Hello,

timor <timor.dd@gmail.com> writes:

> Ok, if I understand you correctly, implementing the mechanism akin to
> the latex one, setting a new variable `org-html-prefer-user-labels` would
> change the relevant exported HTML for the following piece of org:
>
> ----------------------
> #+NAME: test_fun
> #+BEGIN_SRC js :exports code
> function test_fun() {
>
> } #+END_SRC
>
> Link to [[test_fun]]
>
> #+CAPTION: Caption of Another Test Fun
> #+NAME: another_test_fun
> #+BEGIN_SRC js
> function another_test_fun() {
>
> }
> #+END_SRC
>
> Link to [[another_test_fun]] -----------------------
>
> from
>
> #+BEGIN_EXAMPLE html
>
>   <pre class="src src-js" id="orgsrcblock1">
>   ...
>   </pre>
>
>   <pre class="src src-js" id="orgsrcblock2">
>   ...
>   </pre>
>
>   Link to <a href="#orgsrcblock1">1</a>
>
>   Link to <a href="#orgsrcblock2">1</a>
>
> #+END_EXAMPLE
>
> to
>
> #+BEGIN_EXAMPLE html
>
>   <pre class="src src-js" id="test_fun">
>   ...
>   </pre>
>
>   <pre class="src src-js" id="another_test_fun">
>   ...
>   </pre>
>
>   Link to <a href="#test_fun">1</a>
>
>   Link to <a href="#another_test_fun">1</a>
>
> #+END_EXAMPLE

Correct.

> Looking at `org-html-link`, `org-export-get-reference` is only called
> to get the _internal_ reference.  That works perfectly fine already, and I am
> quite happy with the way org mode generates labels/ids for the exported
> code.  That should, however, have no influence of the link description
> (called `desc` in the code in `org-html-link`), which is the thing
> that I actually want to change?

They have no influence over the link description (which is "1" in both
cases, as you noticed). If you want to change the description, simply
provide one:

  [[test_fun][whatever]]

Regards,

-- 
Nicolas Goaziou