From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@gnu.org>
Subject: Re: Hyperlinks!
Date: Mon, 13 Apr 2020 15:56:22 +0200
Message-ID: <873697jxq1.fsf@gnu.org>
References: <87eesrlkil.fsf@gnu.org>
 <704d2cb4-bc8a-c2ab-f5ce-913b1e5ea6c1@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:45851)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <ludo@gnu.org>) id 1jNzZa-0007e1-3B
 for guix-devel@gnu.org; Mon, 13 Apr 2020 09:56:26 -0400
In-Reply-To: <704d2cb4-bc8a-c2ab-f5ce-913b1e5ea6c1@gmail.com> (Vincent
 Legoll's message of "Mon, 13 Apr 2020 14:05:20 +0200")
List-Id: "Development of GNU Guix and the GNU System distribution."
 <guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
 <mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
 <mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org
Sender: "Guix-devel"
 <guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org>
To: Vincent Legoll <vincent.legoll@gmail.com>
Cc: guix-devel@gnu.org

Vincent Legoll <vincent.legoll@gmail.com> skribis:

> I see there are "#index${SOMETHING}" url suffixes,
>
> What about adding anchors like on:
>
> https://docs.python.org/3/library/functions.html#eval

There are already anchors, but they look like #index-procedure.

> when you mouse-over the function name line, a
> "permalink to this definition" appears.

I=E2=80=99m not sure how to do that.  Isn=E2=80=99t there some JavaScript i=
nvolved?

> I often want to give pointers to specific parts of the
> doc, and did not know about the #index thing (or
> maybe it is just being introduced). I think a visual
> thing like in the python doc would be nice to add...
>
> Should I create an issue about this ?

Sure, if you want.

The bottom line is that this is all very much a hack: we=E2=80=99re
post-processing generated HTML that we have no control over.
Longer-term, it would be nicer to use Guile=E2=80=99s stexi modules all alo=
ng
with tight control over the generated HTML.

Thanks,
Ludo=E2=80=99.