Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sass: Add Sample Doc to Test CSS Changes #97

Open
4 tasks
tajmone opened this issue Oct 3, 2020 · 1 comment
Open
4 tasks

Sass: Add Sample Doc to Test CSS Changes #97

tajmone opened this issue Oct 3, 2020 · 1 comment
Labels
🕑 pending decision Issue/solution still being evaluated 🔨 Asciidoctor Tool: Asciidoctor 🔨 Highlight Tool: Highlight 🔨 Sass Tool: Dart Sass

Comments

@tajmone
Copy link
Collaborator

tajmone commented Oct 3, 2020

In assets_src/sass/ we need to add a sample HTML document to quickly test changes to the Sass/CSS stylesheet, without having to also rebuild the docinfo.html file and the actual documents to preview results.

The sample HTML doc should obviously be generated from AsciiDoc sources. So we might include the ADoc source in the folder as well (or in a subfolder maybe).

  • Add a sample HTML document containing all required ALAN code blocks (and whatever custom styles we're defining); this document must import the stylesheet from the current folder (i.e. not embed it) so that by refreshing the HTML page one can see the results of CSS changes:
    • Add ADoc sources of sample document (in subfolder?).
    • Add HTML generated sample document.
  • Add a sass watch script? (maybe not needed right now, since there's only one CSS shared by all docs).
@tajmone tajmone added 🕑 pending implementation Approved changes waiting to be implemented 🔨 Asciidoctor Tool: Asciidoctor 🔨 Highlight Tool: Highlight 🔨 Sass Tool: Dart Sass labels Oct 3, 2020
@tajmone tajmone added 🕑 pending decision Issue/solution still being evaluated and removed 🕑 pending implementation Approved changes waiting to be implemented labels Oct 11, 2021
@tajmone
Copy link
Collaborator Author

tajmone commented Oct 11, 2021

IMPORTANT! — None of the above really matters if we end up reusing the DocInfo file created on ALAN-Docs (see #130).

So we might want to wait and see whether we'll be keeping our own custom Sass/CSS or not.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🕑 pending decision Issue/solution still being evaluated 🔨 Asciidoctor Tool: Asciidoctor 🔨 Highlight Tool: Highlight 🔨 Sass Tool: Dart Sass
Projects
None yet
Development

No branches or pull requests

1 participant