blog VS chroma

I noticed that after deployment images were broken after further research it became clear that this happens because we are using baseURL with path - https://imomaliev.github.io/blog/. This is known behavior. It does look like a bug to me, but maintainers decided to close this issue as "wontfix" for now. In the future, I am planning to host this blog on my domain without additional path in baseURL, but for now I fixed it by using relative paths instead ones starting with leading /.

I will start from the very beginning and create this blog from the scratch. This series is called "Building the blog while flying it". In the spirit of famous startup quote/approach, "Building the plane while flying it"1. I think I will have a lot of fun. I am going to start by posting to my dev.to page and host blog repository on the GitHub. My first version of this blog is living in the blog-v1 repo.

Hugo uses chroma for code highlighting. It works well with the default configuration, but I want to go further, such as having the code block theme switch along with the light and dark modes, and providing code block copying functionality.

In Hugo and its built-in Chroma syntax highlighting, a code block begins with:

Hugo -> goldmark -> goldmark-highlighting -> chroma

I've used a markdown to html converter to convert my blog posts into HTML with very nice and customizable code samples... in my case I used Go's Blackfriday library with bfchroma[1] doing syntax highlighting with Chroma[2]. To add your language to Chroma you have to provide a lexer, which in turn is written in Pygments[3] syntax.

[1] https://github.com/Depado/bfchroma/

[2] https://github.com/alecthomas/chroma#supported-languages

[3] https://pygments.org/docs/lexerdevelopment/

quick for generating Html and syntax highlighting code blocks

Chroma

For books from other publishers, I am just hardcoding language directly on an ad hoc basis. I briefly considered off-loading language detection to a library like chroma, but that might be too much work for little benefit.