xesite/blog/site-update-2021-12-19.mark...

5.6 KiB

title date
Site Updates: Better Contrast Ratio and Using Xeact 2021-12-19

Happy holidays all! As the year rolls to a close I wanted to take a moment to let you know of some improvements that I've done over the year to try and make the reading experience as best as it can be.

Better Contrast Ratio

Over the years I have gotten reports that my site is hard to read. I've been taking them seriously but I have never really been sure what to do about them. I think I have found the core of the problem and I have changed the site's contrast ratio to hopefully have more contrast between the text of the website and the background.

Here are some comparisons to before and after the change:

This is what my site looked like before I made the changes (dark mode).
This is what my site looks like after I made the changes (dark mode).
This is what my site looked like before I made the changes (light mode).
This is what my site looks like after I made the changes (light mode).

Hopefully this should improve the contrast ratio a lot more. I've always wanted this website to look a lot like my emacs config, but these changes should hopefully reach a balance of readability and stylistic choices to get across the vision I have for my website.

Using Xeact

I want to use Xeact more in my website. I am trying to hit a balance of avoiding structural JavaScript while also allowing me to experiment with new and interesting ways of doing things. To this end I have created a custom HTML element that allows me to embed the little conversation fragments that I feel makes this blog unique. They are currently done by a horrific hack I made to my markdown parser. This also makes it hard for me to put links in the little conversation fragments, so when you see me do that, that's because I've written something of this form:

[This is a test <a href="https://zombo.com">with a link</a>.](conversation://Mara/hacker)

This is a test with a link.

This has become an unworkable mess. With the html component I made recently, I can instead write things that look like this:

<xeblog-conv name="Mara" mood="hacker">
This is a test [with a link](https://zombo.com).
</xeblog-conv>

This is a test with a link.

This lets me use Xeact in a way that allows me to enhance the experience of using my website as well as my experience in writing it. I don't really like how this adds JavaScript into the mix for rendering the page. I have tried to avoid it, but this is getting unworkable for me. When I get things to the point that I feel more comfortable with making it the default option (this may involve some custom hacking to the CSS to make it degrade more gracefully, I don't know what I'm doing here), I will use it more as my main way to write these asides. Until then, I can deal with the link syntax form. I may end up writing something to munge things into place.

This also depends on you having modern JavaScript support. I can't change anything about that without introducing pain and suffering to my development workflow.

This also breaks people reading the RSS feed, but it's already been pretty darn broken already. Worst case this makes people a bit confused with the RSS feed, but until I can find a good workaround I think I can tolerate this weirdness.

I am not good with CSS.

Server-side Syntax Highlighting

You may have noticed that code syntax highlighting has a notably different color scheme to it compared to the rest of the blog as of late. This is not on accident. I used to use Prism to do this on the client side. This worked great, but Prism is a huge (near 1 MB) download. I really want to avoid wasting bandwidth, so I added this at the markdown rendering step with syntect. The theme I use (base16-mocha) is not perfectly aligned with my editor, but this is as close as I can get with their default themes until I have the energy to port gruvbox into this.

Hopefully this should work in the RSS feed too.


Have a good rest of the year and stay safe! I'm gonna try and take a load off over the holidays, so I may end up posting less frequently. 2021 has been a lot.

Please get vaccinated. I want to be able to travel for conventions without it being so scary all the time.