asciidoctor / asciidoctor-stylesheet-factory

!DEPRECATED! This was the utility project for producing the default stylesheet for the HTML converter in Asciidoctor. The source of the default stylesheet now lives in the main Asciidoctor repository.
Other
175 stars 87 forks source link

Publish or bundle styles so that they can be consumed by tools #27

Open mojavelinux opened 8 years ago

mojavelinux commented 8 years ago

Currently, we aren't publishing the styles (at least not in any sort of automated fashion) so that they can be consumed by other tools. We should figure out how to do this so that these themes are available to Asciidoctor users without having to run the stylesheet factory build manually.

jakoch commented 8 years ago

We should figure out how to do this so that these themes are available to Asciidoctor users without having to run the stylesheet factory build manually.

I'd suggest compiling, zipping and auto-deploying the styles to Github Releases using Travis CI.

The same approach is useful for automatically publishing the stylesheet previews (themes.asciidoctor.org), which are now living in the gh-pages branch.

jaredmorgs commented 5 years ago

By sniffing out the sources on http://themes.asciidoctor.org/preview/ I found the location of some of the CSS files. For example, http://themes.asciidoctor.org/stylesheets/asciidoctor.css?v=8

I've been trying to use these style bundles in https://github.com/norganna/adoc-usermacro/issues/5 to get access to some form of css styles that are hosted somewhere. But I think my idea of what constitutes "hosted" here is wrong. That is the css file http://themes.asciidoctor.org/stylesheets/asciidoctor.css?v=8 is not something that can be consumed within another app.

Is my understanding correct?

mojavelinux commented 5 years ago

The stylesheet factory is mostly a defunct experiment at this point. The stylesheets aren't maintained anymore, except for the default one. The only reason this repository still exists is to produce the default stylesheet, until we have another way. There are efforts at a reboot, but we'll likely cut out the use of Foundation just to keep it simpler and easier to maintain.

In the meantime, you can find linkable stylesheets here: https://github.com/darshandsoni/asciidoctor-skins

the css file http://themes.asciidoctor.org/stylesheets/asciidoctor.css?v=8 is not something that can be consumed within another app.

That is the stylesheet, but I wouldn't depend on it like that. This is not a CDN.