[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Hyperlinks!
From: |
Christopher Lemmer Webber |
Subject: |
Re: Hyperlinks! |
Date: |
Tue, 14 Apr 2020 14:41:50 -0400 |
User-agent: |
mu4e 1.2.0; emacs 26.3 |
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ès 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 ‘a.syntax-symbol’ CSS different from just
> ‘a’, I’m all ears!)
>
> This is happening in ‘doc/build.scm’ 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—e.g., anytime “service” appears, it’ll link to the ‘service’
> procedure.
>
> I’d like to extend it to include references to the Guile manual, so that
> one could click on, say, ‘append’, 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…
>
> Feedback welcome!
>
> Ludo’.