A lot of scribble's features are geared towards providing tooling for Literate Programming, and currently I'm way more than satisfied with org-babel. This has been built into Emacs by defaut since IIRC version 23.2 or so. Opening any file in org-mode (`M-x org-mode') immediately provides you with a full LP experience. You can "weave" your org file to a number of different output formats (HTML, PDF, and ODT being my favorites using `M-x org-export-as-*') with beautiful tables, figures, embedded images, properly formatted math (LaTeX!), and language-specific fontified code blocks. You can "tangle" your org file (i.e., automatically extract code blocks and rearrange them in a new source code only file(s)) to create an entire src/ directory with one command (`M-x org-babel-tangle'). And possible the coolest feature of all is that you can live evaluate any code block (by sending it to a Clojure REPL using nrepl or swank-clojure) by simply typing `C-c C-c' in any code block within the org file. This allows for the typical "write, test, modify, test" loop that Clojure programmers are used to. Just for the final coup de grace, you can use any number of different programming languages within the same org file and either tangle them out to their own files (.sh, .clj, .java, etc) for building up an entire system within org-mode, or you can live evaluate those blocks and have them automatically pass their results between blocks of different languages. So you could write some Clojure code to calculate the values in a tree in-memory, send that on to some python code that creates the graphviz code representation of the tree as a string, and have that chained right along to a dot code block that invokes graphviz to create the PDF image of your tree, which is then embedded dynamically into your org file when you weave it.
I made a simple example program to illustrate the basics of using org-babel as a github project that you can find here: http://github.com/lambdatronic/org-babel-example The actual org-babel site can be found here: http://orgmode.org/worg/org-contrib/babel/index.html Get Literate. ~Gary On Wednesday, October 10, 2012 1:40:11 PM UTC-4, John Gabriele wrote: > > On Wednesday, October 10, 2012 11:32:22 AM UTC-4, Grant Rettke wrote: >> >> On Tue, Oct 9, 2012 at 1:00 PM, Michael Fogus <mef...@gmail.com> wrote: >> >> Any existing solutions or interest in something like this? >> > >> > There are no _public_ solutions as far as I know, >> >> So everyone has their private custom approaches I guess? I'm curious >> if people would share them. >> >> > My guess is that most folks are just using Markdown: > > * most readme's for Clojure projects on github are markdown, > * high-profile projects like Lein keep their docs in markdown, > * fwict, Marginalia turns markdown-formatted comments and docstrings > into html, > * there appears that autodoc may at some point [^1] support markdown in > docstring comments, and > * most folks already know and use it (sometimes without knowing it :) ). > > [^1]: see http://tomfaulhaber.github.com/autodoc/ "Things not > implemented" section > > ---John > > -- 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
