From mboxrd@z Thu Jan  1 00:00:00 1970
From: sirgazil <sirgazil@zoho.com>
Subject: Re: Hyperlinks!
Date: Mon, 13 Apr 2020 16:22:48 +0000
Message-ID: <1717459b62b.11db4983e57113.4889647680545306853@zoho.com>
References: <87eesrlkil.fsf@gnu.org>
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]:33103)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <sirgazil@zoho.com>) id 1jO1rR-0006EN-Qo
 for guix-devel@gnu.org; Mon, 13 Apr 2020 12:23:02 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <sirgazil@zoho.com>) id 1jO1rQ-0004D3-Fm
 for guix-devel@gnu.org; Mon, 13 Apr 2020 12:23:01 -0400
In-Reply-To: <87eesrlkil.fsf@gnu.org>
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: =?UTF-8?Q?=22Ludovic_Court=C3=A8s=22?= <ludo@gnu.org>
Cc: guix-devel <guix-devel@gnu.org>

 ---- On Mon, 13 Apr 2020 10:58:42 +0000 Ludovic Court=C3=A8s <ludo@gnu.org=
> wrote ----
 > Hello Guix!
 >=20
 > Scheme code snippets in the on-line manual now have hyperlinks for all
 > the symbols documented in the manual:
 >=20
 >   https://guix.gnu.org/manual/devel/en/html_node/Using-the-Configuration=
-System.html
 >   https://guix.gnu.org/manual/devel/en/html_node/Defining-Packages.html
 >=20
 > Hyperlinks are such an amazing invention!

That's great.


 > (If anyone knows how to get =E2=80=98a.syntax-symbol=E2=80=99 CSS differ=
ent from just
 > =E2=80=98a=E2=80=99, I=E2=80=99m all ears!)

I think to style links you should be using the pseudo classes like ":link",=
 ":hover", ":visited", etc. So, for example:

a.syntax-symbol:link {
    color: black;
}

If I understand correctly, that should work.

 > This is happening in =E2=80=98doc/build.scm=E2=80=99 as a post-processin=
g step on the
 > makeinfo-generated HTML (along with the syntax-highlighting
 > post-processing step).  It works well but there can be false positives
 > because it matches on identifiers, without taking scope etc. into
 > account=E2=80=94e.g., anytime =E2=80=9Cservice=E2=80=9D appears, it=E2=
=80=99ll link to the =E2=80=98service=E2=80=99
 > procedure.

I still don't understand why Texinfo doesn't provide syntax for allowing th=
e HTML exporter to do that... Something like a @codeblock that accepts a la=
nguage argument...