From mboxrd@z Thu Jan 1 00:00:00 1970 From: Erik Iverson Subject: Re: [babel] Including TikZ diagrams as figures in export Date: Sun, 20 Feb 2011 19:56:18 -0600 Message-ID: <4D61C642.8060205@ccbr.umn.edu> References: <18FA37FD52964B6B892AAD0C99965D83@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Return-path: Received: from [140.186.70.92] (port=33344 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PrL0v-0000TD-Bd for emacs-orgmode@gnu.org; Sun, 20 Feb 2011 20:56:38 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PrL0u-0001OW-6R for emacs-orgmode@gnu.org; Sun, 20 Feb 2011 20:56:37 -0500 Received: from pegasus.biostat.wisc.edu ([144.92.73.35]:39623) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PrL0t-0001Nh-Vx for emacs-orgmode@gnu.org; Sun, 20 Feb 2011 20:56:36 -0500 In-Reply-To: <18FA37FD52964B6B892AAD0C99965D83@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Jeffrey Horn Cc: Org-mode ml Jeffrey, > Now, I'd like to integrate them into an org document. I'd like: > 1) To use babel to handle the TikZ source This is possible. > 2) To wrap the resulting drawing in a figure environment for automatic numbering and centering See http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-LaTeX.html and search for "tikz" for an example. I think you do need to use the :file argument for this to have org-mode take care of it automatically. Alternatively, you could just include *all* the latex you want, including constructing your own figure environment and caption and refs, in the latex code block. > 3) To be able to refer to the figure elsewhere in the document Should be possible with either approach above. > 4) (optional) To be able to seamlessly export to both LaTeX and HTML So should the HTML exporter generate a PNG file then, as opposed to PDF? This is possible, but requires some 'conditional' elisp code in your :file source block argument. I think I can help if that's indeed what you want. > And somewhat unrelated, is ":results" now deprecated in favor of ":exports"? What about ":file"? I'm sufficiently new to babel that these all seem like they could be taken care of with a single header argument with many options... Not deprecated at all according to my understanding: :results determines how the results are collected from a process. So, in R, we might want the standard output ':results output' or we might just want the last value returned by the code block, ':results value'. This determines what is inserted into the org-mode buffer or the export stream when the code block is evaluated. :exports determines if the code and/or the results will be inserted upon exporting. *If* the results are inserted, then :results will determine how. :file is useful for code blocks that generate graphical output, such as tikz. This will divert the output into the named file, and exporting will insert that file. In the org-mode buffer, a link will be inserted. If a png file is generated, it can even be displayed inline in the org-mode buffer if you turn on that functionality.