Alright, Eli. You've piqued my interest. I'll have to take a closer look sometime soon.
~Gary On Wednesday, October 17, 2012 10:22:54 AM UTC-4, Eli Barzilay wrote: > > Gary Johnson <gwjohnso <at> uvm.edu> writes: > > > > I see. After taking a closer look, I can see that you could do LP in > > Scribble > > (Yeah, but again -- that's really not its main goal.) > > > > 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 > > Um, it is very intentionally a documentation system that is built on a > proper langugae -- like latex and N other such language, only using a > general langugae instead of the usual half-baked things... (I know > that some people would consider that a disadvantage, and in that case > you should definitely go with some non-language tool like markdown, > (raw) markup, or some WYSIWYG thing.) > > > > 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). > > That's almost never needed -- and when it is, it's generally an > indication that some rendering feature should be added. At the > scribble syntax level, the syntax is very lightweight, so that there's > no issues of bad backquoting. I describe all of that in > http://barzilay.org/misc/scribble-reader.pdf, and it's applicable to > other languages -- not even sexpr-ish ones. My hope is that this can > easily provide a proper language syntax for having lots of text. > Markdown is another approach, but IME it suffers greatly when you get > to unexpected corner cases (eg, non-trivial and non-uniform rules when > you want to write some texts), and in other cases it starts simple and > end up being horribly complicated (as in wikipedia source files, which > started as a simple markdown thing, and now have a ton of conventions > as well as a templating systems that require a wikipedia black belt if > you get close to it.) > > > > I suggested Org-mode on this thread for these reasons: [...] > > That's all valid -- I'm just pointing out that there is a way to have > a real language instead of relying on a generic tool that inevitably > gets complicated when people discover that they want more out of it. > But of course YMMV -- I'm just trying to convey the huge benefits we > got by using such an in-language tool. > > -- > ((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
