Brian Dominick briandominick

Documentation Engineering Consulting Agreement

AsciiDoc

Jekyll

There are 28 static site generators that support AsciiDoc sourcing.

Copies content/ to _build/, without carrying the parent directory.
Copies theme/ to _build/.
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).
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.
Draws data from the `data/terms.yml`and parses it as follows:

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

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

	/// EDITOR

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