Create a detailed Theme Creation Howto Guide

[andrew-simmons]

The current theme documentation page Produce Custom Themes Using the Asciidoctor Stylesheet Factory feels very spartan and is focused more on applying available themes than on creating new ones. A walk through or a more in depth guide explaining how themes work in Asciidoctor would be helpful.

[mojavelinux]

I totally agree.

I do want to mention that I'd like to complete the upgrade to Foundation 5 and the refactoring before writing the guide because the current way of creating themes just isn't right yet...and will change. See the following issues:

• resolves #19 - migrate to Foundation 5 asciidoctor-stylesheet-factory#23
• isolate stylesheets for use with embedded documents asciidoctor-stylesheet-factory#2

[mojavelinux]

The stylesheet factory is no longer maintained and the default stylesheet has been pulled into the core repository. We're now deferring to the asciidoctor-skins project as an example of how to create themes. You also have the option of downloading the unprocessed source of the default stylesheet and customizing it to suit your needs. I've redirected the aforementioned page to the page in the new documentation site that covers this topic.

One of the goals of the modern HTML converter (currently under development) will be to provide a style guide for how to write a custom stylesheet (in plain CSS) to style and theme the HTML. See asciidoctor/asciidoctor#4171. That's where we'll focus our attention.