link colours
-
Hello I have a problem with the colour of links on the Qt documentation pages Pale green against a light background is really hard to read. Changing to dark mode is even worse, dark purple against a black background. The documentation itself is great, but a lot of it is made up of links (which is a good thing) so a large part of it I find unreadable.
My workaround is to use a browser extension to modify page colours. Not ideal but I get by.
Am I the only one whose tired old eyes just can't cope with this colour scheme? It really is quite awful to work with. The python pages are somehow even worse to read, maybe they have a slightly different css behind them.
I am experimenting with different GUIs for a python application and this really puts me off wanting to use Qt. (Please don't tell me to go use something else then. This is a problem that should be fixed).
EDIT - To be fair, it is really only the python pages that are unreadable, the main pages are difficult but I can get by. Unfortunately it is the python documentation that I need to be able to read so I would really appreciate if that could be improved..
-
Hmm no response yet. Well, even if it is just me, the Qt python documentation pages measurably fail to meet basic standards which I think is a poor reflection on Qt..
The Web Content Accessibility Guidelines (WCAG) 2.1 Success Criterion 1.4.3 Contrast (Minimum) recommends:
The visual presentation of text and images of text has a contrast ratio of at least 4.5:1
https://www.w3.org/TR/WCAG21/#contrast-minimum.Using an online contrast checker, we can see how it fails to meet that criteria.
-
Hi,
@Pedro @CristianMaureira, can you investigate that ?
-
@greenfuse said in link colours:
Hmm no response yet. Well, even if it is just me, the Qt python documentation pages measurably fail to meet basic standards which I think is a poor reflection on Qt..
The forum is a community focus platform for general discussion. You should not assume that issues like the one you describe could be solved by the development team, because the proper way is either filing a Suggestion or Bug report (some people can argue that wrong colors are bugs) on the official platform, which is https://bugreports.qt.io you can find more information in https://wiki.qt.io/Qt_for_Python/Reporting_Bugs (at least for PySide)
Ideally, a contribution can be made, due to to this issue not requiring building, nor debugging but just replacing the color from the corresponding CSS, in PySide for example, you can see the file in https://code.qt.io/cgit/pyside/pyside-setup.git/tree/sources/pyside6/doc/_themes/pysidedocs/static/pyside.css where there are many places where #41cd52 is being used, due to it being the official green color https://brand.qt.io/design#colours
I'd be more than happy to review such change, and completely in favor of improving the readability of the page. -
This is how it would look like using the colors #41cd52 for the dark theme, and #004f7b for the light one.
I'm not sure if your problem was maybe in some other specific part of the documentation where something was not clear, because the color can be handled different there.
-
Thank you for your response @CristianMaureira . I have created a Suggestion as you recommended.
I like your idea for a resolution by switching link colours between dark and light themes. Your support is appreciated. An example of a page which I find hard to read is Qt for Python contents
