このページは日本語に翻訳済みです。
page要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
setルールやshowルールでカスタマイズできます。その子要素を単一ページか複数ページにレイアウト。
この関数は主にsetルールでページのプロパティに影響を与えるために使用されますが、引数を独自のページセットに明示的にレンダリングするためにも使用できます。
ページでは幅と高さにautoが設定可能です。
この場合、ページは各軸方向においてコンテンツに合わせて大きくなります。
ページセットアップガイドでは多くの例とともにこの関数と関連する関数を用いてどのように文書をセットアップするかを説明しています。
例
#set page("us-letter")
There you go, US friends!
引数引数引数は関数への入力値です。関数名の後に括弧で囲んで指定します。
paper設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。幅と高さを設定するための標準的な紙の大きさ。
これはwidthとheightを設定するための単なる省略記法であり、その性質上コンテキスト式からは取得できません。
使用可能な文字列値:
a0指定された大きさの用紙を生成。
a1指定された大きさの用紙を生成。
a2指定された大きさの用紙を生成。
a3指定された大きさの用紙を生成。
a4指定された大きさの用紙を生成。
a5指定された大きさの用紙を生成。
a6指定された大きさの用紙を生成。
a7指定された大きさの用紙を生成。
a8指定された大きさの用紙を生成。
a9指定された大きさの用紙を生成。
a10指定された大きさの用紙を生成。
a11指定された大きさの用紙を生成。
iso-b1指定された大きさの用紙を生成。
iso-b2指定された大きさの用紙を生成。
iso-b3指定された大きさの用紙を生成。
iso-b4指定された大きさの用紙を生成。
iso-b5指定された大きさの用紙を生成。
iso-b6指定された大きさの用紙を生成。
iso-b7指定された大きさの用紙を生成。
iso-b8指定された大きさの用紙を生成。
iso-c3指定された大きさの用紙を生成。
iso-c4指定された大きさの用紙を生成。
iso-c5指定された大きさの用紙を生成。
iso-c6指定された大きさの用紙を生成。
iso-c7指定された大きさの用紙を生成。
iso-c8指定された大きさの用紙を生成。
din-d3指定された大きさの用紙を生成。
din-d4指定された大きさの用紙を生成。
din-d5指定された大きさの用紙を生成。
din-d6指定された大きさの用紙を生成。
din-d7指定された大きさの用紙を生成。
din-d8指定された大きさの用紙を生成。
sis-g5指定された大きさの用紙を生成。
sis-e5指定された大きさの用紙を生成。
ansi-a指定された大きさの用紙を生成。
ansi-b指定された大きさの用紙を生成。
ansi-c指定された大きさの用紙を生成。
ansi-d指定された大きさの用紙を生成。
ansi-e指定された大きさの用紙を生成。
arch-a指定された大きさの用紙を生成。
arch-b指定された大きさの用紙を生成。
arch-c指定された大きさの用紙を生成。
arch-d指定された大きさの用紙を生成。
arch-e1指定された大きさの用紙を生成。
arch-e指定された大きさの用紙を生成。
jis-b0指定された大きさの用紙を生成。
jis-b1指定された大きさの用紙を生成。
jis-b2指定された大きさの用紙を生成。
jis-b3指定された大きさの用紙を生成。
jis-b4指定された大きさの用紙を生成。
jis-b5指定された大きさの用紙を生成。
jis-b6指定された大きさの用紙を生成。
jis-b7指定された大きさの用紙を生成。
jis-b8指定された大きさの用紙を生成。
jis-b9指定された大きさの用紙を生成。
jis-b10指定された大きさの用紙を生成。
jis-b11指定された大きさの用紙を生成。
sac-d0指定された大きさの用紙を生成。
sac-d1指定された大きさの用紙を生成。
sac-d2指定された大きさの用紙を生成。
sac-d3指定された大きさの用紙を生成。
sac-d4指定された大きさの用紙を生成。
sac-d5指定された大きさの用紙を生成。
sac-d6指定された大きさの用紙を生成。
iso-id-1指定された大きさの用紙を生成。
iso-id-2指定された大きさの用紙を生成。
iso-id-3指定された大きさの用紙を生成。
asia-f4指定された大きさの用紙を生成。
jp-shiroku-ban-4指定された大きさの用紙を生成。
jp-shiroku-ban-5指定された大きさの用紙を生成。
jp-shiroku-ban-6指定された大きさの用紙を生成。
jp-kiku-4指定された大きさの用紙を生成。
jp-kiku-5指定された大きさの用紙を生成。
jp-business-card指定された大きさの用紙を生成。
cn-business-card指定された大きさの用紙を生成。
eu-business-card指定された大きさの用紙を生成。
fr-tellière指定された大きさの用紙を生成。
fr-couronne-écriture指定された大きさの用紙を生成。
fr-couronne-édition指定された大きさの用紙を生成。
fr-raisin指定された大きさの用紙を生成。
fr-carré指定された大きさの用紙を生成。
fr-jésus指定された大きさの用紙を生成。
uk-brief指定された大きさの用紙を生成。
uk-draft指定された大きさの用紙を生成。
uk-foolscap指定された大きさの用紙を生成。
uk-quarto指定された大きさの用紙を生成。
uk-crown指定された大きさの用紙を生成。
uk-book-a指定された大きさの用紙を生成。
uk-book-b指定された大きさの用紙を生成。
us-letter指定された大きさの用紙を生成。
us-legal指定された大きさの用紙を生成。
us-tabloid指定された大きさの用紙を生成。
us-executive指定された大きさの用紙を生成。
us-foolscap-folio指定された大きさの用紙を生成。
us-statement指定された大きさの用紙を生成。
us-ledger指定された大きさの用紙を生成。
us-oficio指定された大きさの用紙を生成。
us-gov-letter指定された大きさの用紙を生成。
us-gov-legal指定された大きさの用紙を生成。
us-business-card指定された大きさの用紙を生成。
us-digest指定された大きさの用紙を生成。
us-trade指定された大きさの用紙を生成。
newspaper-compact指定された大きさの用紙を生成。
newspaper-berliner指定された大きさの用紙を生成。
newspaper-broadsheet指定された大きさの用紙を生成。
presentation-16-9指定された大きさの用紙を生成。
presentation-4-3指定された大きさの用紙を生成。
デフォルト値: "a4"
width
ページの幅。
デフォルト値: 595.28pt
例を表示
#set page(
width: 3cm,
margin: (x: 0cm),
)
#for i in range(3) {
box(square(width: 1cm))
}
height
ページの高さ。
これがautoに設定された場合、改ページは手動で挿入したときのみ発火させることができます。
このドキュメントのほとんどの例では、ページの高さに auto を指定しており、コンテンツに合わせて動的に伸縮するようにしています。
デフォルト値: 841.89pt
flipped設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。ページを90度回転させるかどうか。
デフォルト値: false
例を表示
#set page(
"us-business-card",
flipped: true,
fill: rgb("f2e5dd"),
)
#set align(bottom + end)
#text(14pt)[*Sam H. Richards*] \
_Procurement Manager_
#set text(10pt)
17 Main Street \
New York, NY 10001 \
+1 555 555 5555
margin設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。ページの余白。
auto: 余白が自動的に短辺の2.5/21倍の大きさに設定されます。 A4のページでは2.5cmの余白になります。- 単一の長さ指定: 全ての辺に同じ大きさの余白を適用します。
- 辞書指定: 辞書を用いることで余白を個々に設定可能です。 この辞書に含められるキーは以下のとおりです。リストは優先順位の順に並んでいます。
leftとrightの値はinsideとoutsideの値と同時に指定できません。
デフォルト値: auto
例を表示
#set page(
width: 3cm,
height: 4cm,
margin: (x: 8pt, y: 4pt),
)
#rect(
width: 100%,
height: 100%,
fill: aqua,
)
binding
ページのどちら側を綴じるか。
auto: テキストの向きが左から右ならleftと等価となり、右から左ならrightと等価となります。left: 左側を綴じます。right: 右側を綴じます。
これは余白のinsideおよびoutsideオプションの意味に影響します。
デフォルト値: auto
columns設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。ぺージの段数。
ページや他のコンテナに段を挿入したい場合はcolumns関数も使用できます。
デフォルト値: 1
例を表示
#set page(columns: 2, height: 4.8cm)
Climate change is one of the most
pressing issues of our time, with
the potential to devastate
communities, ecosystems, and
economies around the world. It's
clear that we need to take urgent
action to reduce our carbon
emissions and mitigate the impacts
of a rapidly changing climate.
fill
ページ背景の塗り潰し。
これを非透明なものに設定すると、プリンターにページ全体を着色するよう指示します。 印刷規模が大きい場合は、このプロパティを設定せず、あらかじめ染色された用紙を調達したほうが環境にも優しくコスト削減もできるでしょう。
noneに設定すると背景は透明になります。
ビューワーではPDFのページに（通常は白色の）背景があるように見えますが、実際は透明であることに注意してください（印刷時には背景に色が使用されません）。
デフォルト値のautoは、PDF出力の場合はnoneとなり、PNGおよびSVG出力の場合はwhiteになります。
デフォルト値: auto
例を表示
#set page(fill: rgb("444352"))
#set text(fill: rgb("fdfdfd"))
*Dark mode enabled.*
numbering
ページ番号の付け方。
footer（もしくは上部配置番号付けの場合はheader）が明示的に与えられた場合、numberingは無視されます。
デフォルト値: none
例を表示
#set page(
height: 100pt,
margin: (top: 16pt, bottom: 24pt),
numbering: "1 / 1",
)
#lorem(48)
supplement
ページの補足語。
ページ参照では、これはページ番号の前に追加されます。
デフォルト値: auto
例を表示
#set page(numbering: "1.", supplement: [p.])
= Introduction <intro>
We are on #ref(<intro>, form: "page")!
number-align設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。ページ番号の配置。
垂直成分がtopの場合は、番号はヘッダー内に配置され、bottomの場合はフッター内に配置されます。
水平方向には配置できません。
対応するheaderやfooterが明示的に与えられた場合、numberingは無視されます。
デフォルト値: center + bottom
例を表示
#set page(
margin: (top: 16pt, bottom: 24pt),
numbering: "1",
number-align: right,
)
#lorem(30)
header
ページのヘッダー。 ページの上部余白を埋めます。
- コンテンツが与えられた場合: ヘッダーとしてコンテンツを表示します。
auto:numberingが設定されており、number-alignがtopの場合ページ番号を表示します。none: ヘッダーを表示しません。
デフォルト値: auto
例を表示
#set par(justify: true)
#set page(
margin: (top: 32pt, bottom: 20pt),
header: [
#set text(8pt)
#smallcaps[Typst Academy]
#h(1fr) _Exercise Sheet 3_
],
)
#lorem(19)
header-ascent設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。上部余白方向のヘッダーの上昇量。
デフォルト値: 30% + 0pt
footer
ページのフッター。 ページの下部余白を埋めます。
- コンテンツが与えられた場合: フッターとしてコンテンツを表示します。
auto:numberingが設定されており、number-alignがbottomの場合ページ番号を表示します。none: フッターを表示しません。
単純なページ番号を使用する場合は、一般的にnumberingプロパティで十分です。
カスタムフッターを作成したい場合でページ番号を表示したいときは、ページカウンターに直接アクセスできます。
デフォルト値: auto
例を表示
#set par(justify: true)
#set page(
height: 100pt,
margin: 20pt,
footer: context [
#set align(right)
#set text(8pt)
#counter(page).display(
"1 of I",
both: true,
)
]
)
#lorem(48)
footer-descent設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。下部余白方向のフッターの下降量。
デフォルト値: 30% + 0pt
background
ページ背景のコンテンツ。
このコンテンツはページ本文の背後に配置されます。 これは背景画像や透かしに使用できます。
デフォルト値: none
例を表示
#set page(background: rotate(24deg,
text(18pt, fill: rgb("FFCBC4"))[
*CONFIDENTIAL*
]
))
= Typst's secret plans
In the year 2023, we plan to take
over the world (of typesetting).
foreground
ページ前景のコンテンツ。
このコンテンツはページ本文の上に重なって表示されます。
デフォルト値: none
例を表示
#set page(foreground: text(24pt)[🥸])
Reviewer 2 has marked our paper
"Weak Reject" because they did
not understand our approach...
body
ページの本文。
コンテンツが単一ページに収まらなかった場合は複数ページが作成されます。 関数呼び出し前に設定されていたページプロパティを適用した新しいページが本文組版後に作成されます。