briandominick

AJYL DocStack

AsciiDoc

Jekyll

briandominick

There are 28 static site generators that support AsciiDoc sourcing.

briandominick

1. Copies content/ to _build/, without carrying the parent directory.

2. Copies theme/ to _build/.

3. Performs the first round of product-data parsing to build two structurally vital files, sourcing data in data/product.yml.

   1. Builds the page metadata (_build/includes/_built_page-meta.adoc) included in all HTML and PDF exposures of topics, but only relevant as Jekyll page metadata at this time.

   2. Builds the metadata file _build/includes/_built_page-meta.adoc based on the user stories in product.yml, looping over them as directed in _templates/liquid/page-meta.asciidoc. The topics metadata is drawn from this preprocessed file (_build_page-meta.adoc).

4. Draws data from the `data/meta.yml`and parses it as follows:

   1. Builds _build/includes/_built_company-info.adoc pressed with the template _templates/liquid/company-info.asciidoc.

5. Draws data from the `data/terms.yml`and parses it as follows:

briandominick

/*
This is what I dump in my Atom editor stylesheet file (Atom > Stylesheet).
 */

/// EDITOR

::-webkit-scrollbar {
    display: none;
}

briandominick

Testing Markdown Gist

This is a gist written in Markdown. Let's see how it works.