suzanne.soy/hyper-literate
1
0
Fork 0
Code Issues 4 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Hyper-literate programming is to literate programming exactly what hypertext documents are to regular books and texts.
1,845 Commits 27 Branches 6 Tags 10 MiB
Racket 100%
0bbbb12b5a
Go to file
Georges Dupéron 0bbbb12b5a Removed my-reader.rkt, it shouldn't be needed if I manage to fix http://stackoverflow.com/questions/37867859/module-meta-language-in-racket
2016-06-17 16:25:53 +02:00
scribblings Initial commit 2016-06-16 14:21:44 +02:00
test Added a test that requires the 'doc submodule. Normally this is done while building the document with scribble anyway. 2016-06-17 16:21:55 +02:00
typed Removed my-reader.rkt, it shouldn't be needed if I manage to fix http://stackoverflow.com/questions/37867859/module-meta-language-in-racket 2016-06-17 16:25:53 +02:00
.gitignore Initial commit 2016-06-16 14:21:44 +02:00
.travis.yml Cleanup 2016-06-17 16:19:18 +02:00
info.rkt Cleanup 2016-06-17 16:19:18 +02:00
LICENSE.txt Initial commit 2016-06-16 14:21:44 +02:00
main.rkt Added a couple of utilities: defck and repeat-chunk 2016-06-16 14:24:17 +02:00
README.md Improved README 2016-06-16 16:28:33 +02:00

README.md

hyper-literate

Some tools which help build hyper-literate programs.

Hyper-literate programming is to literate programming exactly what hypertext documents are to regular books and texts. Literate programming is about telling other programmers how the program works (instead of just telling the compiler what it does). Telling this story can be done using non-linear, hyperlinked documents.

For now these utilities only help with manipulating LP chunks (e.g. repating the same chunk in several places in the output document, but keep a single copy in the source code).

Ultimately, the reading experience should be closer to viewing an interactive presentation, focussing on the parts of the program that are of interest to you: expand on-screen the chunks you are curious about, run some tests and see their result, etc.

  • Imagine something like code bubbles, but with explanative text comming along with the source code.

  • Imagine something like Inform, but focussed on exploring a program instead of exploring an imaginary world — after all, a program is some kind of imaginary world.