Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-24 Thread Eric S Fraga
On Thursday, 23 Oct 2014 at 23:08, Nicolas Goaziou wrote:
 Hello,

 Eric S Fraga e.fr...@ucl.ac.uk writes:

 I don't actually understand you.

 `org-latex-table-caption-above' is now an alias for
 `org-latex-caption-above', so the default values ought to be the same.

Ah, I see.

 IIUC, the old behaviour wasn't consistent (some captions above, some
 below). This is the original motivation for this change.

The old behaviour was not consistent in the sense of captions for
different objects being placed differently but the behaviour was
consistent with what is recognised as best practice in typesetting:
captions below figures and captions above tables.  However, I agree with
the desire for complete control.

 I would be happy to make the transition smoother. However, I don't know
 how to achieve complete backward compatibility, considering the remark
 above.

Okay.  No worries!

thanks,
eric
-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.50.1, Org release_8.3beta-475-g25d50e



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-24 Thread Nicolas Goaziou
Eric S Fraga e.fr...@ucl.ac.uk writes:

 The old behaviour was not consistent in the sense of captions for
 different objects being placed differently but the behaviour was
 consistent with what is recognised as best practice in typesetting:
 captions below figures and captions above tables.  However, I agree with
 the desire for complete control.

If this is really considered as best practice (would you have
a reference about it?), we really should consider making it the default.
Reading the thread, it seemed to me that it wasn't as universal.

However, `org-latex-table-caption-above' would then be dropped
altogether. I don't mind either.


Regards,



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-24 Thread Rasmus
Nicolas Goaziou m...@nicolasgoaziou.fr writes:

 Eric S Fraga e.fr...@ucl.ac.uk writes:

 The old behaviour was not consistent in the sense of captions for
 different objects being placed differently but the behaviour was
 consistent with what is recognised as best practice in typesetting:
 captions below figures and captions above tables.  However, I agree with
 the desire for complete control.

 If this is really considered as best practice (would you have
 a reference about it?), we really should consider making it the default.
 Reading the thread, it seemed to me that it wasn't as universal.

It's discussed here with some references:

https://tex.stackexchange.com/questions/3243/why-should-a-table-caption-be-placed-above-the-table

I took a quick looks as some different journals for which I have
articles with both tables and figures on my computer.  7 had the
configuration table captions above and figure caption below.  One had
both captions above.  One had mixed figure captions (some years above
some years below).  So for sure table captions should be above.
Probably figure captions should be below.  It makes sense.

—Rasmus
 
-- 
I almost cut my hair, it happened just the other day




Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-24 Thread Eric S Fraga
On Friday, 24 Oct 2014 at 11:28, Nicolas Goaziou wrote:
 Eric S Fraga e.fr...@ucl.ac.uk writes:

 The old behaviour was not consistent in the sense of captions for
 different objects being placed differently but the behaviour was
 consistent with what is recognised as best practice in typesetting:
 captions below figures and captions above tables.  However, I agree with
 the desire for complete control.

 If this is really considered as best practice (would you have
 a reference about it?), we really should consider making it the default.
 Reading the thread, it seemed to me that it wasn't as universal.

Not sure whether any reference will be definitive as there will always
be those that argue when it comes to style.  However, a web search for
typesetting captions for tables and figures gives quite a few results,
the first of which is interesting:

https://www.e-education.psu.edu/styleforstudents/c4_p12.html

which is headed Captions for figures and tables.  I quote:

 The caption for a figure appears below the graphic; for a table,
 above.

The fact that LaTeX encourages the above is also a good sign.

However, I should add that I could be somewhat anglo-centric in this: I
really have no idea what technical writing in other languages might look
like.

-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.50.1, Org release_8.3beta-475-g25d50e



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-24 Thread Nicolas Goaziou
Eric S Fraga e.fr...@ucl.ac.uk writes:

 Not sure whether any reference will be definitive as there will always
 be those that argue when it comes to style.  However, a web search for
 typesetting captions for tables and figures gives quite a few results,
 the first of which is interesting:

 https://www.e-education.psu.edu/styleforstudents/c4_p12.html

 which is headed Captions for figures and tables.  I quote:

  The caption for a figure appears below the graphic; for a table,
  above.

 The fact that LaTeX encourages the above is also a good sign.

 However, I should add that I could be somewhat anglo-centric in this: I
 really have no idea what technical writing in other languages might look
 like.

Thanks for the feedback. Default value is now '(table).


Regards,



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-23 Thread Nicolas Goaziou
Hello,

Eric S Fraga e.fr...@ucl.ac.uk writes:

 I don't actually understand you.

`org-latex-table-caption-above' is now an alias for
`org-latex-caption-above', so the default values ought to be the same.

 All I know is that I had nothing set explicitly anywhere to do with
 captions and, all of a sudden, the behaviour has changed. This seems
 wrong. If I understand things correctly, a new variable has been
 introduced to control behaviour that previously was implicit. By
 introducing this variable, the default (previously implicit but now
 explicit) behaviour has changed.

IIUC, the old behaviour wasn't consistent (some captions above, some
below). This is the original motivation for this change.

I would be happy to make the transition smoother. However, I don't know
how to achieve complete backward compatibility, considering the remark
above.


Regards,

-- 
Nicolas Goaziou



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-22 Thread Eric S Fraga
On Tuesday, 21 Oct 2014 at 18:47, Nicolas Goaziou wrote:
 Hello,

 Eric S Fraga e.fr...@ucl.ac.uk writes:

 However, I think it would make sense to make '(table) (at least) the
 default for captions above to have some form of backward compatibility?
 The change caught me by surprise...

 If we change `org-latex-caption-above', then it will no longer match
 `org-latex-table-caption-above', which will introduce another class of
 backward compatibility problems.

Hi Nicolas,

I don't actually understand you.  All I know is that I had nothing set
explicitly anywhere to do with captions and, all of a sudden, the
behaviour has changed.  This seems wrong.  If I understand things
correctly, a new variable has been introduced to control behaviour that
previously was implicit.  By introducing this variable, the default
(previously implicit but now explicit) behaviour has changed.  

But it's a not a big deal (to me) as I have now set the variable and I'm
back to where I was.  So I'm happy to have things as they are now if
that's deemed to be better overall.

Thanks,
eric
-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.50.1, Org release_8.3beta-475-g25d50e



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-21 Thread Eric S Fraga
On Friday, 17 Oct 2014 at 22:08, Nicolas Goaziou wrote:
 Nicolas Goaziou m...@nicolasgoaziou.fr writes:

 If we want to preserve backward-compatibility, t, nil and a list of
 types (e.g. '(table src-block)) should suffice. No need for an alist.

 Still on my ToDo list but I'm not there yet. Feel free to beat me to it
 if you want.

 Done. Feedback welcome.

Nicolas,

the changes seem to work just fine.  Thanks.

However, I think it would make sense to make '(table) (at least) the
default for captions above to have some form of backward compatibility?
The change caught me by surprise...

-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.50.1, Org release_8.3beta-472-gc27d86



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-21 Thread Nicolas Goaziou
Hello,

Eric S Fraga e.fr...@ucl.ac.uk writes:

 However, I think it would make sense to make '(table) (at least) the
 default for captions above to have some form of backward compatibility?
 The change caught me by surprise...

If we change `org-latex-caption-above', then it will no longer match
`org-latex-table-caption-above', which will introduce another class of
backward compatibility problems.


Regards,

-- 
Nicolas Goaziou



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-17 Thread Nicolas Goaziou
Nicolas Goaziou m...@nicolasgoaziou.fr writes:

 If we want to preserve backward-compatibility, t, nil and a list of
 types (e.g. '(table src-block)) should suffice. No need for an alist.

 Still on my ToDo list but I'm not there yet. Feel free to beat me to it
 if you want.

Done. Feedback welcome.



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-13 Thread Nicolas Goaziou
Hello,

Aaron Ecay aarone...@gmail.com writes:

 There’s at least some notion in the Latex community that captions atop
 tables but below figures is sensible style:
 https://tex.stackexchange.com/questions/3243/why-should-a-table-caption-be-placed-above-the-table.

 In that light, does it make sense to instead implement this setting as an 
 alist
 with separate settings for tables, images, src blocks, etc.?  (Of
 course, there could be separate variables
 org-latex-{table,figure,src-block}-caption-above, but a single alist
 seems simpler)

If we want to preserve backward-compatibility, t, nil and a list of
types (e.g. '(table src-block)) should suffice. No need for an alist.

Still on my ToDo list but I'm not there yet. Feel free to beat me to it
if you want.


Regards,

-- 
Nicolas Goaziou



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-12 Thread Aaron Ecay
Hi Nicolas,

2014ko urriak 5an, Nicolas Goaziou-ek idatzi zuen:
 
 Hello,
 
 James Harkins jamshar...@qq.com writes:
 
 Something like that would do it, I think. I hesitate about breaking
 backward compatibility, but at the same time, I'm hard-pressed to
 imagine why one would want captions to be differently placed in the
 same document.
 
 This wouldn't break compatibility. We would just mark
 `org-latex-table-caption-above' as an obsolete alias for
 `org-latex-caption-above'.
 
 I suppose, if somebody needs to move a caption to the top or bottom
 overriding the default, it could be an attribute, hypothetically:
 
 #+name: blah
 #+caption: blah blah
 #+attr_latex: :captionpos t
 #+begin_figure
 ...
 #+end_figure
 
 t would put it at the top, :captionpos b at the bottom and
 :captionpos nil (or not specified) would use the default from the
 configuration variable.
 
 Reasonable?
 
 I don't think we need to go that far at the moment. Implementing
 `org-latex-caption-above' is a reasonable start.
 
 I add it to my ToDo list.

There’s at least some notion in the Latex community that captions atop
tables but below figures is sensible style:
https://tex.stackexchange.com/questions/3243/why-should-a-table-caption-be-placed-above-the-table.

In that light, does it make sense to instead implement this setting as an alist
with separate settings for tables, images, src blocks, etc.?  (Of
course, there could be separate variables
org-latex-{table,figure,src-block}-caption-above, but a single alist
seems simpler)

Thanks,

-- 
Aaron Ecay



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-05 Thread Nicolas Goaziou
Hello,

James Harkins jamshar...@qq.com writes:

 Something like that would do it, I think. I hesitate about breaking
 backward compatibility, but at the same time, I'm hard-pressed to
 imagine why one would want captions to be differently placed in the
 same document.

This wouldn't break compatibility. We would just mark
`org-latex-table-caption-above' as an obsolete alias for
`org-latex-caption-above'.

 I suppose, if somebody needs to move a caption to the top or bottom
 overriding the default, it could be an attribute, hypothetically:

 #+name: blah
 #+caption: blah blah
 #+attr_latex: :captionpos t
 #+begin_figure
 ...
 #+end_figure

 t would put it at the top, :captionpos b at the bottom and
 :captionpos nil (or not specified) would use the default from the
 configuration variable.

 Reasonable?

I don't think we need to go that far at the moment. Implementing
`org-latex-caption-above' is a reasonable start.

I add it to my ToDo list.


Regards,

-- 
Nicolas Goaziou



Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-03 Thread James Harkins
On Thu, 02 Oct 2014 18:54:20 +0200
Nicolas Goaziou m...@nicolasgoaziou.fr wrote:

 You mean moving `org-latex-table-caption-above' to
 `org-latex-caption-above' and making sure every block complies to the
 variable?

Sorry for the late reply. I wasn't feeling quite well yesterday.

Something like that would do it, I think. I hesitate about breaking
backward compatibility, but at the same time, I'm hard-pressed to
imagine why one would want captions to be differently placed in the
same document.

I suppose, if somebody needs to move a caption to the top or bottom
overriding the default, it could be an attribute, hypothetically:

#+name: blah
#+caption: blah blah
#+attr_latex: :captionpos t
#+begin_figure
...
#+end_figure

t would put it at the top, :captionpos b at the bottom and
:captionpos nil (or not specified) would use the default from the
configuration variable.

Reasonable?
hjh




Re: [O] [ox-latex] How to force ALL captions below their referents?

2014-10-02 Thread Nicolas Goaziou
Hello,

James Harkins jamshar...@qq.com writes:

 It seems somebody recognized a while ago that this was a problem, and
 introduced org-latex-table-caption-above. But this applies only to
 tables, not to figure special blocks, nor to source code blocks, and
 probably some other cases that I can't think of. Well,  I can customize
 org-latex-listings-options to include (captionpos b), but I think
 this is not quite ideal because:

 a/ image captions always go at the bottom;
 b/ table captions can be configured;
 c/ listings captions can be configured in a different variable;
 d/ many types of captions always go at the top, conflicting with a/.

 Is there a plan to deal with this, other than my hacking ox-latex
 locally?

You mean moving `org-latex-table-caption-above' to
`org-latex-caption-above' and making sure every block complies to the
variable?


Regards,

-- 
Nicolas Goaziou