From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Suggestion: provide more detailed example of :options for LaTeX
 special blocks
Date: Tue, 25 Jul 2017 10:06:12 +0200
Message-ID: <87d18p7xfv.fsf@nicolasgoaziou.fr>
References: <87d19hooqj.fsf@inf-11879.int-evry.fr>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48072)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dZurD-0004b5-TJ
	for emacs-orgmode@gnu.org; Tue, 25 Jul 2017 04:06:20 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1dZur9-0007Nj-Gi
	for emacs-orgmode@gnu.org; Tue, 25 Jul 2017 04:06:19 -0400
Received: from relay2-d.mail.gandi.net ([217.70.183.194]:55049)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1dZur9-0007NB-9s
	for emacs-orgmode@gnu.org; Tue, 25 Jul 2017 04:06:15 -0400
In-Reply-To: <87d19hooqj.fsf@inf-11879.int-evry.fr> (Olivier Berger's message
	of "Mon, 03 Jul 2017 11:26:28 +0200")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Olivier Berger <olivier.berger@telecom-sudparis.eu>
Cc: emacs-orgmode@gnu.org

Hello,

Olivier Berger <olivier.berger@telecom-sudparis.eu> writes:

> May I suggest to improve the docs of
> [[http://orgmode.org/manual/Special-blocks-in-LaTeX-export.html][Special
> blocks in LaTeX export]] to make it more explicit that the special
> blocks :options can contain both options or arguments of the LaTeX environment.
>
> Here's an example:
>
> #+ATTR_LATEX: :options [logo=\bcattention]{The warning}
>
> #+BEGIN_bclogo
> Attention, this is a warning
> #+END_bclogo
>
> This requires or course:
> #+LaTeX_HEADER: \usepackage[tikz]{bclogo}
>
>
> I've been struggling with trying to do this, until I read the sources of
> ox-latex and noticed that it wasn't limited to the '[...]'
> options... and much later re-read the manual to finally notice the
> "appends as-is to that environment's opening string" ;-)
>
> Maybe providing an example that uses both the '[...]' and the '{...}'
> would save others' time.
>
> Unfortunately, I'm not fluent enough in LaTeX to suggest a more
> "generic" environment than bclogo, readily available in an article, for a
> direct patch proposal to the manual sources.

I think minipage environment fits the bill. Would the following example,
used to put two pictures side by side, clear enough?

  #+ATTR_LATEX: :options [t]{.5\textwidth}
  #+BEGIN_minipage
  [[file:left-image.pdf]]
  #+END_minipage
  #+ATTR_LATEX: :options [t]{.5\textwidth}
  #+BEGIN_minipage
  [[file:right-image.pdf]]
  #+END_minipage
  
Regards,

-- 
Nicolas Goaziou