enum
Element
Element functions can be customized with set and show rules.
set and show rules.番号付きリスト。
一連の項目を縦に並べて表示し、それぞれに連番を付けます。
例
Automatically numbered:
+ Preparations
+ Analysis
+ Conclusions
Manually numbered:
2. What is the first step?
5. I am confused.
+ Moving on ...
Multiple lines:
+ This enum item has multiple
lines because the next line
is indented.
Function call.
#enum[First][Second]
setルールを用いることで、 すべてのリストを異なるナンバリングスタイルに簡単に切り替えることができます。
#set enum(numbering: "a)")
+ Starting off ...
+ Don't forget step two
また、enum.itemを使用して、
リストの各項目の番号を自由にカスタマイズすることもできます。
#enum(
enum.item(1)[First step],
enum.item(5)[Fifth step],
enum.item(10)[Tenth step]
)
構文
この関数には専用の構文もあります。
- 行の先頭にプラス記号をつけると、 自動的にナンバリングされたリスト項目が作成されます。
- 行の先頭に数字とピリオドを付けると、 明示的に番号を指定したリスト項目が作成されます。
リストの項目には、複数の段落やその他のブロックレベルのコンテンツを含めることができます。 項目のマーカーよりもインデントが深いコンテンツはすべて、 その項目の一部となります。
引数
Parameters are the inputs to a function. They are specified in parentheses after the function name.
tight
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.リストのデフォルトのspacingを定義します。
これがfalseの場合、
項目の間隔はparagraph spacingによって決まります。
trueの場合、代わりにparagraph leadingが使用されます。
これによりリストがよりコンパクトになり、各項目が短い場合に見栄えが良くなります。
マークアップモードでは、
この引数の値は項目が空行で区切られているかどうかに基づいて決定されます。
項目間に空行がなく連続している場合、この値はtrueに設定されますが、
項目間が空行で区切られている場合はfalseに設定されます。
マークアップで定義された間隔はsetルールで上書きすることは出来ません。
Default:true
View example
+ If an enum has a lot of text, and
maybe other inline content, it
should not be tight anymore.
+ To make an enum wide, simply
insert a blank line between the
items.
numbering
リストをどのようにナンバリングするかを指定します。 ナンバリングパターンまたは関数を受け付けます。
ナンバリングのパターンに複数のカウント記号が含まれている場合、
それらはネストされたリストに適用されます。
関数が指定された場合、fullがfalseの場合は1つの引数を受け取り、trueの場合は複数の引数を受け取ります。
Default:"1."
View example
#set enum(numbering: "1.a)")
+ Different
+ Numbering
+ Nested
+ Items
+ Style
#set enum(numbering: n => super[#n])
+ Superscript
+ Numbering!
start
リストの開始番号を指定します。
Default:auto
View example
#enum(
start: 3,
[Skipping],
[Ahead],
)
full
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.親リストの番号も含めて、 完全なナンバリングを表示するかどうかを指定します。
Default:false
View example
#set enum(numbering: "1.a)", full: true)
+ Cook
+ Heat water
+ Add ingredients
+ Eat
reversed
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.このリストのナンバリングを逆順にするかどうかを指定します。
Default:false
View example
#set enum(reversed: true)
+ Coffee
+ Tea
+ Milk
indent
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.各項目のインデント。
Default:0pt
body-indent
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.各項目のナンバリングと本文の間隔を指定します。
Default:0.5em
spacing
リストの項目同士の間隔を指定します。
autoに設定すると、
コンパクトなリストの場合は段落のleadingを、
幅のある（コンパクトでない）リストの場合は段落のspacingを使用します。
Default:auto
number-align
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.リストの番号の配置を指定します。
デフォルトでは、この値はend + topに設定されており、これはリストの番号を
現在のテキスト方向の終端（例えば、左から右へ書く文書では、これはrightと同じ）と、
行の上部に揃えます。
一般的に、水平方向の番号の配置にはstartよりもendを選択することが推奨されます。
なぜなら、番号がテキストに向かってではなくテキストから離れる方向に伸びることによって、
特定の視覚的な問題を回避できるからです。
しかし、このオプションを使用することで、この動作を上書きすることができます。
（また、unordered listは異なる方法を用いており、直接markerコンテンツに配置を指定することで、
これを行っていることに注意してください）
Default:end + top
View example
#set enum(number-align: start + bottom)
Here are some powers of two:
1. One
2. Two
4. Four
8. Eight
16. Sixteen
32. Thirty two
children
番号付きリストの項目。
enum構文を使用する場合、forループのような構造を挟んでも、 隣接する項目は自動的にリストとしてまとめられます。
View example
#for phase in (
"Launch",
"Orbit",
"Descent",
) [+ #phase]
定義
Functions and types and can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.
item
番号付きリストの項目。
number
項目の番号。
Default:none
body
項目の本文。