From mboxrd@z Thu Jan 1 00:00:00 1970 From: Vikas Rawal Subject: Best practices for literate programming [was: Latex export of tables] Date: Wed, 17 Apr 2013 03:40:22 +0530 Message-ID: <20130416221022.GA7809@panahar> References: <20130412080600.GA18235@panahar> <20130414232953.GC11696@kuru.dyndns-at-home.com> <20130416115619.GA12405@panahar> <20130416173948.GC7402@kuru.dyndns-at-home.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([208.118.235.92]:56884) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1USE5F-0001yz-7q for emacs-orgmode@gnu.org; Tue, 16 Apr 2013 18:10:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1USE5D-0005l7-Tn for emacs-orgmode@gnu.org; Tue, 16 Apr 2013 18:10:37 -0400 Received: from mail-pa0-f52.google.com ([209.85.220.52]:44658) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1USE5D-0005ky-NW for emacs-orgmode@gnu.org; Tue, 16 Apr 2013 18:10:35 -0400 Received: by mail-pa0-f52.google.com with SMTP id fb10so572823pad.11 for ; Tue, 16 Apr 2013 15:10:34 -0700 (PDT) Content-Disposition: inline In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: "Thomas S. Dye" Cc: emacs-orgmode@gnu.org > > I'm suggesting this because if you continue on this path, i.e. litter > > your Org file with hacks, soon you will end up with an extremely fragile > > and complicated Org project. I have been down that road while writing > > my thesis. I see the point. I think there is a need for documenting different approaches people have used so far to avoid this. I suggest we use this thread to start a discussion. If we get useful content, it should perhaps land up somewhere on worg eventually. > At one point I realised the problem and made the decision to > > split things into two kinds of files: static content (document > > structuring, text, plots, etc), and dynamic content (babel, TikZ blocks > > that generate tables, plots, figures, etc used by the static content > > files). It is still reproducible research, but modular and less hacky > > (hence more stable). Suvayu, This is indeed a very neat approach. Would you kindly elaborate? Would it be too much work for you to get some illustrations from your work? In your scheme of things, how do you finally combine the static and the dynamic content? Any chance that you could release the source of something like a chapter of your thesis for people to see? Or may be create something with dummy content? > I've been down it too many times myself. The habits I've developed > over time have helped, but I think they are less systematic than > what you've devised. Tom, do tell us more about what these habits are. > I'd love to see some notes on your solution as > a brief tutorial or an expanded FAQ on Worg. +1 > I'll be happy to > contribute or help if you find time to do something like this. and +1. Vikas