I see. After taking a closer look, I can see that you could do LP in Scribble as well as also outputting some different kinds of documentation formats, such as Javadocs or standalone documents. The downside I'm seeing is that this all has to be programmed in Scheme and that you may have to do some IMO less than attractive backquoting to get at the underlying LaTeX if you want PDF outputs which use some of the existing LaTeX packages (math libs come to mind).
I suggested Org-mode on this thread for these reasons: 1. Many Clojure users are also Emacs users. 2. Org-mode is built into Emacs and requires no additional install. 3. Org-mode is not tied to any one language and already has a module for Clojure LP development. 4. It can output to ASCII, HTML, LaTeX, PDF, DocBook, OpenDocument Text, TaskJuggler, Freemind, and XOXO formats. 5. Tangling and in-file live evaluation are very neat features. 6. It can produce both standalone reports and websites depending on the chosen export module. 7. Inline LaTeX is directly supported without any special backquoting and exports correctly to both HTML and PDF outputs. Scribble definitely looks like a powerful language for programmatically generating documentation, and if someone wants to take on a Clojure port, I can see why that might be a very compelling idea. I just wanted to drop a pointer to a somewhat lower hanging fruit. Sorry to hijack your thread. ~Gary On Thursday, October 11, 2012 5:49:10 PM UTC-4, Eli Barzilay wrote: > > Gary Johnson <gwjohnso <at> uvm.edu> writes: > > > > A lot of scribble's features are geared towards providing tooling for > > Literate Programming, > > No, this is wrong. The LP that we have is based on Scribble, but it was > done mainly as a demonstration of the benefits you get from having a > real language for writing your documentation. That benefit (using a > real langugae) is the central motivation for Scribble. Note also that > it's very much unlike markdown, where you can't program your > documentation language by design. > > -- > ((lambda (x) (x x)) (lambda (x) (x x))) Eli Barzilay: > http://barzilay.org/ Maze is Life! > > > -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en
