• 
• 
• Referencia
• 
• Modelo
• 
• Lista numerada

enumElemento

Las funciones de elemento pueden personalizarse con reglas set y show.

Desde: siempre

Una lista numerada.

Muestra verticalmente una secuencia de elementos y los numera consecutivamente.

Ejemplo

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]

Podés cambiar fácilmente todas tus enumeraciones a otro estilo de numeración con una regla set.

#set enum(numbering: "a)")

+ Starting off ...
+ Don't forget step two

También podés usar enum.item para personalizar programáticamente el número de cada elemento de la enumeración:

#enum(
  enum.item(1)[First step],
  enum.item(5)[Fifth step],
  enum.item(10)[Tenth step]
)

Sintaxis

Esta función también tiene una sintaxis dedicada:

• Empezar una línea con un signo más crea un elemento de enumeración numerado automáticamente.
• Empezar una línea con un número seguido de un punto crea un elemento de enumeración numerado explícitamente.

Los elementos de una enumeración pueden contener varios párrafos y otro contenido de bloque. Todo el contenido que tenga más sangría que el marcador de un elemento pasa a formar parte de ese elemento.

Parámetros

tight

bool

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: true

Define el espaciado por defecto de la enumeración. Si es false, los elementos se separan con el espaciado de párrafo. Si es true, en cambio usan el interlineado de párrafo. Esto hace que la lista sea más compacta, lo que puede verse mejor si los elementos son cortos.

En modo marcado, el valor de este parámetro se determina según si los elementos están separados por una línea en blanco. Si los elementos se siguen directamente, se establece en true; si los elementos están separados por una línea en blanco, se establece en false. La compacidad definida en el marcado no se puede reemplazar con reglas set.

Ver ejemplo

+ 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

str o function

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: "1."

Cómo numerar la enumeración. Acepta un patrón o función de numeración.

Si el patrón de numeración contiene varios símbolos de conteo, se aplican a las enumeraciones anidadas. Si se da una función, la función recibe un argumento si full es false y varios argumentos si full es true.

Ver ejemplo

#set enum(numbering: "1.a)")
+ Different
+ Numbering
  + Nested
  + Items
+ Style

#set enum(numbering: n => super[#n])
+ Superscript
+ Numbering!

start

auto o int

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: auto

Con qué número empieza la enumeración.

Ver ejemplo

#enum(
  start: 3,
  [Skipping],
  [Ahead],
)

full

bool

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: false

Si se muestra la numeración completa, incluidos los números de todas las enumeraciones padre.

Ver ejemplo

#set enum(numbering: "1.a)", full: true)
+ Cook
  + Heat water
  + Add ingredients
+ Eat

reversed

bool

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: false

Si se invierte la numeración de esta enumeración.

Ver ejemplo

#set enum(reversed: true)
+ Coffee
+ Tea
+ Milk

indent

length

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: 0pt

La sangría de cada elemento.

body-indent

length

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: 0.5em

El espacio entre la numeración y el cuerpo de cada elemento.

spacing

auto o length

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: auto

El espaciado entre los elementos de la enumeración.

Si se establece en auto, usa el leading del párrafo para las enumeraciones compactas y el spacing del párrafo para las enumeraciones amplias (no compactas).

number-align

alignment

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: end

La alineación que deben tener los números de la enumeración.

Por defecto se establece en end, lo que alinea los números de la enumeración horizontalmente hacia el final de la dirección de texto actual (en una escritura de izquierda a derecha, por ejemplo, equivale a right). Además, la ausencia de una alineación vertical ubica cada número verticalmente justo encima de la línea base del elemento, como si fuera parte de su primera línea de texto.

La elección de end para la alineación horizontal de los números de la enumeración suele preferirse a start, ya que así los números crecen alejándose del texto en lugar de hacia él. Sin embargo, esta opción te permite reemplazar ese comportamiento.

En cuanto a la alineación vertical, se puede reemplazar si no se desea la alineación con la línea base. Por ejemplo, una alineación de end + top siempre ubicaría el marcador verticalmente cerca de la parte superior del elemento, mientras que end +
bottom lo movería cerca de la parte inferior.

También hay que notar que la lista sin orden tiene una opción similar, llamada en cambio marker-align, que también controla ambos ejes de la alineación del marcador exactamente de la misma manera que los números de enum.

Ver ejemplo

#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

content

ObligatorioPosicional

Los parámetros posicionales se especifican en orden, sin nombres.

Variádico

Los parámetros variádicos pueden especificarse varias veces.

Los elementos de la lista numerada.

Al usar la sintaxis de enum, los elementos adyacentes se reúnen automáticamente en enumeraciones, incluso a través de construcciones como los bucles for.

Ver ejemplo

#for phase in (
   "Launch",
   "Orbit",
   "Descent",
) [+ #phase]

Funciones

Las funciones y los tipos pueden definir funciones. Se accede a estos miembros indicando la función o el tipo, seguido de un punto y, luego, el nombre de la función.

itemElemento

Las funciones de elemento pueden personalizarse con reglas set y show.

Desde: 0.4.0

Un elemento de enumeración.

number

auto o int

Posicional

Los parámetros posicionales se especifican en orden, sin nombres.

Configurable con set

Los parámetros configurables pueden personalizarse para todos los usos posteriores de la función mediante una regla set.

Por defecto: auto

El número del elemento.

body

content

ObligatorioPosicional

Los parámetros posicionales se especifican en orden, sin nombres.

El cuerpo del elemento.

EnlacePágina anterior

NumeraciónPágina siguiente