[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: RFC: Adding syntax highlighting to the official documentation
From: |
wheelerwjx9 |
Subject: |
Re: RFC: Adding syntax highlighting to the official documentation |
Date: |
Sat, 18 Dec 2021 10:31:34 -0600 |
When employing color in printed text, or print requivalent text, please be
considerated of your readers who are color blind or have attention problems
related to color.
For the former you need to provide a way to completely remove color from the
material without making it un-readable. For example, in the colorized code
shared earlier, and depending on visual imparment, words that are in color
could be completely missing for some readers.
For, the later group, a way to opt out of colorization should be considered a
requirement. I have seen text books that I personaly cannot read because some
who owned the book before had taken a hilighter to.
Thank you,
John Wheeler
________________________________
From: Jean Abou Samra <jean@abou-samra.fr>
Sent: Saturday, December 18, 2021 08:08
To: lilypond-devel
Subject: RFC: Adding syntax highlighting to the official documentation
Hi,
This might not have been very visible from the
title of the thread "ANN: Pygments support for
LilyPond", so here is a new thread with an
appropriate subject.
I'm proposing to add syntax highlighting to
our documentation. The merge request is
https://gitlab.com/lilypond/lilypond/-/merge_requests/1019
An example of how it would look like is
given on the MR, and also attached to
this email. See
https://gitlab.com/lilypond/lilypond/-/merge_requests/1019#note_786270004
for how to tinker with the style yourself.
For now, the proposal is exclusively about
HTML output. Werner has expressed interest
in adding highlighting to the PDF manuals as
well (and I agreed to help), but this is much
more complicated technically and it's not
clear if it should be done with colors,
black-and-white, or not at all.
Feedback is appreciated.
Regards,
Jean
**
- RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/18
- Re: RFC: Adding syntax highlighting to the official documentation,
wheelerwjx9 <=
- Re: RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/18
- Re: RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/19
- Re: RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/28
- Re: RFC: Adding syntax highlighting to the official documentation, Thomas Morley, 2021/12/28
- Re: RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/30
- Re: RFC: Adding syntax highlighting to the official documentation, Jean Abou Samra, 2021/12/30
- Re: RFC: Adding syntax highlighting to the official documentation, Dan Eble, 2021/12/30