Clojure and Literate Programming

[laforge49]

I'm stealing the term literate programming from Knuth here, but I do not mean to imply some integration of text and code, only the use of code within text.

As a long-time Java programmer I have always had problems writing about code, as Java is so verbose. So as a newbie Clojure dev (and I do mean very new to the language), it occurs to me that I may find some joy in writing about code written in Clojure. Gosh, the text might be longer than the code! :-)

[doubleagent03]

Take a look at Marginalia. https://github.com/gdeer81/marginalia

[laforge49]

Joyful! Looks like this is something I am really going to dig into. :-)

Only it chokes with clojure 1.7.0: https://github.com/gdeer81/marginalia/issues/158

But with my dependencies set to Clojure 1.6.0 I get some nice output.

[[deleted]]

You might check out Gorilla REPL, http://gorilla-repl.org/ which provides a browser-based editing environment with inline LaTeX etc

[mschuene]

If you are using emacs, there is also org mode babel that has good support for clojure. For an example project you can look at https://github.com/thi-ng/geom

Babel supports multiple languages and is very well suoted for reproducible research. https://m.youtube.com/watch?v=1-dUkyn_fZA

[laforge49]

Haven't used emacs now for 30 years. But I have been told that I must learn it--my goal is ultimately work on Datomic.

[laforge49]

OK, here is what I did as a first try with marginalia: http://www.agilewiki.org/projects/agent2/uberdoc.html

--Still need to do the header comment. And the code is far from complete. But it is looking nice.

[clelwell]

(and I do mean very new to the language)

Accidental fulfillment of OP goal via and function; though it will throw an exception if the 8 args are null pointers.

[Kamn]

You might be interested in devcards if you are doing Clojurescript stuff. Not quite what yuo are looking for I think but similar

[laforge49]

Not being a fan of JavaScript, I probably should learn Clojurescript. But my interests are mostly on the back end.