* issues with export of LaTeX figure captions @ 2013-05-06 0:50 RJ Cunningham 2013-05-06 7:18 ` Sebastien Vauban 0 siblings, 1 reply; 4+ messages in thread From: RJ Cunningham @ 2013-05-06 0:50 UTC (permalink / raw) To: emacs-orgmode 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 ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: issues with export of LaTeX figure captions 2013-05-06 0:50 issues with export of LaTeX figure captions RJ Cunningham @ 2013-05-06 7:18 ` Sebastien Vauban 2013-05-06 9:39 ` RJ Cunningham 0 siblings, 1 reply; 4+ messages in thread From: Sebastien Vauban @ 2013-05-06 7:18 UTC (permalink / raw) To: emacs-orgmode-mXXj517/zsQ 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 ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: issues with export of LaTeX figure captions 2013-05-06 7:18 ` Sebastien Vauban @ 2013-05-06 9:39 ` RJ Cunningham 2013-05-06 12:11 ` Sebastien Vauban 0 siblings, 1 reply; 4+ messages in thread From: RJ Cunningham @ 2013-05-06 9:39 UTC (permalink / raw) To: Sebastien Vauban; +Cc: emacs-orgmode Thanks for the reply Seb, "Sebastien Vauban" <sva-news@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 XXXX #+LABEL: fig:OK #+RESULTS: [[file:ok.pdf]] :cache no is fine Cheers, Robert ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: issues with export of LaTeX figure captions 2013-05-06 9:39 ` RJ Cunningham @ 2013-05-06 12:11 ` Sebastien Vauban 0 siblings, 0 replies; 4+ messages in thread From: Sebastien Vauban @ 2013-05-06 12:11 UTC (permalink / raw) To: emacs-orgmode-mXXj517/zsQ Hi RJ, RJ Cunningham wrote: > "Sebastien Vauban" <sva-news-D0wtAvR13HarG/iDocfnWg@public.gmane.org> 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 XXXX > #+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 ^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2013-05-06 12:11 UTC | newest] Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2013-05-06 0:50 issues with export of LaTeX figure captions RJ Cunningham 2013-05-06 7:18 ` Sebastien Vauban 2013-05-06 9:39 ` RJ Cunningham 2013-05-06 12:11 ` Sebastien Vauban
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs/org-mode.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).