asciibuild - Literate Programming extensions for Asciidoctor
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.
Sections
Documentation is broken up into the following sections:
LICENSE
asciibuild
is licensed under the Apache 2.0 license.