Posted by Stefan_Salewski on Mar 02, 2020; 8:34am
URL: https://discuss.asciidoctor.org/Some-theming-questions-tp7714.html

I started using Asciidoctor some years ago, for example I wrote http://ssalewski.de/gintroreadme.html with it using the default theme.

Yesterday I tried to learn about custom theming, following the instructions from https://asciidoctor.org/docs/produce-custom-themes-using-asciidoctor-stylesheet-factory/. Unfortunately that page contains some bugs in it description, I considered reporting them, maybe there is somewhere an issue tracker for it. But then at the end of that page I saw a link to this forum/mailingList, followed it and saw https://discuss.asciidoctor.org/Stylesheet-factory-question-td7565.html

>I'll be honest, I don't recommend using the stylesheet factory.

That is a bit surprising. So reporting documentation bugs makes no sense any more?

You recommend https://github.com/darshandsoni/asciidoctor-skins instead, which are plain CSS styles now? They promise to cover the factory themes also, but when I clicked for example on https://darshandsoni.com/asciidoctor-skins/?adoc-riak.css or https://darshandsoni.com/asciidoctor-skins/?adoc-maker.css only the default theme is used. That is confusing.