gardener, Interface administrators, Administrators
1,539
edits
Changes
Jump to navigation
Jump to search
Floats are elements like tables or figures that are placed (and numbered) automatically by TeX. They are so called as they can ''float'' around the output pages to a place where TeX thinks they are appropriate (You can influence what TeX thinks as appropriate).== Introduction ==
Floats Floating Objects (floats) are ConTeXt's "base class" for everything that uses a <tt>\placeplaced (and numbered) automatically.They are placed at an appropriate position determined by the TeX float placement algorithm..</tt> command (table, figure, own floats)The algorithm has a number of options that can influence float placement.
If you search Most options of e.g. <in the manual (such as {{cmd>|placeexternalfigure</cmd> you must look after <}}) are described using the generic {{cmd>|placefloat</cmd> in the manual! (same for <tt>\setup}}...</tt> etc.)
The float types Floats include "graphic", "figure", "table" , and "intermezzo" are readily defined. If you need more (i.e. if you need another numbering or table of something), you Additional floats can easily define your own floats with <be defined using {{cmd>|definefloat</cmd>}}.
<{{cmd>|placefigure</cmd> }} and <{{cmd>|placetable</cmd> }} also accept the same set of options, and allow to create floating figures and captions respectively.
<texcode>
\placefigure {none} {\externalfigure[figurename]}
</texcode>
or
example for full page floats without headers
< [[Visuals]] | [[Graphics]] | [[Using Graphics]] | [[Tables_Overview]] >
<texcode>
<tr><td>page</td><td>on a new (empty) page</td></tr>
<tr bgcolor="#DDDDDD"><td>opposite</td><td>on the left page</td></tr>
<tr><td>always90</td><td>precedence over stored floatsorientation (rotation angle), both caption and contents</td></tr><tr bgcolor="#DDDDDD"><td>always</td><td>precedence over stored floats</td></tr><tr><td>force</td><td>per se here</td></tr><trbgcolor="#DDDDDD"><td>split</td><td>(For TABLES only) split tables</td></tr>
</table>
(table copied from the manual)
'''reference'''
== Examples ==
I will explain the examples in terms of <{{cmd>|placefigure</cmd> }} but the same set of options are also valid for other floats.
* If you do not want a caption
<texcode>
</texcode>
* Suppose you want the figure to be placed on the right side of the page, a few lines into the paragraph, and want the rest of the paragraph to warp wrap around the figure
<texcode>
</texcode>
This does not want work correctly at a page boundary. The <tt>line</tt> options option leaves the space above the figures empty, while the <tt>hang</tt> option also wraps texts above the figure.
==Floats and columns==
This special case is discussed [[Columns#Floats_and_other_limitations_of_columns|here]].
==Floats on empty pages==
There’s a way to switch off page headings at full page floats:
<texcode>
\startplacefigure[title=Cow,location={page,high,header}]
\externalfigure[cow.pdf]
\stopplacefigure
</texcode>
==Protruding Floats in Double-Sided Documents==
\stoptext
</texcode>
==Landscape Floats in a Portrait Document==
Wide tables, for example, can be turned and most likely will need to be put on a separate page.
<texcode>
\startplacetable [location={page,90},title=Table caption]
\bTABLE [textwidth=\textheight]
put a wide table here...
\eTABLE
\stopplacetable
</texcode>
Both the table caption and the contents will be rotated, but not the page header and footer which remain "upright". Notice that one must set the TABLE textwidth to {{cmd|textheight}} in order for the table macros to fit properly.
== Floats and section headings ==
By default, section headings don't wrap "around" floating objects. Instead, they will be moved down as far as needed to appear below the float. This behaviour can be controlled using the <tt>aligntitle</tt> option of the <{{cmd>|setupheads</cmd> }} or <{{cmd>|setuphead</cmd> }} commands.
== Captions ==
To change the style of figure(table) captions, use <{{cmd>|setupcaptions</cmd>}}.
To use a different (e.g. abbreviated) caption in the list of floats, you can do:
== Flushing floats ==
The command <{{cmd>|placefloats</cmd> }} outputs all pending floats.
