Difference between revisions of "Command/placefloat"

From Wiki
Jump to navigation Jump to search
(Improve description and example. Create table to fill in location key descriptions)
m ('none' should be a key, not the reference; add 'none' key to table)
Line 34: Line 34:
 
! Keyword
 
! Keyword
 
! Meaning
 
! Meaning
 +
|-
 +
| none
 +
| Suppress the caption, including the "Figure 1" label.
 
|-
 
|-
 
| left
 
| left
| left of text
+
| Left of text
 
|-
 
|-
 
| right
 
| right
| to the right of the text
+
| To the right of the text
 
|-
 
|-
 
| here
 
| here
| preferably here
+
| Preferably here
 
|-
 
|-
 
| force
 
| force
| force placement here
+
| Force placement here
 
|-
 
|-
 
| top
 
| top
| at the top of the page
+
| At the top of the page
 
|-
 
|-
 
| bottom
 
| bottom
| at the bottom of the page
+
| At the bottom of the page
 
|-
 
|-
 
| inleft
 
| inleft
| in the left margin
+
| In the left margin
 
|-
 
|-
 
| inright
 
| inright
| in the right margin  
+
| In the right margin  
 
|-
 
|-
 
| inmargin
 
| inmargin
| in the margin (left or right)
+
| In the margin (left or right)
 
|-
 
|-
 
| margin
 
| margin
| in the margin (margin float)
+
| In the margin (margin float)
 
|-
 
|-
 
| leftmargin
 
| leftmargin
Line 153: Line 156:
 
     \placefigure{none}{\externalfigure[cow][height=1cm]}
 
     \placefigure{none}{\externalfigure[cow][height=1cm]}
 
\column
 
\column
     reference=none
+
     key=none
 
     \placefigure[none]{}{\externalfigure[cow][height=1cm]}
 
     \placefigure[none]{}{\externalfigure[cow][height=1cm]}
 
\column
 
\column

Revision as of 13:22, 31 May 2012

\placefloat

Syntax

\placefloat[...][ref,ref,...]{...}{...}
[...] left right here top bottom inleft inright inmargin margin leftmargin rightmargin leftedge rightedge innermargin outermargin inneredge outeredge inner outer line high low fit page leftpage rightpage opposite always auto force tall reset line height depth
[ref,ref,...] references
{...} caption
{...} float contents

Description

With \placefloat[location][ref]{caption}{contents} you can declare that you want to take certain contents, and place them on the page as a (numbered) figure, table, graphic, or intermezzo, or as some other object type that you defined using \definefloat. ref is an optional reference label; location is an optional positioning key. There are a great many positioning keys defined; the following table describes them.

Keyword Meaning
none Suppress the caption, including the "Figure 1" label.
left Left of text
right To the right of the text
here Preferably here
force Force placement here
top At the top of the page
bottom At the bottom of the page
inleft In the left margin
inright In the right margin
inmargin In the margin (left or right)
margin In the margin (margin float)
leftmargin
rightmargin
leftedge
rightedge
innermargin
outermargin
inneredge
outeredge
inner
outer
line
high
low
fit
page on a new (empty) page
leftpage
rightpage
opposite on the left page (is this correct?)
always precedence over stored floats
auto
tall
reset
line
height
depth

Example

% Tell ConTeXt where the cow picture is stored
\setupexternalfigures[location={local,default}]

\startcolumns[n=3]
    caption=none
    \placefigure{none}{\externalfigure[cow][height=1cm]}
\column
    key=none
    \placefigure[none]{}{\externalfigure[cow][height=1cm]}
\column
    empty caption
    \placefigure{}{\externalfigure[cow][height=1cm]}
\stopcolumns

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: