emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Section of Org manual on images in latex export
@ 2014-06-17 14:35 Christopher Witte
  2014-06-17 15:25 ` Nick Dokos
  2014-06-18 22:20 ` Nicolas Goaziou
  0 siblings, 2 replies; 5+ messages in thread
From: Christopher Witte @ 2014-06-17 14:35 UTC (permalink / raw)
  To: Org Mode

[-- Attachment #1: Type: text/plain, Size: 1178 bytes --]

Hi all,

After quite a bit of mucking around and finally resorting to checking the
source code, I worked out how to wrap an image in a figure environment
without a caption.  The final solution

#+ATTR_LATEX: :float figure

was trivial, but the manual wasn't too helpful on this particular subject.

So others don't have to go through the same troubles I think the manual
could be slightly reworded. In the section "Images in Latex export"
http://orgmode.org/manual/LaTeX-specific-attributes.html#LaTeX-specific-attributes
I think the following sentence:

"You can also ask Org to export an image as a float without specifying
caption by setting the :float attribute."

should be change to:

"You can also ask Org to export an image as a float without specifying a
caption by setting the :float attribute *to figure*."

Also a summary of the the attributes and their valid values, as is done for
Latex tables would be useful.


Cheers,
Chris.

ps. I tried to find out if I could make those changes myself, but after
much clicking and searching, I could only find:
http://orgmode.org/worg/org-contribute.html but that doesn't say anything
about contributing to the documentation.

[-- Attachment #2: Type: text/html, Size: 1571 bytes --]

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

* Re: Section of Org manual on images in latex export
  2014-06-17 14:35 Section of Org manual on images in latex export Christopher Witte
@ 2014-06-17 15:25 ` Nick Dokos
  2014-06-25  9:23   ` Bastien
  2014-06-18 22:20 ` Nicolas Goaziou
  1 sibling, 1 reply; 5+ messages in thread
From: Nick Dokos @ 2014-06-17 15:25 UTC (permalink / raw)
  To: emacs-orgmode

Christopher Witte <chris@witte.net.au> writes:

> ps. I tried to find out if I could make those changes myself, but
> after much clicking and searching, I could only find:
> http://orgmode.org/worg/org-contribute.html but that doesn't say
> anything about contributing to the documentation.

Even so, it does apply to the documentation as well.

Nick

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

* Re: Section of Org manual on images in latex export
  2014-06-17 14:35 Section of Org manual on images in latex export Christopher Witte
  2014-06-17 15:25 ` Nick Dokos
@ 2014-06-18 22:20 ` Nicolas Goaziou
  2014-06-19  9:23   ` Christopher Witte
  1 sibling, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2014-06-18 22:20 UTC (permalink / raw)
  To: Christopher Witte; +Cc: Org Mode

Hello,

Christopher Witte <chris@witte.net.au> writes:

> After quite a bit of mucking around and finally resorting to checking the
> source code, I worked out how to wrap an image in a figure environment
> without a caption.  The final solution
>
> #+ATTR_LATEX: :float figure

Actually, it is

  #+ATTR_LATEX: :float t

> was trivial, but the manual wasn't too helpful on this particular
> subject.

According to the manual, the first described value for :float is:

     − ‘t’: if you want to use the standard ‘figure’ environment.  It is
       used by default if you provide a caption to the image.

> "You can also ask Org to export an image as a float without specifying
> caption by setting the :float attribute."
>
> should be change to:
>
> "You can also ask Org to export an image as a float without specifying a
> caption by setting the :float attribute *to figure*."

That's not quite true. It can be anything but nil, depending on what you
want (e.g., :float wrap).

> Also a summary of the the attributes and their valid values, as is done for
> Latex tables would be useful.

Patches welcome.


Regards,

-- 
Nicolas Goaziou

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

* Re: Section of Org manual on images in latex export
  2014-06-18 22:20 ` Nicolas Goaziou
@ 2014-06-19  9:23   ` Christopher Witte
  0 siblings, 0 replies; 5+ messages in thread
From: Christopher Witte @ 2014-06-19  9:23 UTC (permalink / raw)
  To: Christopher Witte, Org Mode

[-- Attachment #1: Type: text/plain, Size: 312 bytes --]

On 19 June 2014 00:20, Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:

>
> Actually, it is
>
>   #+ATTR_LATEX: :float t
>
>
hmmm, I'm sure I tried that and it didn't work, but I just tested it again
and now it is working. I'm not sure what I did wrong before.

Thanks for clarifying that for me.

Cheers
Chris.

[-- Attachment #2: Type: text/html, Size: 826 bytes --]

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

* Re: Section of Org manual on images in latex export
  2014-06-17 15:25 ` Nick Dokos
@ 2014-06-25  9:23   ` Bastien
  0 siblings, 0 replies; 5+ messages in thread
From: Bastien @ 2014-06-25  9:23 UTC (permalink / raw)
  To: Nick Dokos; +Cc: emacs-orgmode

Hi Christopher,

Nick Dokos <ndokos@gmail.com> writes:

> Christopher Witte <chris@witte.net.au> writes:
>
>> ps. I tried to find out if I could make those changes myself, but
>> after much clicking and searching, I could only find:
>> http://orgmode.org/worg/org-contribute.html but that doesn't say
>> anything about contributing to the documentation.
>
> Even so, it does apply to the documentation as well.

Yes, exactly.

The basic workflow is pretty simple.

C-x C-f ~/org-from-git/doc/org.texi RET
[hack hack hack]
C-x v =
C-x s enhance-documentation-for-x.patch

then send the patch to the list.

Other workflows (with git-format-patch) are preferred but this is the
simplest one.

Thanks in advance for the patch!

-- 
 Bastien

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

end of thread, other threads:[~2014-06-25  9:24 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-06-17 14:35 Section of Org manual on images in latex export Christopher Witte
2014-06-17 15:25 ` Nick Dokos
2014-06-25  9:23   ` Bastien
2014-06-18 22:20 ` Nicolas Goaziou
2014-06-19  9:23   ` Christopher Witte

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).