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 <j...@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 

**

Reply via email to