3 projects tagged "Literate Programming"
Updated 30 Sep 2009
pipadoc
| Pop | 22.36 |
|---|---|
| Vit | 36.70 |
Pipadoc extracts extracts special comments out of source files or plaintext files and let one define rules how to bring them into proper order. This is somewhat similar to Literate Programming, but it puts the emphasis back to the code, since the source is not extracted from a given "literate text", but the documentation is extracted from the source and then the structure of the generated documentation is defined by the programmer. Pipadoc is programming language and documentation system agnostic, all it requires is that the programming language has some kind of line or block comments in one can place doc statements. It provides a plugin system where one can extend functionality. Some plugins for asciidoc, index generation, and verbatim code sections are provided.
Updated 06 Oct 2009
eWEB
| Pop | 19.05 |
|---|---|
| Vit | 36.33 |
eWEB allows you to create literate programs written as AsciiDoc documents, using embedded WEB code snippets. A self hosting implementation of Etangle, the tangling tool, has been developed.
Updated 01 Feb 2010
newfangle
| Pop | 27.82 |
|---|---|
| Vit | 34.69 |
Newfangle is a literate programming technique for LyX (or LaTeX) inspired by notangle. It comes in two parts. The weave part that produces the formatted document is implemented entirely in LaTeX, and the tangle that generates the source code is implemented in awk for portability. Naturally, newfangle is written using literate programming techniques, using itself, and so the source is also the documentation. The source is written using the LyX document editor, an excellent front end to LaTeX. LyX is not required, but newfangle provides formatting support for LyX. Literate programming makes you write good code, because if you can't write a good justification or explanation for your code, it makes you think again and write something that you can explain.
