ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve "Images in LaTeX export" documentation 

* Mention use of keywords like multicolumn and float
* Remove previous mention of hack with placement option
  as per comments on the mailing list. The hack is
  better suited for Worg.
This commit is contained in:
Suvayu Ali 2011-07-04 15:03:06 +02:00 committed by Bastien Guerry
parent 9f056593a5
commit 71d871f96e
1 changed files with 16 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/org.texi
View File

@ -10261,24 +10261,18 @@ output file resulting from @LaTeX{} processing. Org will use an
@code{\includegraphics} macro to insert the image. If you have specified a @code{\includegraphics} macro to insert the image. If you have specified a
caption and/or a label as described in @ref{Images and tables}, the figure caption and/or a label as described in @ref{Images and tables}, the figure
will be wrapped into a @code{figure} environment and thus become a floating will be wrapped into a @code{figure} environment and thus become a floating
element. You can use an @code{#+ATTR_LaTeX:} line to specify the various element. You can use an @code{#+ATTR_LaTeX:} line to specify various other
options that can be used in the optional argument of the options. You can ask org to export an image as a float without specifying
@code{\includegraphics} macro. To modify the placement option of the a label or a caption by using the keyword @code{float} in this line. Various
@code{figure} environment, add something like @samp{placement=[h!]} to the optional arguments to the @code{\includegraphics} macro can also be specified
Attributes. It is to be noted this option can be used with tables as well. in this fashion. To modify the placement option of the floating environment,
The options are passed as the placement option to floating environments like add something like @samp{placement=[h!]} to the attributes. It is to be noted
@code{figure} or @code{table}. One can pass other compatible options as well. this option can be used with tables as well@footnote{One can also take
For example the @code{#+ATTR_LaTeX:} line below is exported as the advantage of this option to pass other, unrelated options into the figure or
@code{figure} environment below it. table environment. For an example see the section ``Exporting org files'' in
@url{http://orgmode.org/worg/org-hacks.html}}. For example the
@cindex #+ATTR_LaTeX @code{#+ATTR_LaTeX:} line below is exported as the @code{figure} environment
@example below it.
#+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} 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 to the @code{#+ATTR_LaTeX:} line, which will make the figure occupy the left
@ -10300,6 +10294,10 @@ for @code{\includegraphics} and @code{wrapfigure}.
[[./img/hst.png]] [[./img/hst.png]]
@end example @end example
If you wish to include an image which spans multiple columns in a page,
you can use the keyword @code{multicolumn} in the @code{#+ATTR_LaTeX}
line. This will export the image wrapped in a @code{figure*} environment.
If you need references to a label created in this way, write If you need references to a label created in this way, write
@samp{\ref@{fig:SED-HR4049@}} just like in @LaTeX{}. @samp{\ref@{fig:SED-HR4049@}} just like in @LaTeX{}.