Some theming questions

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.

I just don't have time to maintain the stylesheet factory right now. Its sole intent has become to build the default stylesheet (until we have a suitable replacement). So filing issues against it won't be a good use of
anyone's time.

If someone wants to make a successor to the stylesheet factory that's maintained and more consumable to users, I'd support that effort.

The information about the stylesheet factory has been removed from the new documentation site, so the docs will reflect the current situation once they are published.

At the end of the day, the stylesheet is just CSS, so you can create it however you want. The stylesheet factory was designed to make that a bit easier, but given how outdated it has become, it's actually making it harder. Hence why I don't recommend it anymore.

Best Regards,

-Dan


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

> 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.

If you use the menu at the top of the screen, the stylesheet changes. It doesn't seem to be responding to the query string parameter. I recommend filing an issue against that project.

Best Regards,

-Dan

--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

Thank you for your response.

>If you use the menu at the top of the screen, the stylesheet changes.

Indeed, but for maker and riak theme the background picture is not applied.

Will download the CSS files and see if I get it working locally.

--