#36870: Insufficient contrast in console-style code blocks
-------------------------------------+-------------------------------------
Reporter: Clifford Gama | Type:
| Uncategorized
Status: new | Component:
| Documentation
Version: 6.0 | Severity: Normal
Keywords: Accessibility, WCAG | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Not sure if this is the correct place to report this. Several console-
style code blocks in the Django documentation fail WCAG contrast
requirements, making commands and outputs difficult to read.
From some investigation, I've found that the issue applies to the
following directives (they may be others):
1. `.. console::` blocks where lines do _not_ begin with the `$` shell
prompt. (If the commands begin with the prompt, they are rendered with
better contrast, and with the widget for switching between Windows/Linux-
style command prompts). But because of the third case below, this may not
be a full solution)
2. `.. doscon::` blocks
3. Shell output blocks (i.e. command results, not user input)
These blocks currently render with the following colors:
Dark theme: Background: `#181d27` ; Foreground: `#8b949e` (fails WCAG AAA
(normal text))
Light theme: Background: `#F8F8F8` ; Foreground: `#808080` (fails WCAG AA
(normal text) fails WCAG AAA (normal and Large text)
I checked using [https://colourcontrast.cc/]
This problem is particularly noticeable on the
[https://docs.djangoproject.com/en/6.0/ref/django-admin/ django-admin ref
docs] where several console commands do not prepend the $ prompt.
--
Ticket URL: <https://code.djangoproject.com/ticket/36870>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/django-updates/0107019bd1187e36-7a30ea15-00cb-4565-9c81-5785fc85b2c3-000000%40eu-central-1.amazonses.com.
