zig.guide icon indicating copy to clipboard operation
zig.guide copied to clipboard

Unreadable due to colors

Open mark-summerfield opened this issue 3 years ago • 7 comments

This tutorial is unreadable because of the poor color contrast. The first line of the first example: const std = @import("std"); I can only read the = sign if I use very big fonts since the contrast between red and black is so low. I know that black is very fashionable as a background but it is useless for reading.

On a side note the instructions for setting the path in Windows don't mention using Control Panel; they should at least mention that possibility since not everyone uses powershell.

mark-summerfield avatar Oct 25 '20 09:10 mark-summerfield

I don't mean this offense, or as an attack in anyway. But are you color blind? The = sign is not red but pink for example. The background is not black but grey. For me it all looks fine. Or maybe you tallk about an older version.

clankill3r avatar Dec 28 '20 10:12 clankill3r

I am not color blind. The colors look red and black to me. But anyway that is really beside the point: what matters is that the contrast is so poor that the tutorial is unreadable.

mark-summerfield avatar Dec 28 '20 10:12 mark-summerfield

Are the colors on the image the same as on the website for you? poor_colors

clankill3r avatar Dec 28 '20 10:12 clankill3r

Yes black background. I agree that what I thought was red is some kind of dark pink. However the = and == are so blurred that they look like - and --; it is only the context which makes it clear to me that they are ='s. Also I'm guessing that 1 * has a * and similarly 3 *. So it seems that for some reason the dark pink is especially hard for me to read.

On Mon, 28 Dec 2020 at 10:28, Doeke Wartena [email protected] wrote:

Are the colors on the image the same as on the website for you? [image: poor_colors] https://user-images.githubusercontent.com/738650/103207894-bb3b0600-48ff-11eb-8260-c8bb17850153.png

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/Sobeston/ziglearn/issues/56#issuecomment-751665213, or unsubscribe https://github.com/notifications/unsubscribe-auth/AANQ6JH2ZTADOEU5HAK6XLLSXBMVJANCNFSM4S6GPY6A .

-- Mark Summerfield, Qtrac Ltd., www.qtrac.eu

mark-summerfield avatar Dec 28 '20 10:12 mark-summerfield

Can it be that you have a monitor with really bad contrast?

clankill3r avatar Dec 28 '20 10:12 clankill3r

No, since the same effect happens on my big-screen desktop and the laptop I'm replying on.

On Mon, 28 Dec 2020 at 10:35, Doeke Wartena [email protected] wrote:

Can it be that you have a monitor with really bad contrast?

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/Sobeston/ziglearn/issues/56#issuecomment-751667086, or unsubscribe https://github.com/notifications/unsubscribe-auth/AANQ6JG2LTHY2XZBI6XRWI3SXBNNZANCNFSM4S6GPY6A .

-- Mark Summerfield, Qtrac Ltd., www.qtrac.eu

mark-summerfield avatar Dec 28 '20 10:12 mark-summerfield

image image

I'm working on some front-end upgrades at the moment. Everything should be available in both light and dark mode soon-ish (respecting your OS/browser preferences). I just need to figure out how to get different syntax highlighting working on the light theme and all is good.

For the mean time, you should be able to view the content clearly from the github repo itself - github renders all the markdown well as far as I can tell.

Sobeston avatar Jan 08 '21 22:01 Sobeston

Closed in https://github.com/Sobeston/ziglearn/pull/197

Sobeston avatar Jan 07 '24 04:01 Sobeston