portia
ntangle.vim
Our great sponsors
| portia | ntangle.vim | |
|---|---|---|
| 1 | 1 | |
| 4 | 21 | |
| - | - | |
| 0.0 | 2.7 | |
| over 2 years ago | over 3 years ago | |
| OCaml | Vim Script | |
| - | - |
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.
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
ntangle.vim
-
Noweb – A Simple, Extensible Tool for Literate Programming
Here are a couple more projects that may or may not seem like Literate Programming, but are motivated squarely by its ethos: to order code for exposition, independent of what the compiler wants.
* https://github.com/snaptoken, the engine behind https://viewsourcecode.org/snaptoken/kilo. The key new feature here seems to be that fragments are always shown in context that can be dynamically expanded by the reader.
* https://github.com/jbyuki/ntangle.vim -- a literate system that tangles your code behind the scenes every time you :wq in Vim or Neovim.
* My system of layers deemphasizes typesetting and is designed to work within a programmer's editor (though IDEs will find it confusing): http://akkartik.name/post/wart-layers. I don't have a single repo for it, mostly[1] because it's tiny enough to get bundled with each of my projects. Perhaps the most developed place to check out is the layered organization for a text editor I built in a statement-oriented language with built-in support for layers: https://github.com/akkartik/mu1/tree/master/edit#readme. It's also in my most recent project, though it's only used in a tiny bootstrapping shim before I wormhole solipsistically into my own universe: https://github.com/akkartik/mu/blob/main/tools/tangle.readme.... Maybe one day I'll have layers in this universe.
[1] And also because I think example repos are under-explored compared to constant attempts at reusable components: http://akkartik.name/post/four-repos
What are some alternatives?
clojure-small-pieces - Clojure in Small Pieces -- Literate Clojure - Created by Tim Daly
Literate - A literate programming tool for any language
dotfiles - Yet another dotfile-repository
spiralweb - Literate programming system with a Pandoc-extended Markdown backend.
knot - A literate programming tool that uses Markdown.
fw-utf8 - Modern fork of FunnelWeb (original written by Ross Williams)