このページは部分的に翻訳されています。一部原文の内容が含まれています。
figure要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
setルールやshowルールでカスタマイズできます。任意でキャプションを持つ図表。
自動的にその種類を検出し、それぞれに応じて番号付けします。 例えば、画像を含む図表は表を含む図表とは別々に番号が付けられます。
例
以下の例は、画像を含む基本的な図表を示しています。
@glacier shows a glacier. Glaciers
are complex systems.
#figure(
image("glacier.jpg", width: 80%),
caption: [A curious figure.],
) <glacier>
図表に tables を挿入してキャプションを付けることもできます。 図表は表を含むことを検出し、自動的に別のカウンターを使用します。
#figure(
table(
columns: 4,
[t], [1], [2], [3],
[y], [0.3s], [0.4s], [0.8s],
),
caption: [Timing results],
)
この動作は、図表の種類である kind を明示的に指定することで上書き可能です。
同じ種類の図表は全て共通のカウンターを共有します。
図表の動作
デフォルトでは、図表はコンテンツの流れの中に配置されます。
図表をページの上部または下部に配置するには、placement引数を使用します。
図表が大きすぎてそのコンテンツがページをまたいで分割可能な場合（例えば大きな表が含まれている場合）、このshowルールで図表自体もページをまたいで分割可能です。
#show figure: set block(breakable: true)
分割できるブロックと分割できないブロックの詳細については、blockのドキュメントを参照してください。
キャプションの改変
図表のキャプションの外観は、関連するキャプション機能で改変できます。 以下の例では、全てのキャプションを斜体で強調しています。
#show figure.caption: emph
#figure(
rect[Hello],
caption: [I am emphasized!],
)
whereセレクターを使うことで、このようなルールを特定の種類の図表に適用可能です。
例えば、図表の種類が表の場合はキャプションを表の上に配置し、他の種類ではキャプションを下に配置するには、次のようなshow-setルールを記述します。
#show figure.where(
kind: table
): set figure.caption(position: top)
#figure(
table(columns: 2)[A][B][C][D],
caption: [I'm up here],
)
Accessibility
You can use the alt parameter to provide an alternative
description of the figure
for screen readers and other Assistive Technology (AT). Refer to its
documentation to learn more.
You can use figures to add alternative descriptions to paths, shapes, or
visualizations that do not have their own alt parameter. If your graphic
is purely decorative and does not have a semantic meaning, consider wrapping
it in pdf.artifact instead, which will hide it from AT when exporting to
PDF.
AT will always read the figure at the point where it appears in the
document, regardless of its placement. Put its markup
where it would make the most sense in the reading order.
引数引数引数は関数への入力値です。関数名の後に括弧で囲んで指定します。
figure(,alt:,,,,kind:,,,gap:,)->body
body図表のコンテンツ。多くの場合、 image が使われます。
An alternative description of the figure.
When you add an alternative description, AT will read both it and the caption (if any). However, the content of the figure itself will be skipped.
When the body of your figure is an image with its own alt
text set, this parameter should not be used on the figure element.
Likewise, do not use this parameter when the figure contains a table,
code, or other content that is already accessible. In such cases, the
content of the figure will be read by AT, and adding an alternative
description would lead to a loss of information.
You can learn how to write good alternative descriptions in the Accessibility Guide.
デフォルト値：none
ページ上における図表の配置。
none： 他のコンテンツと同様に書かれた場所に置かれる。auto：topかbottomの近い方に置かれる。top： ページの上部に置かれる。bottom： ページの下部に置かれる。
本文のコンテンツと図表の間隔はplace関数の clearance 引数によって制御します。
例を表示
#set page(height: 200pt)
#show figure: set place(
clearance: 1em,
)
= Introduction
#figure(
placement: bottom,
caption: [A glacier],
image("glacier.jpg", width: 60%),
)
#lorem(60)
デフォルト値：none
scope設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
scopesetルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。どの包含スコープに対して図を配置するか。
これを"parent"に設定すると、段組みをまたいで、ページの幅を全て使用した図表を作成します。
もしplacementをnoneとした場合には、何の効果もありません。
例を表示
#set page(height: 250pt, columns: 2)
= Introduction
#figure(
placement: bottom,
scope: "parent",
caption: [A glacier],
image("glacier.jpg", width: 60%),
)
#lorem(60)
使用可能な文字列値
column現在の列に配置する。
parent親要素に対して相対的な位置に配置され、コンテンツが全ての列にまたがって表示されます。
デフォルト値："column"
例を表示：Customizing the figure kind
#figure(
circle(radius: 10pt),
caption: [A curious atom.],
kind: "atom",
supplement: [Atom],
)
例を表示：Modifying the figure counter for specific kinds
#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.
デフォルト値：auto
図表の補足語。
auto に設定すると、図表は、種類やテキスト言語に基づいて、正しい補足語を自動的に決定しようとします。
独自の図表タイプを使用している場合は、補足語を手動で指定する必要があります。
関数が指定された場合、その関数は指定された種類の最初の子孫要素（通常は図の本体）に渡され、コンテンツを返す必要があります。
例を表示
#figure(
[The contents of my figure!],
caption: [My custom figure],
supplement: [Bar],
kind: "foo",
)
デフォルト値：auto
gap設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
gapsetルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。本文とキャプションの間の垂直方向の隙間。
デフォルト値：0.65em
定義定義これらの関数や型には、関連する定義を持たせることができます。定義にアクセスするには、対象の関数や型の名前を指定した後に、ピリオド区切りで定義名を記述します。
caption要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
captionsetルールやshowルールでカスタマイズできます。図のキャプション。 この要素は、全ての図や特定の種類の図のキャプションの外観を改変するために、 setルールやshowルールで使用可能です。
キャプションは、posとbodyに加えて、図のkindやsupplement、counter、numberingもフィールドとして提供します。
これらの要素をwhereセレクターやshowルールで使用することで、独自のキャプションを構築できます。
例を表示
#show figure.caption: emph
#figure(
rect[Hello],
caption: [A rectangle],
)
figure.caption(,,)->position設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
positionsetルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。図表の中のキャプションの位置。topや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!]
)
)
デフォルト値：bottom
例を表示
#set figure.caption(separator: [ --- ])
#figure(
rect[Hello],
caption: [A rectangle],
)
デフォルト値：auto
body
bodyキャプション名。
独自のキャプションに改変するために
kind、supplement、counter、numbering、locationが同時に使えます。
例を表示
#show figure.caption: it => [
#underline(it.body) |
#it.supplement
#context it.counter.display(it.numbering)
]
#figure(
rect[Hello],
caption: [A rectangle],
)
