Literate Programming: Articles

• haskell-dbus

  1 2 10.0 Haskell

  Discontinued This repository is no longer actively maintained. Please use Andrey Sverdlichenko's fork instead:

I wrote a literate programming preprocessor in Haskell[0], and used it to weave/tangle a D-Bus implementation (also in Haskell). The woven PDF[1] weighs in around 90 pages.

I'll quote from the linked page regarding my conclusions:

------------>8----------

But in the end, I was never able to realize the promised benefits of Literate Programming. The typeset PDF was not easier to read than hypertext documentation generated by Haddock, and both were obviously worse than the very nice docs being created by the Python community with Sphinx.

So in mid 2012 (~3 years after starting the project) I removed all the literate annotations and styles, dropped the fancy build scripts, and released haskell-dbus 0.10 as standard Haskell.

------------>8----------

[0] https://john-millikin.com/software/anansi#history

[1] https://github.com/jmillikin/haskell-dbus/releases/download/...

• lit

  2 116 1.4 Shell

  a little preprocessor for literate programming (by vijithassar)

There are tools to do exactly that, like a simple bash scripts lit.sh: https://github.com/vijithassar/lit

I've heard it referred to as 'semi-literate programming' because it skips the reorganization functionality and just gives you nice prose to code conversion.

• InfluxDB

  www.influxdata.com featured

  Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

  

• lmt

  3 137 0.0 Go

  literate markdown tangle

One more tool to accomplish this is lmt [0] which, despite minimal documentation, is quite pleasing to use.

[0] https://github.com/driusan/lmt

Suggest a related project