Re: Modernize asciidoctor.css
Posted by
cristatus on
URL: https://discuss.asciidoctor.org/Modernize-asciidoctor-css-tp7890p7914.html
Dan,
I was able to remove compass dependency completely and migrated to node-sass and the resulting css is almost identical. The zurb foundation dependency is also minimal, so it can also be removed easily. However, as I checked it further and as you suggest, it's better to start a new work and modularize the style as bellow:
1. optional global styles (normalize + some common global html styling)
2. asciidoctor styles (for asciidoctor elements but with minimal styling so that it can blend well with other css frameworks)
3. keep the palette and corresponding css variables minimal
The use of global styles is optional and should provide similar result as current asciidoctor.css.
I will publish the initial work next week.
On Sun, Apr 19, 2020 at 11:44 AM mojavelinux [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
Amit,
Thank you for volunteering to do this work.
It would be best if you just started a new project. The stylesheet factory was developed to create the default stylesheet for Asciidoctor and continues to serve that purpose. While it included some additional themes, they were very much just an experiment. I no longer maintain those themes, and as you've pointed out, the technology is quite old and cumbersome. There's no reason to continue propagating that legacy set up. It would be better just to start something new and propose it as a replacement.
Best Regards,
-Dan
On Mon, Apr 13, 2020 at 9:17 AM cristatus [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
Hi all,
I have been using Asciidoctor for documentation purpose since long but I always found it difficult to embed the generated docs because of conflicting and global css rules generated by asciidoctor.
I am thinking of forking asciidoctor-style-factory with following goals:
1. only keep asciidoctor.scss
2. remove compass dependency
3. migrate to node-sass
4. remove foundation dependency and copy required mixing/rules (there seems to be only few)
5. use css variables to make it easy to customize (only works with modern browsers)
6. provide 4 variants
The variants (theme):
1. default theme - like current one with minimal difference (because css variables are not sass)
2. light theme - with different colors than default one
3. dark theme - as the name says
4. high-contrast theme - to make it more readable for visually impaired individuals
I did some work in this direction but would like to hear from you guys for some suggestions.
Regards
--
Amit
--