Re: [O] issues with export of LaTeX figure captions

2013-05-06 Thread Sebastien Vauban
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




Re: [O] issues with export of LaTeX figure captions

2013-05-06 Thread RJ Cunningham
Thanks for the reply Seb,

Sebastien Vauban sva-n...@mygooglest.com writes:

 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.

I guess it could be dangerous, though it is convenient and I don't
believe it has ever caused me any issues. I note that at one time, at
least, a name was an optional argument for the :session header (see
http://www.jstatsoft.org/v46/i03/paper p 10). I will consider being less
weird though as you suggest.


 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.

Indeed.


  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.

OK, that is not something I have ever needed but I see that it would
make sense in such a situation. Is there any way that I can export
figures with captions WITHOUT having to execute the code and capture the
results in the org file. With the previous construction the caption was
added to the executed code results on export-so reducing the clutter in the
org file by not having the results in the org file.


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

 Can you provide an ECM for this?


The problem seems to relate to :cache

This gobbles up the caption and label. 

#+begin_src R :session :results graphics :file ok.pdf :exports results :cache 
yes
plot(1:10, col=blue,cex=1)
#+end_src

#+CAPTION: Succeeds to produce table environment and so caption 
#+LABEL: fig:OK
#+RESULTS:
[[file:ok.pdf]]


:cache no is fine



Cheers,

Robert



Re: [O] issues with export of LaTeX figure captions

2013-05-06 Thread Sebastien Vauban
Hi RJ,

RJ Cunningham wrote:
 Sebastien Vauban sva-n...@mygooglest.com writes:
 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.

 I guess it could be dangerous, though it is convenient and I don't
 believe it has ever caused me any issues. I note that at one time, at
 least, a name was an optional argument for the :session header (see
 http://www.jstatsoft.org/v46/i03/paper p 10). I will consider being less
 weird though as you suggest.

It never occurred to me that there could be a default name (see
http://orgmode.org/manual/session.html#session), but OK, maybe. Anyway, I told
you that because I once had the problem of the following header arg eaten as
the option given to the previous one, though not with :session.

 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 [...]:
  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.

 OK, that is not something I have ever needed but I see that it would
 make sense in such a situation.

We do agree.

 Is there any way that I can export figures with captions WITHOUT having to
 execute the code and capture the results in the org file.

Once again, some question I never asked myself, always wanting to see at least
as much as what will be exported. But I understand your question, and a
possible good reason therefore (when the results is huge).

 With the previous construction the caption was added to the executed code
 results on export-so reducing the clutter in the org file by not having the
 results in the org file.

Honestly, I don't know. I would have the impression that you can't, but I may
be totally mislead...

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

 Can you provide an ECM for this?

 The problem seems to relate to :cache

 This gobbles up the caption and label.

If you did not execute the code block previously. Once pre-evaluated, your bug
does not appear anymore -- that does not mean it's not a problem, though.

 #+begin_src R :session :results graphics :file ok.pdf :exports results :cache 
 yes
 plot(1:10, col=blue,cex=1)
 #+end_src
 #+CAPTION: Succeeds to produce table environment and so caption 
 #+LABEL: fig:OK
 #+RESULTS:
 [[file:ok.pdf]]

 :cache no is fine

I don't have time right now to further try to understand and help you, but it
really is strange. I confirm your saying about with or without cache, but had
other strange behaviors trying to export (only one fig got exported when I had
the two blocks).

I can't commit on when, but I'll also try to better understand what happens
here. Maybe others (Eric, Nicolas, Achim...) will come earlier with hints
about this.

Best regards,
  Seb

-- 
Sebastien Vauban




[O] issues with export of LaTeX figure captions

2013-05-05 Thread RJ Cunningham
G'day fellow orgmode users,

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

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
 2. it is ugly to have the caption sandwiched between the code and the
 results
 3. often, but not always, when the code is re-executed the caption and
 label is lost

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


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.


Cheers,

Robert Cunningham