このページは日本語に翻訳済みです。
figure要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
setルールやshowルールでカスタマイズできます。A figure with an optional caption.
Automatically detects its kind to select the correct counting track. For example, figures containing images will be numbered separately from figures containing tables.
Examples
The example below shows a basic figure with an image:
@glacier shows a glacier. Glaciers
are complex systems.
#figure(
image("glacier.jpg", width: 80%),
caption: [A curious figure.],
) <glacier>
You can also insert tables into figures to give them a caption. The figure will detect this and automatically use a separate counter.
#figure(
table(
columns: 4,
[t], [1], [2], [3],
[y], [0.3s], [0.4s], [0.8s],
),
caption: [Timing results],
)
This behaviour can be overridden by explicitly specifying the figure's
kind. All figures of the same kind share a common counter.
Figure behaviour
By default, figures are placed within the flow of content. To make them
float to the top or bottom of the page, you can use the
placement argument.
If your figure is too large and its contents are breakable across pages (e.g. if it contains a large table), then you can make the figure itself breakable across pages as well with this show rule:
#show figure: set block(breakable: true)
See the block documentation for more information about breakable and non-breakable blocks.
Caption customization
You can modify the appearance of the figure's caption with its associated
caption function. In the example below, we emphasize
all captions:
#show figure.caption: emph
#figure(
rect[Hello],
caption: [I am emphasized!],
)
By using a where selector, we can scope such rules to
specific kinds of figures. For example, to position the caption above
tables, but keep it below for all other kinds of figures, we could write the
following show-set rule:
#show figure.where(
kind: table
): set figure.caption(position: top)
#figure(
table(columns: 2)[A][B][C][D],
caption: [I'm up here],
)
引数引数引数は関数への入力値です。関数名の後に括弧で囲んで指定します。
body
The content of the figure. Often, an image.
placement
The figure's placement on the page.
none: The figure stays in-flow exactly where it was specified like other content.auto: The figure pickstoporbottomdepending on which is closer.top: The figure floats to the top of the page.bottom: The figure floats to the bottom of the page.
The gap between the main flow content and the floating figure is
controlled by the clearance argument on the
place function.
デフォルト値: none
例を表示
#set page(height: 200pt)
#show figure: set place(
clearance: 1em,
)
= Introduction
#figure(
placement: bottom,
caption: [A glacier],
image("glacier.jpg", width: 60%),
)
#lorem(60)
scope設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。Relative to which containing scope the figure is placed.
Set this to "parent" to create a full-width figure in a two-column
document.
Has no effect if placement is none.
使用可能な文字列値:
columnPlace into the current column.
parentPlace relative to the parent, letting the content span over all columns.
デフォルト値: "column"
例を表示
#set page(height: 250pt, columns: 2)
= Introduction
#figure(
placement: bottom,
scope: "parent",
caption: [A glacier],
image("glacier.jpg", width: 60%),
)
#lorem(60)
caption
The figure's caption.
デフォルト値: none
kind
The kind of figure this is.
All figures of the same kind share a common counter.
If set to auto, the figure will try to automatically determine its
kind based on the type of its body. Automatically detected kinds are
tables and code. In other cases, the inferred kind is
that of an image.
Setting this to something other than auto will override the
automatic detection. This can be useful if
- you wish to create a custom figure type that is not an image, a table or code,
- you want to force the figure to use a specific counter regardless of its content.
You can set the kind to be an element function or a string. If you set
it to an element function other than table, raw
or image, you will need to manually specify the figure's
supplement.
デフォルト値: auto
例を表示
#figure(
circle(radius: 10pt),
caption: [A curious atom.],
kind: "atom",
supplement: [Atom],
)
If you want to modify a counter to skip a number or reset the counter,
you can access the counter of each kind of figure with a
where selector:
- For tables:
counter(figure.where(kind: table)) - For images:
counter(figure.where(kind: image)) - For a custom kind:
counter(figure.where(kind: kind))
#figure(
table(columns: 2, $n$, $1$),
caption: [The first table.],
)
#counter(
figure.where(kind: table)
).update(41)
#figure(
table(columns: 2, $n$, $42$),
caption: [The 42nd table],
)
#figure(
rect[Image],
caption: [Does not affect images],
)
To conveniently use the correct counter in a show rule, you can access
the counter field. There is an example of this in the documentation
of the figure.caption element's body field.
supplement
The figure's supplement.
If set to auto, the figure will try to automatically determine the
correct supplement based on the kind and the active
text language. If you are using a custom figure type, you
will need to manually specify the supplement.
If a function is specified, it is passed the first descendant of the
specified kind (typically, the figure's body) and should return
content.
デフォルト値: auto
例を表示
#figure(
[The contents of my figure!],
caption: [My custom figure],
supplement: [Bar],
kind: "foo",
)
gap設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。The vertical gap between the body and caption.
デフォルト値: 0.65em
定義定義これらの関数や型には、関連する定義を持たせることができます。定義にアクセスするには、対象の関数や型の名前を指定した後に、ピリオド区切りで定義名を記述します。
caption要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
setルールやshowルールでカスタマイズできます。The caption of a figure. This element can be used in set and show rules to customize the appearance of captions for all figures or figures of a specific kind.
In addition to its position and body, the caption also provides the
figure's kind, supplement, counter, and numbering as fields. These
parts can be used in where selectors and show rules to
build a completely custom caption.
例を表示
#show figure.caption: emph
#figure(
rect[Hello],
caption: [A rectangle],
)
position設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。The caption's position in the figure. Either top or bottom.
デフォルト値: bottom
例を表示
#show figure.where(
kind: table
): set figure.caption(position: top)
#figure(
table(columns: 2)[A][B],
caption: [I'm up here],
)
#figure(
rect[Hi],
caption: [I'm down here],
)
#figure(
table(columns: 2)[A][B],
caption: figure.caption(
position: bottom,
[I'm down here too!]
)
)
separator
デフォルト値: auto
例を表示
#set figure.caption(separator: [ --- ])
#figure(
rect[Hello],
caption: [A rectangle],
)
body
The caption's body.
Can be used alongside kind, supplement, counter, numbering, and
location to completely customize the caption.
例を表示
#show figure.caption: it => [
#underline(it.body) |
#it.supplement
#context it.counter.display(it.numbering)
]
#figure(
rect[Hello],
caption: [A rectangle],
)
