From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christopher Lemmer Webber Subject: Re: Hyperlinks! Date: Tue, 14 Apr 2020 14:41:50 -0400 Message-ID: <87v9m1hpu9.fsf@dustycloud.org> References: <87eesrlkil.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:34014) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jOQVM-0000G4-Vw for guix-devel@gnu.org; Tue, 14 Apr 2020 14:41:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jOQVL-00027t-Q8 for guix-devel@gnu.org; Tue, 14 Apr 2020 14:41:52 -0400 Received: from dustycloud.org ([2600:3c02::f03c:91ff:feae:cb51]:43436) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jOQVL-00026p-MP for guix-devel@gnu.org; Tue, 14 Apr 2020 14:41:51 -0400 Received: from twig (localhost [127.0.0.1]) by dustycloud.org (Postfix) with ESMTPS id 8E62D2663C for ; Tue, 14 Apr 2020 14:41:50 -0400 (EDT) In-reply-to: <87eesrlkil.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org This is very nice. The rainbow parenthesis matching is really excellent too. Guix has managed to make Texinfo html export look really nice! I admit I expressed skepticism in this endeavour a number of years back and am happy to be incorrect. Ludovic Court=C3=A8s writes: > Hello Guix! > > Scheme code snippets in the on-line manual now have hyperlinks for all > the symbols documented in the manual: > > 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 > > Hyperlinks are such an amazing invention! > > (If anyone knows how to get =E2=80=98a.syntax-symbol=E2=80=99 CSS differe= nt from just > =E2=80=98a=E2=80=99, I=E2=80=99m all ears!) > > This is happening in =E2=80=98doc/build.scm=E2=80=99 as a post-processing= 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=E2=80=99d like to extend it to include references to the Guile manual, = so that > one could click on, say, =E2=80=98append=E2=80=99, but there might be too= many false > positives at that point. And then we would need DrRacket fanciness to > be able to determine what an identifier really refers to=E2=80=A6 > > Feedback welcome! > > Ludo=E2=80=99.