clojure-small-pieces
portia
clojure-small-pieces | portia | |
---|---|---|
1 | 1 | |
10 | 4 | |
- | - | |
0.0 | 0.0 | |
over 7 years ago | over 2 years ago | |
TeX | OCaml | |
- | - |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
clojure-small-pieces
-
Noweb – A Simple, Extensible Tool for Literate Programming
I've been writing literate programs for years
Here is a video showing a literate form of Clojure:
https://www.youtube.com/watch?v=mDlzE9yy1mk
The literate program creates a new PDF and a working version of Clojure, including running a test suite. If you change the literate code and type 'make' it re-makes the PDF with the new changes and rebuilds/retests Clojure.
and here is the source:
https://github.com/robleyhall/clojure-small-pieces
portia
-
Noweb – A Simple, Extensible Tool for Literate Programming
For the record, I wrote portia[0], based on funnelweb and which accept a (mostly) compatible syntax, in a literate style. Its source/doc can be browsed [1].
I still use it from time to time, especially for small, well defined projects, because I find it useful to have to argue with myself when designing a software. It's not so much about producing a nice documentation or a proper exposition of some idea, than it is about having to formulate all the reasoning, the alternatives, and the choices.
[0]: https://github.com/rixed/portia
What are some alternatives?
Literate - A literate programming tool for any language
ntangle.vim - Literate programming in VIM
spiralweb - Literate programming system with a Pandoc-extended Markdown backend.
dotfiles - Yet another dotfile-repository
fw-utf8 - Modern fork of FunnelWeb (original written by Ross Williams)
knot - A literate programming tool that uses Markdown.