Project

asciibuild

0.01
No commit activity in last 3 years
No release in over 3 years
Orchestrate and document processes by inlining executable code into an Asciidoc document
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Runtime

 Project Readme

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.

asciibuild

Sections

Documentation is broken up into the following sections:

LICENSE

asciibuild is licensed under the Apache 2.0 license.