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.
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.
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.
asciibuild is licensed under the Apache 2.0 license.