Inject "Chunk of code" in asciidoc document to create reproducible experiment
Hi,
I'm an academic, and i'm really really fan of Asciidoc format to write courses, technical documentation, etc.
As Donald Knuth already invented with latex and literacy programming (https://en.wikipedia.org/wiki/Literate_programming) , lots of scientists/academics investigate a lot of time into platform which help the reproducibility of publication AND the source code of their experiments.
You could find such idea of literacy programming in mainstream software/libraries :
- with R langage in RMarkdown format (https://rmarkdown.rstudio.com/), and the Bookdown (https://bookdown.org/yihui/bookdown/) implementation.
- with Python langage with Jupyter (https://jupyter.org/), and Jupytext (https://github.com/mwouts/jupytext).
I think this could be a very very good opportunity for Asciidoc/Ascidoctor/Antora to obtain the interest of the very big audience of scientifics by implementing or reusing extensions to :
- support of bibliography in document (parsing biblatex / bibtex using pandoc-citeproc https://github.com/jgm/pandoc-citeproc)
- inject "chunk of code" ( like https://bookdown.org/yihui/rmarkdown/r-code.html ) executed during compilation of the document (producing results of computation, charts, images, etc.)
I already created an entire course in python in asciidoc/asciidoctor, and in my dream i could inject any interactive python code directly in this document.