On this page:
figure
figure*
figure**
figure-here
left-figure-style
center-figure-style
right-figure-style
left
figure-ref
Figure-ref
Figure-target
suppress-floats
2.1 Configuring Output
6.10

2 Figures

 (require scriblib/figure) package: scribble-lib

procedure

(figure tag    
  caption    
  p ...    
  [#:style style    
  #:continue? continue?])  block?
  tag : string?
  caption : content?
  p : pre-flow?
  style : style? = center-figure-style
  continue? : any/c = #f

procedure

(figure* tag    
  caption    
  p ...    
  [#:style style    
  #:continue? continue?])  block?
  tag : string?
  caption : content?
  p : pre-flow?
  style : style? = center-figure-style
  continue? : any/c = #f

procedure

(figure** tag    
  caption    
  p ...    
  [#:style style    
  #:continue? continue?])  block?
  tag : string?
  caption : content?
  p : pre-flow?
  style : style? = center-figure-style
  continue? : any/c = #f

procedure

(figure-here tag    
  caption    
  pre-flow ...    
  [#:style style    
  #:continue? continue?])  block?
  tag : string?
  caption : content?
  pre-flow : pre-flow?
  style : style? = center-figure-style
  continue? : any/c = #f
Creates a figure. The given tag is for use with figure-ref or Figure-ref. The caption is an element. The pre-flow is decoded as a flow.

For HTML output, the figure and figure* functions are the same, while figure** allows the content to be wider than the document body. For two-column Latex output, figure* and figure** generate a figure that spans columns.

For Latex output, figure-here generates a figure to be included at the position in the output text where the figure-here occurs in the source text. For HTML output, all figure variants place the figure where the use appears in the source text.

By default, style is set so that the content of the figure is centered. Use left-figure-style, center-figure-style, or right-figure-style to specify the alignment.

If continue? is a true value, then the figure counter is not incremented.

Implements figure alignments.

The left binding is a synonym for left-figure-style, provided for backward compatibility.

procedure

(figure-ref tag ...+)  element?

  tag : string?
Generates a reference to one or more figures, using a lowercase word “figure”.

procedure

(Figure-ref tag ...+)  element?

  tag : string?
Generates a reference to one or more figures, capitalizing the word “Figure”.

procedure

(Figure-target tag [#:continue? continue?])  element?

  tag : string?
  continue? : any/c = #f
Generates a new figure label. This function is normally not used directly, since it is used by figure.

procedure

(suppress-floats)  element?

Produces an empty element that renders in Latex as \suppressfloats, which discourages the placement of figures in the column or page of the surrounding text.

2.1 Configuring Output

Output uses the following style names, which can be adjusted in an overriding ".css" or ".tex" specification: