Section of Org manual on images in latex export

Section of Org manual on images in latex export

[Christopher Witte]

[-- 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 --]

Re: Section of Org manual on images in latex export

[Nick Dokos]

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

Re: Section of Org manual on images in latex export

[Nicolas Goaziou]

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

Re: Section of Org manual on images in latex export

[Christopher Witte]

[-- 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 --]

Re: Section of Org manual on images in latex export

[Bastien]

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