asciibuild is an extension to Asciidoctor that enables literate programming with Asciidoc. It turns the listing block into executable code. When you run asciibuild on an .adoc file that has listing blocks styled with the [asciibuild] style, those listing blocks will be executed as they are evaluated by Asciidoctor.

Think of asciibuild as a simple Notebook. It doesn’t require anything but a text editor to create or edit and only command-line tools to run. It allows you put everything related to a process—​whether build, test, or orchestration—​into source control and lets you use your existing tools and CI/CD workflows.

Use asciibuild to create full builds, aggregate projects of different kinds that use entirely different build systems, mix multiple languages together in a single .adoc file, or create examples and test suites that intermingle the code under test with documentation about the tests.

Documentation is broken up into the following sections:

doc/BUILD.adoc

doc/USAGE.adoc

doc/DOCKER.adoc

asciibuild is licensed under the Apache 2.0 license.