[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: RFC: Adding syntax highlighting to the official documentation
From: |
Jean Abou Samra |
Subject: |
Re: RFC: Adding syntax highlighting to the official documentation |
Date: |
Sat, 18 Dec 2021 18:38:42 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1 |
Hi John,
Le 18/12/2021 à 17:31, wheelerwjx9@runbox.com a écrit :
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.
I am not sure I understand the issues at
hand well. I thought it would suffice to
design the color scheme with high enough
contrast so that the code would stay readable
for people with impaired vision. I have
been using the WCAG contrast indicator for
that. It's true that the first proposed
style had bad contrast (I didn't realize
the problem at that time), but the new one
has a minimum of 6.1 which I thought would
be enough above the AA level of 4.5. Do
you think it is necessary to provide a way
to opt out of syntax highlighting nevertheless?
By printed text, do you mean the PDF output,
or also HTML output? (I thought there would
be tools to remove color when browsing?)
Could you say more about 'attention problems
related to colors'? I don't know much about
this topic, but I am curious to learn more.
Thanks,
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, 2021/12/18
- Re: RFC: Adding syntax highlighting to the official documentation,
Jean Abou Samra <=
- 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
- Re: RFC: Adding syntax highlighting to the official documentation, Wols Lists, 2021/12/31