jirutka / asciidoctor-html5s

Semantic HTML5 converter (backend) for Asciidoctor
MIT License
89 stars 10 forks source link

Dedicated Stylesheets? #16

Open tajmone opened 4 years ago

tajmone commented 4 years ago

Great job! This was something really needed. I see that now it's also available for Asciidoctor Ruby (if I remember correctly, initially it was only supported for the Node version).

I wanted to ask you if there are some CSS stylesheets (or even better, SASS/SCSS project) designed for the HTML output of this backend — e.g. sample documents or books that one could look at for inspiration.

Also, are you planning to create a SASS (or Less, etc.) core library to go with this repository, or even a dedicated "factory template"?

I'm planning to use this extension in an upcoming book publication, so I'll probably be looking into adapting some existing SASS framework to go with it, and I'll be happy to share it when (and if) I manage to (but it won't be anywere soon, though). But of course, any existing examples resources would be a helpful inspiration and starting point in that direction. Having gone through the whole process in the past (for pandoc templates) I know too weel that it can take a good deal of time to create a good stylesheet that covers all the possible elements, layout variants and options (especially if it has to be also mobile and tablet friendly).

Having a customizable SASS framework to go with this project, allowing to produce fully-templated HTML5 docs would be a great milestone, especially if it was an easy to use framework around which different templates-styles could be built. I hope I'll be able to contribute my share in that direction because I use AsciiDoc a lot and I really feel the need for a semantic-HTML alternative like this, and means to customize templates easily.