Traducción no oficial al español rioplatense, generada con IA (Claude Sonnet 5.5) bajo la dirección y revisión de Jassiel Ovando. No es una publicación de Typst GmbH ni cuenta con su aval; ante cualquier duda, prevalece la documentación oficial en inglés. ¿Un error de traducción o una sugerencia? Reportalo. Tipografía: Reforma, de PampaType.

pageElemento
Signo de pregunta
Desde: siempreIr al código fuente

Dispone su hijo en una o varias páginas.

Aunque esta función se usa principalmente en reglas set para afectar las propiedades de la página, también se puede usar para renderizar explícitamente su argumento en un conjunto de páginas propio.

Las páginas se pueden configurar con auto como ancho o alto. En ese caso, las páginas crecerán para ajustarse a su contenido en el eje respectivo.

La guía de configuración de página explica, con muchos ejemplos, cómo usar esta función y otras relacionadas para configurar un documento.

Ejemplo

#set page("us-letter")

There you go, US friends!

Accesibilidad

El contenido del encabezado, el pie, el primer plano y el fondo de la página es invisible para las tecnologías de asistencia (TA), como los lectores de pantalla. Las TA solo leen el cuerpo de la página. No incluyas en estas áreas información vital que no esté incluida en otro lugar del documento.

Estilos

Tené en cuenta que el elemento page no puede ser objetivo de reglas show; escribir show page: .. no tiene efecto. Para repetir contenido en todas las páginas, podés configurar en cambio las propiedades header, footer, background y foreground con una regla set.

Parámetros

page(
paper: str,width: autolength,height: autolength,flipped: bool,margin: autorelativedictionary,bleed: relativedictionary,binding: autoalignment,columns: int,fill: noneautocolorgradienttiling,numbering: nonestrfunction,supplement: noneautocontent,number-align: alignment,header: noneautocontent,header-ascent: relative,footer: noneautocontent,footer-descent: relative,background: nonecontent,foreground: nonecontent,content,
) → content

paper
str
Por defecto: "a4"

Un tamaño de papel estándar para establecer el ancho y el alto.

Es solo un atajo para establecer width y height y, como tal, no se puede obtener en una expresión de contexto.

ExpandirVer opciones
VarianteDetalles
"a0"Un papel de 841.0 × 1189.0 milímetros.
"a1"Un papel de 594.0 × 841.0 milímetros.
"a2"Un papel de 420.0 × 594.0 milímetros.
"a3"Un papel de 297.0 × 420.0 milímetros.
"a4"Un papel de 210.0 × 297.0 milímetros.
"a5"Un papel de 148.0 × 210.0 milímetros.
"a6"Un papel de 105.0 × 148.0 milímetros.
"a7"Un papel de 74.0 × 105.0 milímetros.
"a8"Un papel de 52.0 × 74.0 milímetros.
"a9"Un papel de 37.0 × 52.0 milímetros.
"a10"Un papel de 26.0 × 37.0 milímetros.
"a11"Un papel de 18.0 × 26.0 milímetros.
"iso-b1"Un papel de 707.0 × 1000.0 milímetros.
"iso-b2"Un papel de 500.0 × 707.0 milímetros.
"iso-b3"Un papel de 353.0 × 500.0 milímetros.
"iso-b4"Un papel de 250.0 × 353.0 milímetros.
"iso-b5"Un papel de 176.0 × 250.0 milímetros.
"iso-b6"Un papel de 125.0 × 176.0 milímetros.
"iso-b7"Un papel de 88.0 × 125.0 milímetros.
"iso-b8"Un papel de 62.0 × 88.0 milímetros.
"iso-c3"Un papel de 324.0 × 458.0 milímetros.
"iso-c4"Un papel de 229.0 × 324.0 milímetros.
"iso-c5"Un papel de 162.0 × 229.0 milímetros.
"iso-c6"Un papel de 114.0 × 162.0 milímetros.
"iso-c7"Un papel de 81.0 × 114.0 milímetros.
"iso-c8"Un papel de 57.0 × 81.0 milímetros.
"din-d3"Un papel de 272.0 × 385.0 milímetros.
"din-d4"Un papel de 192.0 × 272.0 milímetros.
"din-d5"Un papel de 136.0 × 192.0 milímetros.
"din-d6"Un papel de 96.0 × 136.0 milímetros.
"din-d7"Un papel de 68.0 × 96.0 milímetros.
"din-d8"Un papel de 48.0 × 68.0 milímetros.
"sis-g5"Un papel de 169.0 × 239.0 milímetros.
"sis-e5"Un papel de 115.0 × 220.0 milímetros.
"ansi-a"Un papel de 216.0 × 279.0 milímetros.
"ansi-b"Un papel de 279.0 × 432.0 milímetros.
"ansi-c"Un papel de 432.0 × 559.0 milímetros.
"ansi-d"Un papel de 559.0 × 864.0 milímetros.
"ansi-e"Un papel de 864.0 × 1118.0 milímetros.
"arch-a"Un papel de 229.0 × 305.0 milímetros.
"arch-b"Un papel de 305.0 × 457.0 milímetros.
"arch-c"Un papel de 457.0 × 610.0 milímetros.
"arch-d"Un papel de 610.0 × 914.0 milímetros.
"arch-e1"Un papel de 762.0 × 1067.0 milímetros.
"arch-e"Un papel de 914.0 × 1219.0 milímetros.
"jis-b0"Un papel de 1030.0 × 1456.0 milímetros.
"jis-b1"Un papel de 728.0 × 1030.0 milímetros.
"jis-b2"Un papel de 515.0 × 728.0 milímetros.
"jis-b3"Un papel de 364.0 × 515.0 milímetros.
"jis-b4"Un papel de 257.0 × 364.0 milímetros.
"jis-b5"Un papel de 182.0 × 257.0 milímetros.
"jis-b6"Un papel de 128.0 × 182.0 milímetros.
"jis-b7"Un papel de 91.0 × 128.0 milímetros.
"jis-b8"Un papel de 64.0 × 91.0 milímetros.
"jis-b9"Un papel de 45.0 × 64.0 milímetros.
"jis-b10"Un papel de 32.0 × 45.0 milímetros.
"jis-b11"Un papel de 22.0 × 32.0 milímetros.
"sac-d0"Un papel de 764.0 × 1064.0 milímetros.
"sac-d1"Un papel de 532.0 × 760.0 milímetros.
"sac-d2"Un papel de 380.0 × 528.0 milímetros.
"sac-d3"Un papel de 264.0 × 376.0 milímetros.
"sac-d4"Un papel de 188.0 × 260.0 milímetros.
"sac-d5"Un papel de 130.0 × 184.0 milímetros.
"sac-d6"Un papel de 92.0 × 126.0 milímetros.
"iso-id-1"Un papel de 85.6 × 53.98 milímetros.
"iso-id-2"Un papel de 74.0 × 105.0 milímetros.
"iso-id-3"Un papel de 88.0 × 125.0 milímetros.
"asia-f4"Un papel de 210.0 × 330.0 milímetros.
"jp-shiroku-ban-4"Un papel de 264.0 × 379.0 milímetros.
"jp-shiroku-ban-5"Un papel de 189.0 × 262.0 milímetros.
"jp-shiroku-ban-6"Un papel de 127.0 × 188.0 milímetros.
"jp-kiku-4"Un papel de 227.0 × 306.0 milímetros.
"jp-kiku-5"Un papel de 151.0 × 227.0 milímetros.
"jp-business-card"Un papel de 91.0 × 55.0 milímetros.
"cn-business-card"Un papel de 90.0 × 54.0 milímetros.
"eu-business-card"Un papel de 85.0 × 55.0 milímetros.
"fr-tellière"Un papel de 340.0 × 440.0 milímetros.
"fr-couronne-écriture"Un papel de 360.0 × 460.0 milímetros.
"fr-couronne-édition"Un papel de 370.0 × 470.0 milímetros.
"fr-raisin"Un papel de 500.0 × 650.0 milímetros.
"fr-carré"Un papel de 450.0 × 560.0 milímetros.
"fr-jésus"Un papel de 560.0 × 760.0 milímetros.
"uk-brief"Un papel de 406.4 × 342.9 milímetros.
"uk-draft"Un papel de 254.0 × 406.4 milímetros.
"uk-foolscap"Un papel de 203.2 × 330.2 milímetros.
"uk-quarto"Un papel de 203.2 × 254.0 milímetros.
"uk-crown"Un papel de 508.0 × 381.0 milímetros.
"uk-book-a"Un papel de 111.0 × 178.0 milímetros.
"uk-book-b"Un papel de 129.0 × 198.0 milímetros.
"us-letter"Un papel de 215.9 × 279.4 milímetros.
"us-legal"Un papel de 215.9 × 355.6 milímetros.
"us-tabloid"Un papel de 279.4 × 431.8 milímetros.
"us-executive"Un papel de 184.15 × 266.7 milímetros.
"us-foolscap-folio"Un papel de 215.9 × 342.9 milímetros.
"us-statement"Un papel de 139.7 × 215.9 milímetros.
"us-ledger"Un papel de 431.8 × 279.4 milímetros.
"us-oficio"Un papel de 215.9 × 340.36 milímetros.
"us-gov-letter"Un papel de 203.2 × 266.7 milímetros.
"us-gov-legal"Un papel de 215.9 × 330.2 milímetros.
"us-business-card"Un papel de 88.9 × 50.8 milímetros.
"us-digest"Un papel de 139.7 × 215.9 milímetros.
"us-trade"Un papel de 152.4 × 228.6 milímetros.
"newspaper-compact"Un papel de 280.0 × 430.0 milímetros.
"newspaper-berliner"Un papel de 315.0 × 470.0 milímetros.
"newspaper-broadsheet"Un papel de 381.0 × 578.0 milímetros.
"presentation-16-9"Un papel de 297.0 × 167.0625 milímetros.
"presentation-4-3"Un papel de 280.0 × 210.0 milímetros.

width
auto o length
Configurable con set
Signo de pregunta
Por defecto: 595.28pt

El ancho de la página final, después de aplicar los recortes.

En las configuraciones de impresión profesional, puede ser menor que el tamaño de la hoja que se le da a la impresora.

Mirá el parámetro bleed para más detalles sobre cómo establecer un área de recorte o de sangrado.

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

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

height
auto o length
Configurable con set
Signo de pregunta
Por defecto: 841.89pt

La altura del área final de la página, después de aplicar los recortes.

Si se establece en auto, los saltos de página solo se pueden provocar manualmente insertando un salto de página o agregando otra regla set de página no vacía. La mayoría de los ejemplos de esta documentación usan auto como altura de página para que crezca y se reduzca dinámicamente según su contenido.

flipped
bool
Configurable con set
Signo de pregunta
Por defecto: false

Si la página se gira a orientación horizontal.

ExpandirVer ejemplo
#set page(
  "us-business-card",
  flipped: true,
  fill: rgb("f2e5dd"),
)

#set align(bottom + end)
#text(14pt)[*Sam H. Richards*] \
_Procurement Manager_

#set text(10pt)
23 W 23rd Street \
New York, NY 10010 \
+1 (212) 555-0155

margin
auto o relative o dictionary
Configurable con set
Signo de pregunta
Por defecto: auto

Los márgenes de la página.

Todas las claves son opcionales; las claves omitidas usarán su valor establecido previamente o el margen por defecto si nunca se establecieron. Además, los valores de left y right son mutuamente excluyentes con los de inside y outside. Los valores deben ser longitudes relativas o auto.

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

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

bleed
relative o dictionary
Configurable con set
Signo de pregunta
Por defecto: (:)

El margen de sangrado de la página.

El sangrado es el área de contenido que se extiende más allá del tamaño final recortado de la página. Asegura que no aparezcan bordes sin imprimir en el producto final, incluso si hay pequeños desajustes en el recorte.

Valores aceptados:

Todas las claves son opcionales; las claves omitidas usarán su valor establecido previamente o 0pt si nunca se establecieron. Además, los valores de left y right son mutuamente excluyentes con los de inside y outside. Los valores deben ser longitudes relativas.

En la exportación a PDF, si el sangrado no es cero, se define un TrimBox para la página.

ExpandirVer ejemplo
#set page(
  width: 8cm,
  height: 5cm,
  margin: 1cm,
  // The bleed is not visible in the preview;
  // it exceeds beyond the page.
  bleed: 0.5cm,
  // Fills the entire bleed area, so there will
  // be no white strips after printing and trimming.
  background: rect(width: 100%, height: 100%, fill: aqua),
)

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

binding
auto o alignment
Configurable con set
Signo de pregunta
Por defecto: auto

De qué lado se encuadernarán las páginas.

Esto afecta el significado de las opciones inside y outside de los márgenes.

columns
int
Configurable con set
Signo de pregunta
Por defecto: 1

Cuántas columnas tiene la página.

Si necesitás insertar columnas en una página u otro contenedor, también podés usar la función columns.

#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 o auto o color o gradient o tiling
Configurable con set
Signo de pregunta
Por defecto: auto

El relleno de fondo de la página.

Establecerlo en algo no transparente le indica a la impresora que coloree la página completa. Si estás considerando tiradas de producción más grandes, puede ser más amigable con el ambiente y más económico conseguir páginas teñidas de antemano y no establecer esta propiedad.

Cuando se establece en none, el fondo se vuelve transparente. Tené en cuenta que las páginas PDF igualmente aparecerán con un fondo (generalmente blanco) en los visores, pero en realidad son transparentes. (Si las imprimís, no se usa ningún color para el fondo.)

El valor por defecto auto resulta en none para la salida PDF y en white para PNG y SVG.

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

numbering
none o str o function
Configurable con set
Signo de pregunta
Por defecto: none

Cómo numerar las páginas. Podés consultar la guía de configuración de página sobre cómo personalizar los números de página.

Acepta una función o patrón de numeración que toma uno o dos números:

  1. El primer número es el número de la página actual.
  2. El segundo número es la cantidad total de páginas. En un patrón de numeración, el segundo número se puede omitir. Si se pasa una función, recibirá un argumento en el contexto de enlaces o referencias y dos argumentos al producir los números de página visibles.

Estos son números lógicos controlados por el contador de páginas y, por lo tanto, pueden no coincidir con los números físicos. Específicamente, son el valor actual y el valor final de counter(page). Mirá la documentación de counter para más detalles.

Si se da un footer explícito (o un header en el caso de numeración alineada arriba), la numeración se ignora.

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

#lorem(48)

supplement
none o auto o content
Configurable con set
Signo de pregunta
Por defecto: auto

Un suplemento para las páginas.

En las referencias a páginas, se agrega antes del número de página.

ExpandirVer ejemplo
#set page(numbering: "1.", supplement: [p.])

= Introduction <intro>
We are on #ref(<intro>, form: "page")!

number-align
alignment
Configurable con set
Signo de pregunta
Por defecto: center + bottom

La alineación de la numeración de páginas.

Si el componente vertical es top, la numeración se coloca en el encabezado y, si es bottom, se coloca en el pie de página. La alineación horizon está prohibida. Si se da un header o footer explícito que coincida, la numeración se ignora.

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

#lorem(30)

header
none o auto o content
Configurable con set
Signo de pregunta
Por defecto: auto

El encabezado de la página. Llena el margen superior de cada página.

ExpandirVer ejemplo
#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
relative
Configurable con set
Signo de pregunta
Por defecto: 30% + 0pt

Cuánto se sube el encabezado hacia el margen superior. Las proporciones son relativas a la altura del margen superior.

El pie de página. Llena el margen inferior de cada página.

Para un simple número de página, normalmente alcanza con la propiedad numbering. Si querés crear un pie de página personalizado pero seguir mostrando el número de página, podés acceder directamente al contador de páginas.

ExpandirVer ejemplo
#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)

Cuánto se baja el pie de página hacia el margen inferior. Las proporciones son relativas a la altura del margen inferior.

background
none o content
Configurable con set
Signo de pregunta
Por defecto: none

Contenido en el fondo de la página.

Este contenido se colocará detrás del cuerpo de la página. Se puede usar para colocar una imagen de fondo o una marca de agua.

Por comodidad, las longitudes relativas se resuelven respecto del tamaño de la página incluido el bleed de la página cuando se usan en el contenido de fondo. Por ejemplo, en una página de 100mm de ancho con un sangrado de 5mm, un ancho de 100% se calcula como 5mm + 100mm + 5mm.

ExpandirVer ejemplo
#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 o content
Configurable con set
Signo de pregunta
Por defecto: none

Contenido en el primer plano de la página.

Este contenido se superpondrá al cuerpo de la página.

Las longitudes relativas se resuelven respecto del tamaño de la página incluido el bleed, con el mismo comportamiento que background.

ExpandirVer ejemplo
#set page(foreground: text(24pt)[🤓])

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

body
content
ObligatorioPosicional
Signo de pregunta

El contenido de la(s) página(s).

Se crearán varias páginas si el contenido no entra en una sola. Después de componer el cuerpo, se creará una página nueva con las propiedades de página anteriores a la invocación de la función.