gardener, Interface administrators, Administrators
1,539
edits
Changes
Jump to navigation
Jump to search
m
< [[Visuals]] | [[Graphics]] | [[Using Graphics]] >= Introduction =
Floats are elements like tables or figures that Floating Objects (floats) are placed (and numbered) automatically by TeX, with a configurable (and optional) caption. They are so called as they can ''placed at an appropriate position determined by the TeX float'' around the output pages to placement algorithm. The algorithm has a place where TeX thinks they are appropriate (You number of options that can influence what TeX thinks as appropriate)float placement.
Floats Most options in the manual (such as {{cmd|placeexternalfigure}}) are ConTeXt's "base class" for everything that uses a <tt>\placedescribed using the generic {{cmd|placefloat}}...</tt> command (tableAdditionally, figure, own floats){{cmd|placelistoffigures}} creates a list of the figures used in the document.
If you search options of e.g. <cmd>placeexternalfigure</cmd> you must look after <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.
== Examples ==I will explain the examples in terms of <{{cmd>|placefigure</cmd> }} but the same set of options are also valid for other floats.
<texcode>
\placefigure {none} {\externalfigure[figurename]}
</texcode>
or
==Floats and columns==
Prefer MkIV code
<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'''
If you don't need to refer to your float, you can leave this parameter out.
* 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.
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==
If you have a double-sided document with wide outer margins then you might want your figures to protrude into the margin. In a double-sided document you need to tell ConTeXt to decide whether to make the figure protrude to the left or the right. This can be done as follows:
\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}} or {{cmd|setuphead}} commands.
= Captions =
To change the style of figure(table) captions, use {{cmd|setupcaptions}}.
To use a different (e.g. abbreviated) caption in the list of floats, you can do:
<texcode>
\startplacefigure[title={A rather long caption},list={A short caption}]
This is the content of the actual figure
\stopplacefigure
</texcode>
In MkII this was possible by:
<texcode>
\defineselector[caption][max=2,n=2]
\starttext
\setupselector[caption][n=1]
\completelistoffigures
\setupselector[caption][n=2]
\placefigure[][]
{\select{caption}
{Short caption for list}
{A rather longer caption which will appear below the figure itself}}
{This is the content of the actual figure}
\stoptext
</texcode>
= Flushing floats =
The command {{cmd|placefloats}} outputs all pending floats.
[[Category:Basics]]
[[Category:Layout]]
