Changes

Floats are elements like tables or figures that Floating Objects (floats) are placed (and numbered) automatically , with a configurable (and optional) caption. They are placed at an appropriate position determined by the TeXfloat placement algorithm. The algorithm has a number of options that can influence 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 eFloats include "graphic", "figure", "table", and "intermezzo".gAdditional floats can be defined using {{cmd|definefloat}}. <tt>\placeexternalfigure</tt> you must look after <tt>\placefloat</tt> in the manual! (same for <tt>\setup...</tt> etc.)

<pretexcode>\placefloat[place][reference]{caption}{some float}</pretexcode>

'''place''' is one or several (comma separated) of: (PLEASE SOMEONE ADD DESCRIPTIONS!)* <table><tr bgcolor="#AAAAAA"><th>preference</th><th align="left">result</th></tr><tr bgcolor="#DDDDDD"><td>left</td><td>left of text</td></tr>* <tr><td>right</td><td>rightof text</td></tr>* <tr bgcolor="#DDDDDD"><td>here</td><td>preferably here</td></tr>* <tr><td>top</td><td>at top of page</td></tr>* <tr bgcolor="#DDDDDD"><td>bottom</td><td>at bottomof page</td></tr>* <tr><td>inleft</td><td>in left margin</td></tr>* <tr bgcolor="#DDDDDD"><td>inright</td><td>in right margin</td></tr>* <tr><td>inmargin</td><td>in the margin (left or right)</td></tr>* <tr bgcolor="#DDDDDD"><td>margin</td><td>in the margin (marginfloat)</td></tr>* <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>90</td><td>orientation (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>* tall<tr bgcolor="#DDDDDD"><td>split</td><td>(For TABLES only) split tables</td></tr></table>(table copied from the manual)

{{cmd|placefigure}} and {{cmd|placetable}} also accept the same set of options, and allow to create floating figures and captions respectively. '''captionreference'''You get ''no'If you don' t need to refer to your float, you can leave this parameter out. = Examples =I will explain the examples in terms of {{cmd|placefigure}} but the same set of options are also valid for other floats. * If you do not want a caption <texcode>\placefigure[none] {} {\externalfigure[figurename]}</texcode>  * If you do not want the figure to be numbered (but still want the caption) <texcode>\placefigure [nonumber] {caption} {\externalfigure[figurename]}</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 wrap around the figure <texcode>\placefigure [right,2*line] {caption} {\externalfigure[figurename]}</texcode> or  <texcode>\placefigure [right,2*hang] {caption } {\externalfigure[figurename]}</texcode> This does not work correctly at a page boundary. The <tt>line</tt> 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= 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: <texcode>\definefloat[textmarginfigure][textmarginfigures]\setupfloat[textmarginfigure][location=inner]\placetextmarginfigure{\externalfigure[figurename]}</texcode> The following code gives a full example that can be pasted into live ConTeXt: <texcode>\setuppagenumbering [alternative=doublesided]\setuplayout[location=middle,backspace=2pc, width=20pc]\definefloat[textmarginfigure][textmarginfigures]\setupfloat[textmarginfigure][location=inner]\starttext\input knuth\placetextmarginfigure[here]{}{\externalfigure[figurename][width=30pc]}\input knuth\placetextmarginfigure[here]{}{\externalfigure[figurename][width=30pc]}\input knuth\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>nonealigntitle</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]]