Grinnz/perldoc-browser

Difficult to read (Linux/Firefox)

Opened this issue · 15 comments

The light grey text in https://perldoc.pl/ is not easy to read
Any chance of changing css so that it renders in black ?

What browser/OS are you using? There's no light grey text for me...

Screenshot lost in transmission:- trying again
61868_screenshot

I can confirm the issue, this seems to be an issue in font rendering in Firefox on Linux. As a workaround I can make the text darker in code blocks but it still does not look good, I'm not sure there's anything else I can really do about it.

Again - thank you for your quick reply.
I dont pretend to understand CSS
but fyi CTRL-SHIFT-C in my Firefox
says of the line « perl Perl»
in the above screen shot "color:#222;" ...
Perhaps a bit pale?
Full result of CTRL SHIFT C -

#wrapperlicious pre > code {
color: #222;
font: 0.9em Consolas, Menlo, Monaco, Courier, monospace;
line-height: 1.5em;
text-align: left;
text-shadow: #eee 0 1px 0;
white-space: pre-wrap;

#222 is nearly black. It used to be #4d4d4c, which looks like this in Chrome on Linux:
mojolicious_docs_code_chrome

For Linux/Firefox I think it looks nice like this
screenshot
by simply doing
``
#wrapperlicious pre > code {

    font: 0.9em Consolas, Menlo, Monaco, Courier, monospace;
    line-height: 1.5em;
    text-align: left;
    text-shadow: #eee 0 1px 0;
    white-space: pre-wrap;
  }

I don't see any difference here in Firefox by removing that color setting, as it then simply inherits the color #212529 from bootstrap CSS, which is just about the same as #222. But if your browser renders it better for some reason I see no harm in doing so.

Please let me know if there are still font rendering issues.

This is still a problem for me on Firefox 84.0.2 (64 bit) under Ubuntu 20.04. In particular, comment lines in perl examples are very light gray, making them quite hard to read. See the attached screenshot.
Screenshot from 2021-01-13 14-30-30

Thanks for the report. I am in the process of considering a new syntax highlighter which will likely change the colors used in these blocks, and will revisit after.

Sounds good. Thanks for the quick response!

The new syntax highlighter has been deployed and is currently using the stack overflow light theme. Please let me know if this corrects the issue.

That is better, though I still wish all of the normal body fonts were darker. Only bold text has good contrast, but bold is only used in a few places. The vast majority of the text is still gray-on-gray, as you can see in this screenshot, which still makes it harder to read than it should be.
perldoc-screenshot

Compare the two attached screenshots. You can see that in the second one -- the screenshot of github in which I am writing this comment -- the main text has much better contrast than in the other screenshot.
github-screenshot