Skip to content

Instantly share code, notes, and snippets.

View briandominick's full-sized avatar
💭
Available for DocOps contracts

Brian Dominick briandominick

💭
Available for DocOps contracts
View GitHub Profile
@briandominick
briandominick / asciidoc-static.adoc
Last active February 29, 2024 20:54
Static Site Generators with AsciiDoc Support
View asciidoc-static.adoc

There are 27 static site generators that support AsciiDoc sourcing.

View AltPet.json
{
"Pet": {
"type": "object",
"required": [
"name",
"photoUrls"
],
"properties": {
"id": {
"type": "integer",
@briandominick
briandominick / doc-ops-consulting-agreement.adoc
Last active July 19, 2022 17:29
Sample DocOps Consulting Agreement (Prime Source)
View doc-ops-consulting-agreement.adoc

Documentation Engineering Consulting Agreement

@briandominick
briandominick / Jekyll Version Switcher
Last active March 3, 2022 05:29
Versioning system for Jekyll
@briandominick
briandominick / ajyl-docstack-intro.adoc
Last active April 22, 2020 16:03
Introducing the AJYL Docstack
View ajyl-docstack-intro.adoc

AJYL DocStack

AsciiDoc

Jekyll

@briandominick
briandominick / Jekyll Build Scripts
Last active February 8, 2020 01:10
An environment- and version-aware command-line wrapper for Jekyll builds
View Jekyll Build Scripts
# See README.adoc
@briandominick
briandominick / bibisco-install-ubuntu.adoc
Created October 6, 2019 23:49
Install Bibisco on Ubuntu 19.04
View bibisco-install-ubuntu.adoc

Setting up Bibisco on Ubuntu 19.04

(tested on PopOS 19.04)

  1. Download linux archive from Bibisco.

  2. Move files to better path.

    sudo mv ~/Downloads/bibisco-blah-blah/ ~/opt/bibisco
@briandominick
briandominick / fusuma-config.yml
Created August 26, 2019 04:31
Configuration file for fusuma touchpad gestures
View fusuma-config.yml
# Fusuma makes Linux touchpads better
# See https://github.com/iberianpig/fusuma
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key super'
@briandominick
briandominick / _built_config-explainer.adoc
Created February 23, 2018 03:24
A programmatically generated narrative of a preconfigured build operation in LiquiDoc.
View _built_config-explainer.adoc
  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
briandominick / atom-asciidoc-custom.css
Last active February 20, 2018 00:42
Custom styles for AsciiDoc syntax highlighting in Atom
View atom-asciidoc-custom.css
/*
This is what I dump in my Atom editor stylesheet file (Atom > Stylesheet).
*/
/// EDITOR
::-webkit-scrollbar {
display: none;
}