emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Suggestion: provide more detailed example of :options for LaTeX special blocks
@ 2017-07-03  9:26 Olivier Berger
  2017-07-25  8:06 ` Nicolas Goaziou
  0 siblings, 1 reply; 2+ messages in thread
From: Olivier Berger @ 2017-07-03  9:26 UTC (permalink / raw)
  To: emacs-orgmode

Hi.

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.

Hope this helps.

Thanks in advance.

Best regards,
-- 
Olivier BERGER 
http://www-public.telecom-sudparis.eu/~berger_o/ - OpenPGP-Id: 2048R/5819D7E8
Ingenieur Recherche - Dept INF
Institut Mines-Telecom, Telecom SudParis, Evry (France)

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: Suggestion: provide more detailed example of :options for LaTeX special blocks
  2017-07-03  9:26 Suggestion: provide more detailed example of :options for LaTeX special blocks Olivier Berger
@ 2017-07-25  8:06 ` Nicolas Goaziou
  0 siblings, 0 replies; 2+ messages in thread
From: Nicolas Goaziou @ 2017-07-25  8:06 UTC (permalink / raw)
  To: Olivier Berger; +Cc: emacs-orgmode

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

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2017-07-25  8:06 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-07-03  9:26 Suggestion: provide more detailed example of :options for LaTeX special blocks Olivier Berger
2017-07-25  8:06 ` Nicolas Goaziou

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).