From: "Ludovic Courtès" <ludo@gnu.org>
To: guix-devel@gnu.org
Subject: Hyperlinks!
Date: Mon, 13 Apr 2020 12:58:42 +0200 [thread overview]
Message-ID: <87eesrlkil.fsf@gnu.org> (raw)
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’.
next reply other threads:[~2020-04-13 10:58 UTC|newest]
Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-04-13 10:58 Ludovic Courtès [this message]
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87eesrlkil.fsf@gnu.org \
--to=ludo@gnu.org \
--cc=guix-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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.