all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Hyperlinks!
@ 2020-04-13 10:58 Ludovic Courtès
  2020-04-13 11:13 ` Hyperlinks! Pierre Neidhardt
                   ` (8 more replies)
  0 siblings, 9 replies; 25+ messages in thread
From: Ludovic Courtès @ 2020-04-13 10:58 UTC (permalink / raw)
  To: guix-devel

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’.

^ permalink raw reply	[flat|nested] 25+ messages in thread

end of thread, other threads:[~2020-04-14 18:41 UTC | newest]

Thread overview: 25+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-04-13 10:58 Hyperlinks! Ludovic Courtès
2020-04-13 11:13 ` Hyperlinks! Pierre Neidhardt
2020-04-14 12:19   ` Hyperlinks! Konrad Hinsen
2020-04-13 11:26 ` Hyperlinks! Danny Milosavljevic
2020-04-13 15:10   ` Hyperlinks! Ludovic Courtès
2020-04-13 15:25     ` Hyperlinks! Julien Lepiller
2020-04-13 18:09   ` Hyperlinks! Ricardo Wurmus
2020-04-13 18:38     ` Hyperlinks! Danny Milosavljevic
2020-04-13 21:05       ` Hyperlinks! Ricardo Wurmus
2020-04-13 21:15         ` Hyperlinks! Danny Milosavljevic
2020-04-13 21:25           ` Hyperlinks! Ludovic Courtès
2020-04-13 11:51 ` Hyperlinks! Vincent Legoll
2020-04-13 11:57 ` Hyperlinks! Vincent Legoll
2020-04-13 13:48   ` Hyperlinks! Ludovic Courtès
2020-04-13 13:51     ` Hyperlinks! Vincent Legoll
2020-04-13 12:05 ` Hyperlinks! Vincent Legoll
2020-04-13 13:56   ` Hyperlinks! Ludovic Courtès
2020-04-13 14:41     ` Hyperlinks! Danny Milosavljevic
2020-04-13 14:45       ` Hyperlinks! Danny Milosavljevic
2020-04-13 15:59 ` Hyperlinks! Christopher Baines
2020-04-13 16:22 ` Hyperlinks! sirgazil
2020-04-14  7:09 ` Hyperlinks! Bengt Richter
2020-04-14  8:27   ` Hyperlinks! pelzflorian (Florian Pelz)
2020-04-14 10:34     ` Hyperlinks! Ludovic Courtès
2020-04-14 18:41 ` Hyperlinks! Christopher Lemmer Webber

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.