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
