Nevertheless, she persisted

Asciidoctor implements a rich markup language with a nice syntax. I use it for notes, my website, and lecture materials.

Unfortunately, its rich feature set requires ccs support. The default style sheet is several thousand lines and ~35kb before compression / minification. This presents a significant challenge when creating a minimal theme.

I came across the Asciidoctor Skins project, and Stylesheet Factory. Both provide a selection of themes that override parts of the default theme using standard tricks (variables, imports, rule precedence).

The default stylesheet bears no comments, which would be helpful to understand which rules are cosmetic, add functionality, or improve cross browser compatibility.

I don’t want fonts, or font awesome icons (though they really are awesome). I’m not worried about ancient or minimal browsers (mobile and desktop is enough headache).

#Asciidoctor #Css #Static Site Generator #Dev