Changes

Jump to navigation Jump to search
1,244 bytes added ,  20:03, 25 May 2012
Improve description and example. Create table to fill in location key descriptions
<tr valign="top" class="first">
<td class="cmd">[...]</td>
<td>left right <strong>'''here</strong> ''' 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 </td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[ref,ref,...]</td>
<td>''references''</td>
</tr>
<tr valign="top" class="third">
<td class="cmd">{...}</td>
<td><i>text</i> ''caption''</td>
</tr>
<tr valign="top" class="first">
<td class="cmd">{...}</td>
<td><i>text</i> ''float contents''</td>
</tr>
</table>
 
== Description ==
first text = caption (With <code>\place'none'=no caption at all)second text = float contain  == Example ==<texcode>% places two cows next to each other but each one with% its own caption \starttext \placefigure ''[none] {} {\startcombination {\externalfigure[cow''location''][width=4cm''ref'']} {\placefloatcaption[figure]{one''caption''}} {\externalfigure[cow][width=4cm]''contents''} </code> 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 {\placefloatcaption[figure]{twocmd|definefloat}} \stopcombination} \stoptext. <code>''ref''</code> is an optional reference label; <code>''location''</texcodecode>is an optional positioning key. There are a great many positioning keys defined; the following table describes them.
{|
|-style="text-align:left"
! Keyword
! Meaning
|-
| 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 ==
<texcode>
% two different ways to suppress numbering and caption
%
\starttext
\placefigure{none}{\externalfigure[cow]}
\placefigure[none]{}{\externalfigure[cow]}
\stoptext
</texcodecontext source=yes>% Tell ConTeXt where the cow picture is stored\setupexternalfigures[location={local,default}]
\startcolumns[n=3]
caption=none
\placefigure{none}{\externalfigure[cow][height=1cm]}
\column
reference=none
\placefigure[none]{}{\externalfigure[cow][height=1cm]}
\column
empty caption
\placefigure{}{\externalfigure[cow][height=1cm]}
\stopcolumns
</context>
== See also ==
<!-- something like * {{cmd|gotodefinefloat}} -->to define a new kind of float object.* {{cmd|startcombination}} to place multiple figures.
== Help from ConTeXt-Mailinglist/Forum ==

Navigation menu