Literate Pandoc

Pandoc is a world famous "swiss-army" document converted. This is because Pandoc is also a document parser. Thanks to this capability, this repo is a Pandoc reader written in Lua for literate and natural programming (LNP), i.e.: "Programming [...] as the process of creating works of literature".

Requirements

With literate.lua downloaded and Pandoc installed, do:

pandoc -f PATH/TO/literate.lua -t FORMAT DOC

For example, if DOC is source.md and the output FORMAT is HTML, do:

pandoc -f PATH/TO/literate.lua -t html source.md

Learn how to do LNP here.

Clone this repo:

git clone https://git.cuates.net/perro/literate-pandoc.git

Enter the repo:

cd literate-pandoc

Inside, do:

sh scripts/test.sh FORMAT1 FORMAT2

For example, if FORMAT1 is Markdwon and FORMAT2 is HTML, do:

sh tests/test.sh markdown html

For distribution tests, do:

sh scripts/test.sh --dist FORMAT1 FORMAT2

This wouldn't be possible without these projects and their collaborators:

Pandoc: universal document converter and parser; handles the requirements for LNP.
Lua: programming language; enables LNP.
Fennel: Lisp dialect with full Lua compatibility; allows to go from LNP to Lisp or Lua.

Literate Pandoc is under GPLv3.

Happy hacking :)