Many Literate Programming (LP) tools are available. The essential ingredient, which varies from tool to tool, is the high-level markup language that separates the explanation from the code.
The source files that we write will contain the following three things:
- Text with markup that constitutes the explanation and the description
- Working Code in Python
- High-level markup to separate the text (with markup) from the code
Because of the flexibility of XML, this can be used as the high-level markup for literate programming. It's not easy to write, however. There are tools that work with a LaTeX-like markup based on the original web (and later CWeb) tools. There are some tools that work with RST as the ...