Skip to content

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

@mojavelinux

Description

@mojavelinux

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions