graphitefriction/oscon-2013-docs-workshop

Provide a SASS stylesheet for AsciiDoc that can be used in an Awestruct site

Opened this issue · 0 comments

HTML generated from AsciiDoc (using the html5 backend) requires custom styling to look complete. In order to use AsciiDoc content in an Awestruct site, those styles need to be made available.

Isolate the portions of the SASS stylesheets from the Asciidoctor stylesheet factory that are applicable to AsciiDoc rendered as embeddable HTML. Make these SASS source files available so they can be imported (i.e., copied) into an Awestruct site.

We want to bring over the SASS stylesheets rather than the CSS generated from them so it's possible for the user to customize the look and feel of the content in tandem with the look and feel of the overall site (i.e., the framing).

I expect that they will carry over the following files into the stylesheets directory of an Awestruct site:

  • _asciidoc-content.scss (split off from _asciidoc.scss)
  • _settings-defaults.scss (imports normalize, foundation bits and compass bits)
  • _settings.scss (imports settings-defaults)
  • _awesome-icons.scss

The styles.scss file would then look like:

@import "settings"
@import "asciidoc-content"
@import "awesome-icons"

// site layout styles should go here
// the site layout styles should conform to the content styling,
// staying true to the principle of docs as first-class citizen