Hey everyone! Just added syntax highlighting to the Hologram website.
What seemed like a simple task turned into quite the adventure. Custom parsers, formatters, and an endless cycle of “hmm, maybe this shade of blue would look better…” made me realize this would be a significant time investment. Even though I started working on it before the playable release, I decided to postpone it to focus on getting the playable version out faster.
So… on a scale from “my eyes are bleeding” to “ooh, pretty!”, how’s the color scheme working for you? 
Would you like me to adjust anything?
P.S. Thanks @D4no0 and @christhekeele for the feedback re syntax highlighting (in the Documentation Updates thread), and @tmbb for the awesome Makeup library that made it possible!
4 Likes
Colors look good to me except the yellow braces - they’re a bit distracting. On Hexdocs the braces are text color (light gray), and I think that looks better.
For the docs overall, the font size is way too big and the column width is too wide. Both look about perfect to me on Hexdocs, so I would just grab what they use and that would help a lot with readability.
Also, there is a typo in the code for “Expression Longhand Syntax” (closing brace). I was going to link the line but I can’t actually find the repo for the site (is it closed?) so hopefully you find it! 
2 Likes
Oh and this is definitely not highlighting-related (sorry), but you should probably add anchors to the sections on each page. A simple “#” next to each section title (preferably hide unless hovered) should suffice.
2 Likes
Thanks for the feedback and bug report @garrison!
The missing curly brace is now fixed. About the yellow braces - currently I’m using yellow for all curly braces, though they’re part of a planned nesting-based color system where different nesting levels will have distinct colors (similar to IDE themes), with yellow appearing at level 3 of nesting. I’ll probably prepare a few different variants and make a poll, as I know sometimes people hesitate to share critical feedback directly.
I appreciate the font size feedback from Hexdocs - that’s a good reference point for readability. And yes, section anchors are coming soon! Actually planning to add a nice fixed sidebar on the right showing the current page’s contents.
2 Likes
