From mboxrd@z Thu Jan 1 00:00:00 1970 From: Suvayu Ali Subject: [PATCH] Improve Images in LaTeX export documentation Date: Sun, 12 Jun 2011 19:35:50 -0700 Message-ID: <20110612193550.277135c0@kuru.homelinux.net> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="MP_/M+ZbaLx30JjaXa=tGcBJl7N" Return-path: Received: from eggs.gnu.org ([140.186.70.92]:40658) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QVx0T-0007HV-52 for emacs-orgmode@gnu.org; Sun, 12 Jun 2011 22:36:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QVx0R-0004Md-TW for emacs-orgmode@gnu.org; Sun, 12 Jun 2011 22:36:01 -0400 Received: from mail-px0-f179.google.com ([209.85.212.179]:53071) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QVx0R-0004MT-Oh for emacs-orgmode@gnu.org; Sun, 12 Jun 2011 22:35:59 -0400 Received: by pxi2 with SMTP id 2so2405960pxi.38 for ; Sun, 12 Jun 2011 19:35:58 -0700 (PDT) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Org mode mailing list --MP_/M+ZbaLx30JjaXa=tGcBJl7N Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline Hi, As per discussion and comments in this thread, I wrote this patch. -- Suvayu Open source is the future. It sets us free. --MP_/M+ZbaLx30JjaXa=tGcBJl7N Content-Type: text/x-patch Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=0001-Improve-Images-in-LaTeX-export-documentation.patch >From 779294ea8da5bd3ac45a7eaaf966d5617e9a3854 Mon Sep 17 00:00:00 2001 From: Suvayu Ali (ThinkPad) Date: Fri, 10 Jun 2011 14:57:48 -0700 Subject: [PATCH] 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. Hack better suited for Worg. --- doc/org.texi | 34 ++++++++++++++++------------------ 1 files changed, 16 insertions(+), 18 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 92343de..61a17ca 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -10207,24 +10207,18 @@ output file resulting from @LaTeX{} processing. Org will use an @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 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 -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. 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=[]\footnotesize - -\begin@{figure@}[]\footnotesize -... -\end@{figure@} -@end example +element. You can use an @code{#+ATTR_LaTeX:} line to specify various other +options. You can ask org to export an image as a float without specifying +a label or a caption by using the keyword @code{float} in this line. Various +optional arguments to the @code{\includegraphics} macro can also be specified +in this fashion. To modify the placement option of the floating environment, +add something like @samp{placement=[h!]} to the attributes. It is to be noted +this option can be used with tables as well@footnote{One can also take +advantage of this option to pass other, unrelated options into the figure or +table environment. For an example see the section ``Exporting org files'' in +@url{http://orgmode.org/worg/org-hacks.html}}. For example the +@code{#+ATTR_LaTeX:} line below is exported as the @code{figure} environment +below it. 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 @@ -10246,6 +10240,10 @@ for @code{\includegraphics} and @code{wrapfigure}. [[./img/hst.png]] @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 @samp{\ref@{fig:SED-HR4049@}} just like in @LaTeX{}. -- 1.7.4.4 --MP_/M+ZbaLx30JjaXa=tGcBJl7N--