Hello Tom,
On Fri, 27 May 2011 07:37:50 -1000
t...@tsdye.com (Thomas S. Dye) wrote:
> Aloha Suvayu,
>
> I think #+ATTR_LaTeX: needs more documentation. I worked very hard to
> read between the lines of the Org-mode manual to arrive at your simple
> solution but didn't manage to come close!
>
> Are you able to summarize the possibilities of #+ATTR_LaTeX? I'm
> thinking that a general description somewhere in the Org-mode manual
> might be useful. It would probably also be good to augment the
> existing descriptions of its use in the manual, as well. Perhaps it
> would be possible to propose a patch to the documentation?
>
I am not very familiar with org-latex internals. Based on my limited
understanding I wrote the attached patch to the org manual. I hope it
is up to par.
> All the best,
> Tom
Thanks a lot for your encouragement. :)
--
Suvayu
Open source is the future. It sets us free.
>From 431d7e275a0b374c7b1e8135fe7e5c7d72f46a75 Mon Sep 17 00:00:00 2001
From: Suvayu Ali <fatkasuvayu+li...@gmail.com>
Date: Fri, 27 May 2011 11:18:35 -0700
Subject: [PATCH] Documentation on placement options in LaTeX export.
* Placement options can be passed to floating environments
like 'figure' or 'table' with the '#+ATTR_LaTeX:' line
during LaTeX export. Added an example to demonstrate that.
---
doc/org.texi | 17 +++++++++++++++--
1 files changed, 15 insertions(+), 2 deletions(-)
diff --git a/doc/org.texi b/doc/org.texi
index aa34cd3..5fa1e22 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -10160,7 +10160,7 @@ All lines between these markers are exported literally
@subsection Tables in @LaTeX{} export
@cindex tables, in @LaTeX{} export
-For @LaTeX{} export of a table, you can specify a label and a caption
+For @LaTeX{} export of a table, you can specify a label, a caption and
placement options
(@pxref{Images and tables}). You can also use the @code{ATTR_LaTeX} line to
request a @code{longtable} environment for the table, so that it may span
several pages, or to change the default table environment from @code{table}
@@ -10207,7 +10207,20 @@ element. You can use an @code{#+ATTR_LaTeX:} line to
specify the various
options that can be used in the optional argument of the
@code{\includegraphics} macro. To modify the placement option of the
@code{figure} environment, add something like @samp{placement=[h!]} to the
-Attributes.
+Attributes. It is to be noted this option can be used with tables as well.
+The options are passed as the placement option to floating environments like
+@code{figure} or @code{table}. One can pass other compatible options as well.
+For example the @code{#+ATTR_LaTeX:} line below is exported as the
+@code{figure} environment below it.
+
+@cindex #+ATTR_LaTeX
+@example
+#+ATTR_LaTeX: placement=[<options>]\footnotesize
+
+\begin{figure}[<options>]\footnotesize
+...
+\end{figure}
+@end example
If you would like to let text flow around the image, add the word @samp{wrap}
to the @code{#+ATTR_LaTeX:} line, which will make the figure occupy the left
--
1.7.5.1
