`page` 元素

Layouts its child onto one or multiple pages.

Although this function is primarily used in set rules to affect page properties, it can also be used to explicitly render its argument onto a set of pages of its own.

Pages can be set to use auto as their width or height. In this case, the pages will grow to fit their content on the respective axis.

The Guide for Page Setup explains how to use this and related functions to set up a document with many examples.

Example

#set page("us-letter")

There you go, US friends!

参数

`paper`

str
可用 Set 规则

A standard paper size to set width and height.

"a0"

Produces a paper of the respective size.
"a1"

Produces a paper of the respective size.
"a2"

Produces a paper of the respective size.
"a3"

Produces a paper of the respective size.
"a4"

Produces a paper of the respective size.
"a5"

Produces a paper of the respective size.
"a6"

Produces a paper of the respective size.
"a7"

Produces a paper of the respective size.
"a8"

Produces a paper of the respective size.
"a9"

Produces a paper of the respective size.
"a10"

Produces a paper of the respective size.
"a11"

Produces a paper of the respective size.
"iso-b1"

Produces a paper of the respective size.
"iso-b2"

Produces a paper of the respective size.
"iso-b3"

Produces a paper of the respective size.
"iso-b4"

Produces a paper of the respective size.
"iso-b5"

Produces a paper of the respective size.
"iso-b6"

Produces a paper of the respective size.
"iso-b7"

Produces a paper of the respective size.
"iso-b8"

Produces a paper of the respective size.
"iso-c3"

Produces a paper of the respective size.
"iso-c4"

Produces a paper of the respective size.
"iso-c5"

Produces a paper of the respective size.
"iso-c6"

Produces a paper of the respective size.
"iso-c7"

Produces a paper of the respective size.
"iso-c8"

Produces a paper of the respective size.
"din-d3"

Produces a paper of the respective size.
"din-d4"

Produces a paper of the respective size.
"din-d5"

Produces a paper of the respective size.
"din-d6"

Produces a paper of the respective size.
"din-d7"

Produces a paper of the respective size.
"din-d8"

Produces a paper of the respective size.
"sis-g5"

Produces a paper of the respective size.
"sis-e5"

Produces a paper of the respective size.
"ansi-a"

Produces a paper of the respective size.
"ansi-b"

Produces a paper of the respective size.
"ansi-c"

Produces a paper of the respective size.
"ansi-d"

Produces a paper of the respective size.
"ansi-e"

Produces a paper of the respective size.
"arch-a"

Produces a paper of the respective size.
"arch-b"

Produces a paper of the respective size.
"arch-c"

Produces a paper of the respective size.
"arch-d"

Produces a paper of the respective size.
"arch-e1"

Produces a paper of the respective size.
"arch-e"

Produces a paper of the respective size.
"jis-b0"

Produces a paper of the respective size.
"jis-b1"

Produces a paper of the respective size.
"jis-b2"

Produces a paper of the respective size.
"jis-b3"

Produces a paper of the respective size.
"jis-b4"

Produces a paper of the respective size.
"jis-b5"

Produces a paper of the respective size.
"jis-b6"

Produces a paper of the respective size.
"jis-b7"

Produces a paper of the respective size.
"jis-b8"

Produces a paper of the respective size.
"jis-b9"

Produces a paper of the respective size.
"jis-b10"

Produces a paper of the respective size.
"jis-b11"

Produces a paper of the respective size.
"sac-d0"

Produces a paper of the respective size.
"sac-d1"

Produces a paper of the respective size.
"sac-d2"

Produces a paper of the respective size.
"sac-d3"

Produces a paper of the respective size.
"sac-d4"

Produces a paper of the respective size.
"sac-d5"

Produces a paper of the respective size.
"sac-d6"

Produces a paper of the respective size.
"iso-id-1"

Produces a paper of the respective size.
"iso-id-2"

Produces a paper of the respective size.
"iso-id-3"

Produces a paper of the respective size.
"asia-f4"

Produces a paper of the respective size.
"jp-shiroku-ban-4"

Produces a paper of the respective size.
"jp-shiroku-ban-5"

Produces a paper of the respective size.
"jp-shiroku-ban-6"

Produces a paper of the respective size.
"jp-kiku-4"

Produces a paper of the respective size.
"jp-kiku-5"

Produces a paper of the respective size.
"jp-business-card"

Produces a paper of the respective size.
"cn-business-card"

Produces a paper of the respective size.
"eu-business-card"

Produces a paper of the respective size.
"fr-tellière"

Produces a paper of the respective size.
"fr-couronne-écriture"

Produces a paper of the respective size.
"fr-couronne-édition"

Produces a paper of the respective size.
"fr-raisin"

Produces a paper of the respective size.
"fr-carré"

Produces a paper of the respective size.
"fr-jésus"

Produces a paper of the respective size.
"uk-brief"

Produces a paper of the respective size.
"uk-draft"

Produces a paper of the respective size.
"uk-foolscap"

Produces a paper of the respective size.
"uk-quarto"

Produces a paper of the respective size.
"uk-crown"

Produces a paper of the respective size.
"uk-book-a"

Produces a paper of the respective size.
"uk-book-b"

Produces a paper of the respective size.
"us-letter"

Produces a paper of the respective size.
"us-legal"

Produces a paper of the respective size.
"us-tabloid"

Produces a paper of the respective size.
"us-executive"

Produces a paper of the respective size.
"us-foolscap-folio"

Produces a paper of the respective size.
"us-statement"

Produces a paper of the respective size.
"us-ledger"

Produces a paper of the respective size.
"us-oficio"

Produces a paper of the respective size.
"us-gov-letter"

Produces a paper of the respective size.
"us-gov-legal"

Produces a paper of the respective size.
"us-business-card"

Produces a paper of the respective size.
"us-digest"

Produces a paper of the respective size.
"us-trade"

Produces a paper of the respective size.
"newspaper-compact"

Produces a paper of the respective size.
"newspaper-berliner"

Produces a paper of the respective size.
"newspaper-broadsheet"

Produces a paper of the respective size.
"presentation-16-9"

Produces a paper of the respective size.
"presentation-4-3"

Produces a paper of the respective size.

默认："a4"

`width`

auto length
可用 Set 规则

The width of the page.

默认：595.28pt

查看示例

#set page(
  width: 3cm,
  margin: (x: 0cm),
)

#for i in range(3) {
  box(square(width: 1cm))
}

`height`

auto length
可用 Set 规则

The height of the page.

If this is set to auto, page breaks can only be triggered manually by inserting a page break. Most examples throughout this documentation use auto for the height of the page to dynamically grow and shrink to fit their content.

默认：841.89pt

`flipped`

bool
可用 Set 规则

Whether the page is flipped into landscape orientation.

默认：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`

auto relative dictionary
可用 Set 规则

The page's margins.

auto: The margins are set automatically to 2.5/21 times the smaller dimension of the page. This results in 2.5cm margins for an A4 page.
A single length: The same margin on all sides.
A dictionary: With a dictionary, the margins can be set individually. The dictionary can contain the following keys in order of precedence:
- top: The top margin.
- right: The right margin.
- bottom: The bottom margin.
- left: The left margin.
- inside: The margin at the inner side of the page (where the binding is).
- outside: The margin at the outer side of the page (opposite to the binding).
- x: The horizontal margins.
- y: The vertical margins.
- rest: The margins on all sides except those for which the dictionary explicitly sets a size.

The values for left and right are mutually exclusive with the values for inside and outside.

默认：(:)

查看示例

#set page(
 width: 3cm,
 height: 4cm,
 margin: (x: 8pt, y: 4pt),
)

#rect(
  width: 100%,
  height: 100%,
  fill: aqua,
)

`binding`

auto alignment
可用 Set 规则

On which side the pages will be bound.

auto: Equivalent to left if the text direction is left-to-right and right if it is right-to-left.
left: Bound on the left side.
right: Bound on the right side.

This affects the meaning of the inside and outside options for margins.

默认：auto

`columns`

int
可用 Set 规则

How many columns the page has.

If you need to insert columns into a page or other container, you can also use the columns function.

默认：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 color gradient pattern
可用 Set 规则

The page's background color.

This instructs the printer to color the complete page with the given color. If you are considering larger production runs, it may be more environmentally friendly and cost-effective to source pre-dyed pages and not set this property.

默认：none

查看示例

#set page(fill: rgb("444352"))
#set text(fill: rgb("fdfdfd"))
*Dark mode enabled.*

`numbering`

none str function
可用 Set 规则

How to number the pages.

If an explicit footer (or header for top-aligned numbering) is given, the numbering is ignored.

默认：none

查看示例

#set page(
  height: 100pt,
  margin: (top: 16pt, bottom: 24pt),
  numbering: "1 / 1",
)

#lorem(48)

`number-align`

alignment
可用 Set 规则

The alignment of the page numbering.

If the vertical component is top, the numbering is placed into the header and if it is bottom, it is placed in the footer. Horizon alignment is forbidden. If an explicit matching header or footer is given, the numbering is ignored.

默认：center + bottom

查看示例

#set page(
  margin: (top: 16pt, bottom: 24pt),
  numbering: "1",
  number-align: right,
)

#lorem(30)

`header`

none content
可用 Set 规则

The page's header. Fills the top margin of each page.

默认：none

查看示例

#set par(justify: true)
#set page(
  margin: (top: 32pt, bottom: 20pt),
  header: [
    #set text(8pt)
    #smallcaps[Typst Academcy]
    #h(1fr) _Exercise Sheet 3_
  ],
)

#lorem(19)

`header-ascent`

relative
可用 Set 规则

The amount the header is raised into the top margin.

默认：30%

`footer`

none content
可用 Set 规则

The page's footer. Fills the bottom margin of each page.

For just a page number, the numbering property, typically suffices. If you want to create a custom footer, but still display the page number, you can directly access the page counter.

默认：none

查看示例

#set par(justify: true)
#set page(
  height: 100pt,
  margin: 20pt,
  footer: [
    #set align(right)
    #set text(8pt)
    #counter(page).display(
      "1 of I",
      both: true,
    )
  ]
)

#lorem(48)

`footer-descent`

relative
可用 Set 规则

The amount the footer is lowered into the bottom margin.

默认：30%

`background`

none content
可用 Set 规则

Content in the page's background.

This content will be placed behind the page's body. It can be used to place a background image or a watermark.

默认：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 content
可用 Set 规则

Content in the page's foreground.

This content will overlay the page's body.

默认：none

查看示例

#set page(foreground: text(24pt)[🥸])

Reviewer 2 has marked our paper
"Weak Reject" because they did
not understand our approach...

`body`

content
必需参数位置参数

The contents of the page(s).

Multiple pages will be created if the content does not fit on a single page. A new page with the page properties prior to the function invocation will be created after the body has been typeset.

Padding上一页

Page Break下一页

page 元素 元素函数可以通过 set 和 show 规则进行样式自定义。 元素函数可以通过 set 和 show 规则进行样式自定义。

Example

参数 参数是函数的输入，它们在函数名称后面的括号中传入。 参数是函数的输入，它们在函数名称后面的括号中传入。

paper str 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

width auto length 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

height auto length 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

flipped bool 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

margin auto relative dictionary 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

binding auto alignment 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

columns int 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

fill none color gradient pattern 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

numbering none str function 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

number-align alignment 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

header none content 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

header-ascent relative 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

footer none content 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

footer-descent relative 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

background none content 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

foreground none content 可用 Set 规则 可以使用 Set 规则，为函数后续所有的使用设置默认参数。 可以使用 Set 规则，为函数后续所有的使用设置默认参数。

body content 必需参数位置参数 位置参数按顺序传入，不带名称。 位置参数按顺序传入，不带名称。

`page` 元素

参数

`paper`

str
可用 Set 规则

`width`

auto length
可用 Set 规则

`height`

auto length
可用 Set 规则

`flipped`

bool
可用 Set 规则

`margin`

auto relative dictionary
可用 Set 规则

`binding`

auto alignment
可用 Set 规则

`columns`

int
可用 Set 规则

`fill`

none color gradient pattern
可用 Set 规则

`numbering`

none str function
可用 Set 规则

`number-align`

alignment
可用 Set 规则

`header`

none content
可用 Set 规则

`header-ascent`

relative
可用 Set 规则

`footer`

none content
可用 Set 规则

`footer-descent`

relative
可用 Set 规则

`background`

none content
可用 Set 规则

`foreground`

none content
可用 Set 规则

`body`

content
必需参数位置参数