Re: issues with export of LaTeX figure captions

["Sebastien Vauban" <sva-news-D0wtAvR13HarG/iDocfnWg@public.gmane.org>]

Hi RJ,

RJ Cunningham wrote:
> I've encountered an issue/difference with the way the recent "babel
> processor" handles captions.
>
> In versions prior to 8 the following WORKED (on export produced a figure
> environment with a caption):
>
> #+CAPTION: Fails to produce table environment and so caption in the new orgmode
> #+LABEL: fig:fails
> #+begin_src R :session :results graphics :file fails.pdf :exports results
> plot(1:10)
> #+end_src

Side-remark: I find it weird, if not uncorrect, to have the header argument
":session" empty. IIRC, this is, at best, dangerous, because it could
interpret what follows as its value.

> Under orgmode version 8.0.2 (8.0.2-2-g93da18-elpa the same code does
> not work, the includegraphics is exported sans the figure environment.
>
> Under this latest orgmode the following does work:
>
> #+begin_src R :session :results graphics :file ok.pdf :exports results
> plot(1:10)
> #+end_src
> #+CAPTION: Succeeds to produce table environment and so caption
> #+LABEL: fig:OK
> #+RESULTS[2d39a23f088d95e808bb867f97a0ecd2df621bbd]:
> [[file:ok.pdf]]
>
> However, this second construction of code has the following issues:
>  1. it is different to prior method which worked

Yes, a lot of changes have been made in Org 8. This is for good, even if the
switch can be somewhat painful.

>  2. it is ugly to have the caption sandwiched between the code and the
>  results

Not really. Please well think that there are two different beasts here: the
code block and the results block. You can export both, and you could attach
(different) captions to both. So, that does not seems that illogical to me.

>  3. often, but not always, when the code is re-executed the caption and
>  label is lost

Can you provide an ECM for this?

> I also see that HTML export also fails to produce a caption.

Confirmed, in a 1-min test. Though, I had the impression that captions were
handled in ox-html. To be further checked.

> Is this an issue in orgmode that can be addressed or is it an issue with
> my understanding? I must admit as much as I like org-babel I have long
> found the options for headers and arguments hard to understand well.

Best regards,
  Seb

-- 
Sebastien Vauban